浏览器版本低!无法浏览完整内容,建议升级或更换浏览器。

鹰眼轨迹服务

百度鹰眼是一套轨迹追踪开放服务,开发者在终端集成鹰眼API/SDK 后,可同时管理并追踪数千万终端设备的轨迹,适用于车队管理、共享出行、外勤人员管理、智能穿戴等领域。

简介

鹰眼轨迹分析类接口提供停留点分析和驾驶行为分析功能:

1. 停留点分析接口:一段轨迹中有多少个停留点、停留在何处、停留了多久

2. 驾驶行为分析:一段轨迹中有多少个超速点、急加/减速点、急转弯点,其中超速点功能支持依据百度地图路网实际道路限速计算,也支持开发者设置固定的限速值
接口列表
模块 接口名称 功能说明
analysis staypoint 停留点分析
drivingbehaviour 驾驶行为分析
坐标系说明

目前中国主要有以下三种坐标系:

WGS84:为一种大地坐标系,也是目前广泛使用的GPS全球卫星定位系统使用的坐标系。

GCJ02:是由中国国家测绘局制订的地理信息系统的坐标系统。由WGS84坐标系经加密后的坐标系。

BD09:为百度坐标系,在GCJ02坐标系基础上再次加密。其中bd09ll表示百度经纬度坐标,bd09mc表示百度墨卡托米制坐标

非中国地区地图,统一使用WGS84坐标

鹰眼 Web服务API v3.0的默认输入输出参数为百度坐标(BD09),同时可通过"coord_type","coord_type_input","coord_type_output"(以各服务参数介绍为准)控制输入输出的坐标类型,鹰眼将自动完成转换。
接口说明
staypoint——停留点查询
查询entity在指定时间段内的停留点。停留点判断规则为:在stay_radius半径范围内,滞留start_time以上,被认为是一次停留,将取一个代表性坐标作为停留点,其中 stay_radius 默认为20米,start_time 默认为 600秒。
请求URI
http://yingyan.baidu.com/api/v3/analysis/staypoint  //GET 请求
请求参数
参数名 参数含义 类型 是否必填 备注
ak 用户的ak,授权使用 string
service_id service的ID,作为其唯一标识 Int
entity_name entity名称,作为其唯一标识。 string(128)
start_time 开始时间 UNIX时间戳
end_time 结束时间 UNIX时间戳
stay_time 停留时间 int 单位:秒,默认值:600。该字段用于设置停留点判断规则,即若系统判断在半径为stay_radius的圆形范围内停留时间超过stay_time,则被认为是一次停留
stay_radius 停留半径 int 单位:米,取值范围:[1,500],默认值:20。该字段用于设置停留点判断规则,即若系统判断在半径为stay_radius的圆形范围内停留时间超过stay_time,则被认为是一次停留
process_option 纠偏选项,用于控制返回坐标的纠偏处理方式 string(0-128) 默认值为:
need_mapmatch=0,transport_mode=driving

取值规则为:

1.绑路,示例:

need_mapmatch=0:不绑路

need_mapmatch=1:绑路

2.交通方式,鹰眼将根据不同交通工具选择不同的纠偏策略,目前支持驾车、骑行和步行,示例:

transport_mode=driving transport_mode=riding transport_mode=walking

coord_type_output 返回的坐标类型 string 默认值:bd09ll

该字段用于控制返回结果中的坐标类型。可选值为:

gcj02:国测局加密坐标

bd09ll:百度经纬度坐标

该参数仅对国内(包含港、澳、台)轨迹有效,海外区域轨迹均返回 wgs84坐标系


返回参数
参数名 参数含义 类型 备注
status 状态码 int 返回状态,0为成功
message 响应信息 string 对status的中文描述
staypoint_num 停留次数 int 本段行程中停留次数
stay_points 停留记录列表 array 数组中每个元素代表一次停留,记录一个停留点坐标
start_time 停留开始时间 UNIX时间戳
end_time 停留结束时间 UNIX时间戳
duration 停留时长 int 单位:秒
stay_point 停留点 dict
longitude 经度 double
latitude 纬度 double
coord_type 坐标类型 string 该字段仅在海外区域时返回,返回值为:wgs84。当坐标位于国内(含港、澳、台)时,返回坐标类型与请求参数 coord_type_output 所设一致,因此不再返回该字段


请求示例
http://yingyan.baidu.com/api/v3/analysis/drivingbehavior?ak=用户的ak&service_id=用户的service_id&entity_name=car_plate&start_time=1467734400&end_time=1467817200&stay_time=300

