经验行为分析类接口是一类根据历史轨迹数据分析经验行为的服务,目前支持的能力为分析指定终端的经验路线。
模块 | 接口名称 | 功能说明 |
---|---|---|
frequentroute | createjob | 创建一个任务,该任务完成后可通过getjob接口查询计算出的经验路线 |
getjob | 查询任务,将返回计算出的经验路线,可能为多条经验路线 |
目经验路线分析服务(beta版)可用于分析某一终端的常走路线,并给出路线的出行频率。经验路线分析时主要考虑的因素包括:出行时间是否接近、路线(包括方向)是否相似。若两个行程的路线虽高度相似,但出发时间相差大于所设置的时间容忍阈值time_range,则仍将被聚类至2条备选的经验路线中。分析得到的经验路线信息包括:
1. 经验路线起终点坐标
2. 出发时间区间、到达时间区间
3. 路线里程、耗时、平均时速
4. 路线形状点
该凯发k8官方旗舰厅的服务支持通过请求参数的设置对原始轨迹进行纠偏等预处理(包括轨迹去噪、抽稀、纠偏、绑路、中断区间补偿等),使得后续经验路线分析更准确。
关于权限和配额的说明:经验路线分析服务是鹰眼的高级服务,目前处于beta版试运行阶段,开发者可通过 申请开通权限体验试用,默认配额为:并发(5次/秒),日请求量(100次/日)。
该类接口使用方法为: 第一步:使用 createjob接口创建任务 第二步:使用 getjob接口使用与createjob同样的请求参数定期查询任务状态,一旦返回值中message字段值为“ok”时,则返回计算得出的经验路线。
https://yingyan.baidu.com/api/v3/frequentroute/createjob
https://yingyan.baidu.com/api/v3/frequentroute/getjob
//get请求
参数名称 | 字段含义 | 数据类型 | 是否必填 | 备注 |
---|---|---|---|---|
ak | 用户的ak | string | 是 | |
service_id | service的id,service 的唯一标识 | int | 是 | 在轨迹管理台创建鹰眼服务时,系统返回的 service_id |
entity_name | entity唯一标识 | 是 | ||
start_time | 起始时间(起始的loc_time) | unix时间戳 | 是 | |
end_time | 结束时间(结束的loc_time) | unix时间戳 | 是 | 结束时间不超过当前时间,不能早于起始时间,且与起始时间差在24*31小时(即一个月)之内。 |
time_range | 时间容忍度阈值 | int | 是 | 取值范围[1,1440],单位:分钟。 |
is_processed | 是否采用纠偏后轨迹来进行经验路线分析 | int | 否 | 默认值:0 |
process_option | 纠偏选项 | string(0-128) | 否 | 仅在is_processed=1时生效。默认值为: |
supplement_mode | 轨迹补偿交通方式选择 | string(0-128) | 否 | 默认值:no_supplement |
coord_type_output | 返回的坐标类型 | string | 否 | 默认值:bd09ll |
sn | 用户的权限签名,若用户所用ak的校验方式为sn校验时该参数必须。sn计算方法 | string | 否 |
参数名 | 字段含义 | 类型 | 备注 | ||
---|---|---|---|---|---|
status | 状态码 | int | 返回状态,0为成功 | ||
message | 响应信息 | string | 对status的中文描述 | ||
total | 经验路线条数 | int | 代表一共有分析出多少条经验路线, | ||
routes | 经验路线列表 | array | 每条经验路线取一条实际轨迹作为代表。 返回的路线将按出行频率从高至低排序,并剔除了里程过短、轨迹点数过少的经验路线。 | ||
frequency | 路线出行频率 | double | 出行频率为该经验路线的原始行程个数/总行程个数,保留小数点后2位。 | ||
distance | 路线距离 | double | 保留小数点后2位,单位:米 | ||
duration | 路线耗时 | int | 单位:秒 | ||
start_time_range | 出发时间区间 | string | 该经验路线用户出发的最早和最晚时间,格式:hh:mm:ss, hh:mm:ss 示例:"start_time_range":"7:8:51,13:32:52" | ||
end_time_range | 到达时间区间 | string | 该经验路线用户到达的最早和最晚时间,格式:hh:mm:ss, hh:mm:ss 示例:"start_time_range":"7:8:51,13:32:52" | ||
start_point | |||||
longitude | 经度 | double | 保留小数点后6位 | ||
latitude | 纬度 | double | 保留小数点后6位 | ||
end_point | |||||
longitude | 经度 | double | 保留小数点后6位 | ||
latitude | 纬度 | double | 保留小数点后6位 | ||
points | 经验路线轨迹点 | array | |||
longitude | 经度 | double | 保留小数点后6位 | ||
latitude | 纬度 | double | 保留小数点后6位 | ||
loc_time | 定位时的设备时间 | unix时间戳 | 若是原始轨迹点位置纠正后的点,则loc_time为原始轨迹点的定位时间 若是鹰眼通过绑路补充的道路形状点(标识为_supplement=1),则loc_time使用了前序原始轨迹点的定位时间 | ||
direction | 方向 | int | 范围为[0,359],0度为正北方向,顺时针 | ||
height | 高度 | double | 只在gps定位结果时才返回,单位米 | ||
speed | 速度 | double | 单位:千米/小时 |
https://yingyan.baidu.com/api/v3/frequentroute/createjob?process_option=need_denoise=1,need_vacuate=1,need_mapmatch=1,radius_threshold=100,transport_mode=driving&supplement_mode=driving&coord_type_output=bd09ll&page_size=5000&page_index=1&entity_name=<你的entity_name>&is_processed=1&service_id=<你的service_id>&ak=<你的ak>&start_time=1585670400&end_time=1588176000&time_range=240
https://yingyan.baidu.com/api/v3/frequentroute/getjob?process_option=need_denoise=1,need_vacuate=1,need_mapmatch=1,radius_threshold=100,transport_mode=driving&supplement_mode=driving&coord_type_output=bd09ll&page_size=5000&page_index=1&entity_name=<你的entity_name>&is_processed=1&service_id=<你的service_id>&ak=<你的ak>&start_time=1585670400&end_time=1588176000&time_range=240
{"status":0,"message":"ok","data":{"total":2,"routes":[{"points":[{"longitude":113.815534,"latitude":22.729928,"loc_time":1585699998,"direction":247,"speed":1.73},{"longitude":113.815469,"latitude":22.729904,"loc_time":1585700013,"direction":67,"height":28.0,"speed":6.84},…{"longitude":113.913771,"latitude":22.794525,"loc_time":1585701885,"direction":123,"height":1.0,"speed":5.63},{"longitude":113.91447,"latitude":22.794097,"loc_time":1585701940,"direction":123,"height":2.0,"speed":5.63}],"distance":18082.59,"average_speed":50.89,"frequency":0.25,"duration":1942,"start_time_range":"7:8:51,13:32:52","end_time_range":"7:37:14,14:15:50","start_point":{"longitude":113.815534,"latitude":22.729928},"end_point":{"longitude":113.91447,"latitude":22.794097}},{"points":[{"longitude":113.914526,"latitude":22.794701,"loc_time":1585736279,"direction":308,"speed":5.44},{"longitude":113.914178,"latitude":22.794957,"loc_time":1585736299,"direction":220,"height":9.0,"speed":16.55},…{"longitude":113.815974,"latitude":22.730096,"loc_time":1585738602,"direction":247,"height":12.0,"speed":2.97},{"longitude":113.815601,"latitude":22.729954,"loc_time":1585738683,"direction":247,"speed":2.97}],"distance":20430.13,"average_speed":49.84,"frequency":0.23,"duration":2404,"start_time_range":"17:50:22,19:9:12","end_time_range":"18:40:21,19:41:33","start_point":{"longitude":113.914526,"latitude":22.794701},"end_point":{"longitude":113.815601,"latitude":22.729954}}]}}
上一篇
下一篇
本篇文章对您是否有帮助?