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

鹰眼轨迹服务

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

简介

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

1. 停留点分析接口:一段轨迹中有多少个停留点、停留在何处、停留了多久
2. 驾驶行为分析:一段轨迹中有多少个超速点、急加/减速点、急转弯点,其中超速点功能支持依据百度地图路网实际道路限速计算,也支持开发者设置固定的限速值


注意:如使用轨迹分析相关接口,轨迹点上传时请务必同步上传speed(速度)和direction(方向)字段,否则该接口将不进行分析计算。鹰眼SDK在GPS定位下会自动采集这些数据。

接口列表
模块 接口名称 功能说明
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半径范围内,滞留stay_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 在轨迹管理台创建鹰眼服务时,系统返回的 service_id
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坐标系

sn 用户的权限签名,若用户所用AK的校验方式为SN校验时该参数必须。
SN计算规则
string


返回参数
参数名 参数含义 类型 备注
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/staypoint?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 在轨迹管理台创建鹰眼服务时,系统返回的 service_id
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/s^2,仅支持正数
harsh_breaking_threshold 急减速的加速度阈值 double 默认值:-1.67,单位:m/s^2,仅支持负数
harsh_steering_threshold 急转弯的向心加速度阈值 double 默认值:5,单位:m/s^2,仅支持正数
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坐标系

sn 用户的权限签名,若用户所用AK的校验方式为SN校验时该参数必须。
SN计算规则
string


返回值
参数名 参数含义 类型 备注
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 超速点 array 一条超速记录中的超速起点或终点
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 急加速记录集合
急加速记录 array
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 急刹车记录集合
急刹车记录 array
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 急转弯记录集合
急转弯记录 array
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=1464105600&end_time=1464191940&speeding_threshold=80

返回示例
{
  status: 0,
  message: "成功",
  distance: 79707.90026776,
  duration: 38441,
  average_speed: 7.4646455858052,
  max_speed: 56.7,
  start_point: {
  longitude: 113.2075,
  latitude: 23.40675,
  coord_type: "bd09ll",
  loc_time: 1464134680,
  address: "新景豪苑内,新凤凰酒店-休闲会所附近9米"
},
end_point: {
  longitude: 113.208055,
  latitude: 23.406561,
  coord_type: "bd09ll",
  loc_time: 1464173121,
  address: "盛业行东南49米"
},
speeding_num: 2,
harsh_acceleration_num: 1,
harsh_breaking_num: 1,
harsh_steering_num: 1,
speeding: [
{
  speeding_distance: 59.189285867195,
  speeding_points: [
  {
    longitude: 113.20710875909,
    latitude: 23.39908060312,
    coord_type: "bd09ll",
    loc_time: 1464138828,
    actual_speed: 87.5,
    limit_speed: 60
  },
  {
    longitude: 113.20697265531,
    latitude: 23.399597906861,
    coord_type: "bd09ll",
    loc_time: 1464138843,
    actual_speed: 108.9,
    limit_speed: 80
  }
 ]
},
{
  speeding_distance: 989.53701539415,
  speeding_points: [
  {
    longitude: 113.21499929275,
    latitude: 23.413317284437,
    coord_type: "bd09ll",
    loc_time: 1464141367,
    actual_speed: 32.4,
    limit_speed: 15
  },
  {
    longitude: 113.21692508544,
    latitude: 23.408488134541,
    coord_type: "bd09ll",
    loc_time: 1464141794,
    actual_speed: 16.2,
    limit_speed: 15
  }
  ]
}
],
harsh_acceleration: [
{
  longitude: 113.21725316042,
  latitude: 23.412958154234,
  coord_type: "bd09ll",
  loc_time: 1464143029,
  acceleration: 2.75,
  initial_speed: 0,
  end_speed: 19.8
}
],
harsh_breaking: [
{
  longitude: 113.2149819651,
  latitude: 23.411143610036,
  coord_type: "bd09ll",
  loc_time: 1464141265,
  acceleration: -2.25,
  initial_speed: 34.2,
  end_speed: 26.1
}
],
harsh_steering: [
{
  longitude: 113.2399844062,
  latitude: 23.415216724914,
  coord_type: "bd09ll",
  loc_time: 1464158589,
  centripetal_acceleration: 5.0324216823668,
  turn_type: "left",
  speed: 36.44
}
]
}