返回示例
 
  {
    status: 0,
    message: "成功",
    staypoint_num: 3,
    stay_points: [
   {
    start_time: 1464164829,
    end_time: 1464166832,
    duration: 2003,
    stay_point: {
        longitude: 113.22167932597,
        latitude: 23.411219209009,
        coord_type: 3
     }
   },
   {
    start_time: 1464170138,
    end_time: 1464171664,
    duration: 1526,
    stay_point: {
        longitude: 113.20923398543,
        latitude: 23.411707425027,
        coord_type: 3
    }
   },
   {
    start_time: 1464172067,
    end_time: 1464172952,
    duration: 885,
    stay_point: {
        longitude: 113.207836,
        latitude: 23.40664,
        coord_type: 3
     }
   }
  ]
 }

drivingbehavior——驾驶行为分析

查询entity在指定时间段内的驾驶行为,返回以下分析结果:

1. 总体信息:起终点信息、里程、耗时、平均速度、最高速度

2. 异常信息:超速、急加速、急刹车、急转弯


请求URI
http://yingyan.baidu.com/api/v3/analysis/drivingbehavior //GET请求

请求参数
参数名 参数含义 类型 是否必填 备注
ak 用户的ak,授权使用 string
service_id service的ID,作为其唯一标识 Int
entity_name entity名称,作为其唯一标识。 string(128)
start_time 开始时间 UNIX时间戳
end_time 结束时间 UNIX时间戳 结束时间需大于开始时间,但不可大于超过24小时。为提升响应速度,同时避免轨迹点过多造成请求超时(3s)失败,建议缩短每次请求的时间区间,将一天拆分成多个时间段,对结果进行拼接
speeding_threshold 固定限速值 double 默认值:0

取值规则:

0:根据百度地图道路限速数据计算超速点 其他数值:以设置的数值为阈值,轨迹点速度超过该值则认为是超速;

示例: speeding_threshold=0,以道路限速数据计算 speeding_threshold=80,限速值为80km/h

harsh_acceleration_threshold 急加速的加速度阈值 double 默认值:1.67,单位:m^2/s,仅支持正数
harsh_breaking_threshold 急减速的加速度阈值 double 默认值:-1.67,单位:m^2/s,仅支持负数
harsh_steering_threshold 急转弯的向心加速度阈值 double 默认值:5,单位:m^2/s,仅支持正数
process_option 纠偏选项,用于控制返回坐标的纠偏处理方式,不填则按默认纠偏方式处理 string(0-128) 默认值为:
need_mapmatch=0,transport_mode=driving

取值规则为:

1.绑路,示例:

need_mapmatch=0:不绑路

need_mapmatch=1:绑路

2.交通方式,鹰眼将根据不同交通工具选择不同的纠偏策略,目前支持驾车、骑行和步行,示例:

transport_mode=driving transport_mode=riding transport_mode=walking

coord_type_output 返回的坐标类型 string 默认值:bd09ll

该字段用于控制返回结果中的坐标类型。可选值为:

gcj02:国测局加密坐标

bd09ll:百度经纬度坐标

该参数仅对国内(包含港、澳、台)轨迹有效,海外区域轨迹均返回 wgs84坐标系



返回值
参数名 参数含义 类型 备注
status 状态码 int 返回状态,0为成功
message 响应信息 string 对status的中文描述
distance 行程里程 double 单位:米
duration 行程耗时 int 单位:秒
average_speed 平均时速 double 单位:km/h
max_speed 最高时速 double 单位:km/h
speeding_num 超速次数 int
harsh_acceleration_num 急加速次数 int
harsh_breaking_num 急刹车次数 int
harsh_steering_num 急转弯次数 int
start_point 起点信息
longitude 经度 double
latitude 纬度 double
coord_type 坐标类型 string 该字段仅在海外区域时返回,返回值为:wgs84。当坐标位于国内(含港、澳、台)时,返回坐标类型与请求参数 coord_type_output 所设一致,因此不再返回该字段
loc_time 定位时间 UNIX时间戳
address 起点地址
end_point 终点信息
longitude 经度 double
latitude 纬度 double
coord_type 坐标类型 string 该字段仅在海外区域时返回,返回值为:wgs84。当坐标位于国内(含港、澳、台)时,返回坐标类型与请求参数 coord_type_output 所设一致,因此不再返回该字段
loc_time 定位时间 UNIX时间戳
address 终点地址
speeding 超速记录集合 array 超速记录集合是一个数组,数组中的每一项代表一次超速记录
超速记录 array 超速记录本身是一个数组,数组中包括此次超速的起点和终点两个轨迹点。
speeding_distance 超速里程 double 单位:米。本次超速的里程
speeding_points 超速点 dict 一条超速记录中的超速起点或终点
longitude 经度 double
latitude 纬度 double
coord_type 坐标类型 string 该字段仅在海外区域时返回,返回值为:wgs84。当坐标位于国内(含港、澳、台)时,返回坐标类型与请求参数 coord_type_output 所设一致,因此不再返回该字段
loc_time 定位时间 UNIX时间戳
actual_speed 实际行驶时速 double 单位:km/h
limit_speed 所在道路限定最高时速 double 单位:km/h
harsh_acceleration 急加速记录集合
急加速记录 dict
longitude 经度 double
latitude 纬度 double
coord_type 坐标类型 string 该字段仅在海外区域时返回,返回值为:wgs84。当坐标位于国内(含港、澳、台)时,返回坐标类型与请求参数 coord_type_output 所设一致,因此不再返回该字段
loc_time 定位时间 UNIX时间戳
acceleration 实际加速度 double 单位:m/s^2
initial_speed 加速前时速 double 单位:km/h
end_speed 加速后时速 double 单位:km/h
harsh_breaking 急刹车记录集合
急刹车记录 dict
longitude 经度 double
latitude 纬度 double
coord_type 坐标类型 string 该字段仅在海外区域时返回,返回值为:wgs84。当坐标位于国内(含港、澳、台)时,返回坐标类型与请求参数 coord_type_output 所设一致,因此不再返回该字段
loc_time 定位时间 UNIX时间戳
acceleration 实际加速度 double 单位:m/s^2
initial_speed 刹车前时速 double 单位:km/h
end_speed 刹车后时速 double 单位:km/h
harsh_steering 急转弯记录集合
急转弯记录 dict
longitude 经度 double
latitude 纬度 double
coord_type 坐标类型 string 该字段仅在海外区域时返回,返回值为:wgs84。当坐标位于国内(含港、澳、台)时,返回坐标类型与请求参数 coord_type_output 所设一致,因此不再返回该字段
loc_time 定位时间 UNIX时间戳
centripetal_acceleration 向心加速度 double 单位:m/s^2
turn_type 转向类型 string 取值范围:unknow(方向未知),left(左转),right(右转)
speed 转向时速 double 单位:km/h


