鹰眼轨迹分析类接口提供停留点分析和驾驶行为分析功能:
1. 停留点分析接口:一段轨迹中有多少个停留点、停留在何处、停留了多久
2. 驾驶行为分析:一段轨迹中有多少个超速点、急加/减速点、急转弯点,其中超速点功能支持依据百度地图路网实际道路限速计算,也支持开发者设置固定的限速值
注意: 如使用轨迹分析相关接口,轨迹点上传时请务必同步上传speed(速度)和direction(方向)字段,否则该接口将不进行分析计算。鹰眼sdk在gps定位下会自动采集这些数据。
模块 | 接口名称 | 功能说明 |
---|---|---|
analysis | staypoint | 停留点分析 |
drivingbehavior | 驾驶行为分析 |
目前中国主要有以下三种坐标系:
wgs84:为一种大地坐标系,也是目前广泛使用的gps全球卫星定位系统使用的坐标系
gcj02:是由中国国家测绘局制订的地理信息系统的坐标系统。由wgs84坐标系经加密后的坐标系
bd09:为百度坐标系,在gcj02坐标系基础上再次加密。其中bd09ll表示百度经纬度坐标,bd09mc表示百度墨卡托米制坐标
非中国地区地图,统一使用wgs84坐标
查询entity在指定时间段内的停留点。停留点判断规则为:在stay_radius半径范围内,滞留stay_time以上,被认为是一次停留,将取一个代表性坐标作为停留点,其中 stay_radius 默认为20米,stay_time 默认为 600秒。
https://yingyan.baidu.com/api/v3/analysis/staypoint
//get请求
参数名称 | 字段含义 | 数据类型 | 是否必填 | 备注 |
---|---|---|---|---|
ak | 用户的ak | string | 是 | |
service_id | service的id,service 的唯一标识 | int | 是 | 在轨迹管理台创建鹰眼服务时,系统返回的 service_id |
entity_name | entity唯一标识 | string(0-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) | 否 | 默认值为: |
coord_type_output | 返回的坐标类型 | string | 否 | 默认值:bd09ll |
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}}]}
查询entity在指定时间段内的驾驶行为,返回以下分析结果:
1. 总体信息:起终点信息、里程、耗时、平均速度、最高速度
2. 异常信息:超速、急加速、急刹车、急转弯
https://yingyan.baidu.com/api/v3/analysis/drivingbehavior
//get 请求
参数名称 | 字段含义 | 数据类型 | 是否必填 | 备注 |
---|---|---|---|---|
ak | 用户的ak,授权使用 | string | 是 | |
service_id | service的id,service 的唯一标识 | int | 是 | service 的唯一标识。在轨迹管理台创建鹰眼服务时,系统返回的 service_id |
entity_name | entity唯一标识 | string | 是 | |
start_time | 开始时间 | unix时间戳 | 是 | |
end_time | 结束时间 | unix时间戳 | 是 | 结束时间需大于开始时间,但不可大于超过24小时。为提升响应速度,同时避免轨迹点过多造成请求超时(3s)失败,建议缩短每次请求的时间区间,将一天拆分成多个时间段,对结果进行拼接 |
speeding_threshold | 固定限速值 | double | 否 | 默认值:0 |
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) | 否 | 默认值为: |
coord_type_output | 返回的坐标类型 | string | 否 | 默认值:bd09ll |
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 | |||||
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米"},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}]}
上一篇
下一篇
本篇文章对您是否有帮助?