轨迹分析 - 百度地图 API

简介

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

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

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

接口列表

模块	接口名称	功能说明
analysis	staypoint	停留点分析
drivingbehavior	驾驶行为分析

坐标系说明

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

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米，stay_time 默认为 600秒。

请求URI

https://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 所设一致，因此不再返回该字段

请求示例

https://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

https://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

请求示例

https://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米"