请求示例
http://yingyan.baidu.com/api/v3/analysis/drivingbehavior?ak=用户的ak&service_id=用户的service_id&entity_name=car_plate&start_time=1467734400&end_time=1467817200&speeding_threshold=80

返回示例
{

 status: 0,
 message: "成功",
 distance: 61744.609006319,
 duration: 23568,
 average_speed: 9.4314575875233,
 max_speed: 54.9,
 start_point: {
    longitude: 113.24471412903,
    latitude: 23.405204706192,
    coord_type: 3,
    loc_time: 1464149553,
    address: "马鞍山公园(地铁站)附近25米"
 },
 end_point: {
    longitude: 113.20774073303,
    latitude: 23.406671233485,
    coord_type: 3,
    loc_time: 1464173121,
    address: "新凤凰酒店东112米"
 },
 speeding_num: 2,
 harsh_acceleration_num: 1,
 harsh_breaking_num: 1,
 harsh_steering_num: 3,
 speeding: [
 [
  {
     longitude: 113.24100205065,
     latitude: 23.412706344614,
     coord_type: 3,
     loc_time: 1464149867,
     actual_speed: 21.6,
     limit_speed: 15
  },
  {
     longitude: 113.24198745703,
     latitude: 23.412683720093,
     coord_type: 3,
     loc_time: 1464150340,
     actual_speed: 18.9,
     limit_speed: 15
  }
 ],
 [
  {
     longitude: 113.2379268869,
     latitude: 23.419198232806,
     coord_type: 3,
     loc_time: 1464150995,
     actual_speed: 15.3,
     limit_speed: 15
  },
  {
     longitude: 113.23551855949,
     latitude: 23.420734738893,
     coord_type: 3,
     loc_time: 1464151486,
     actual_speed: 16.2,
     limit_speed: 15
  }
 ],
 ],
 harsh_acceleration: [
  {
     longitude: 113.23505718408,
     latitude: 23.415670302452,
     coord_type: 3,
     loc_time: 1464151621,
     acceleration: 3.9347222222222,
     initial_speed: 5.4,
     end_speed: 33.73
  }
 ],
 harsh_breaking: [
  {
     longitude: 113.21355843102,
     latitude: 23.410533082252,
     coord_type: 3,
     loc_time: 1464167499,
     acceleration: -3.75,
     initial_speed: 13.5,
     end_speed: 0
  }
 ],
 harsh_steering: [
  {
     longitude: 113.23536366944,
     latitude: 23.415997495116,
     coord_type: 3,
     loc_time: 1464158361,
     centripetal_acceleration: 42.081624991152,
     turn_type: "left",
     speed: 19.8
  },
  {
     longitude: 113.24036159664,
     latitude: 23.415169028634,
     coord_type: 3,
     loc_time: 1464158512,
     centripetal_acceleration: 19.256219588206,
     turn_type: "left",
     speed: 19.8
  },
  {
     longitude: 113.22883765361,
     latitude: 23.409799328344,
     coord_type: 3,
     loc_time: 1464159414,
     centripetal_acceleration: 5.2597602426213,
     turn_type: "left",
     speed: 25.2
  }
 ]
 }