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

经验行为分析类接口是一类根据历史轨迹数据分析经验行为的服务,目前支持的能力为分析指定终端的经验路线。

接口列表
模块接口名称功能说明
frequentroutecreatejob创建一个任务,该任务完成后可通过getjob接口查询计算出的经验路线
getjob查询任务,将返回计算出的经验路线,可能为多条经验路线
功能简介

目经验路线分析服务(Beta版)可用于分析某一终端的常走路线,并给出路线的出行频率。经验路线分析时主要考虑的因素包括:出行时间是否接近、路线(包括方向)是否相似。若两个行程的路线虽高度相似,但出发时间相差大于所设置的时间容忍阈值time_range,则仍将被聚类至2条备选的经验路线中。分析得到的经验路线信息包括:

1. 经验路线起终点坐标
2. 出发时间区间、到达时间区间
3. 路线里程、耗时、平均时速
4. 路线形状点

该服务支持通过请求参数的设置对原始轨迹进行纠偏等预处理(包括轨迹去噪、抽稀、纠偏、绑路、中断区间补偿等),使得后续经验路线分析更准确。

关于权限和配额的说明:经验路线分析服务是鹰眼的高级服务,目前处于Beta版试运行阶段,开发者可通过 反馈平台申请开通权限体验试用,默认配额为:并发(5次/秒),日请求量(100次/日)。

使用方法

该类接口使用方法为: 第一步:使用 createjob接口创建任务 第二步:使用 getjob接口使用与createjob同样的请求参数定期查询任务状态,一旦返回值中message字段值为“ok”时,则返回计算得出的经验路线。

经验路线挖掘
请求URL

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],单位:分钟。
出发时间是判断两个原始行程是否会被聚类为一条经验路线的时间纬度特征。若两个原始行程路线一致,但出发时间差值大于该阈值,则将被聚类至2条备选的经验路线中。例如,当time_range=180时,两个路线相同的行程出发时间分别为早晨8点和中午12点,则将被聚类至2条备选经验路线中;若出发时间分别为早晨8点和早晨9点,则将被聚类至1条备选经验路线中。
若开发者不希望用出发时间来区分不同的经验路线,即不论何时出发,只要路线一致都被认为是一条经验路线,则设置time_range=1440,24小时即可。

is_processed

是否采用纠偏后轨迹来进行经验路线分析

int

默认值:0
取值规则:
0:关闭轨迹纠偏,返回原始轨迹
1:打开轨迹纠偏,返回纠偏后轨迹

process_option

纠偏选项

string(0-128)

仅在is_processed=1时生效。默认值为:
denoise_grade=1,need_mapmatch=0,transport_mode=auto,vacuate_grade=1 取值规则为:
1.去噪 denoise_grade(去噪力度)取值范围[0,5],数值越大去噪力度越大,代表越多的点会被当做噪点去除。若取值0,则代表不去噪。
示例:
denoise_grade:0 (不去噪)
denoise_grade:1 (系统默认去噪)
denoise_grade:2(系统默认去噪,同时去除定位精度低于500的轨迹点,相当于保留GPS定位点、大部分Wi-Fi定位点和精度较高的基站定位点)
denoise_grade:3(系统默认去噪,同时去除定位精度低于100的轨迹点,相当于保留GPS定位点和大部分Wi-Fi定位点)
denoise_grade:4(系统默认去噪,同时去除定位精度低于50的轨迹点,相当于保留GPS定位点和精度较高的Wi-Fi定位点)
denoise_grade:5(系统默认去噪,同时去除定位精度低于20的轨迹点,相当于仅保留GPS定位点)
2.绑路,示例:
need_mapmatch=0:不绑路
need_mapmatch=1:绑路
3.交通方式,鹰眼将根据不同交通工具选择不同的纠偏策略和参数,目前支持:自动(即鹰眼自动识别的交通方式)、驾车、骑行和步行,示例:
transport_mode=auto transport_mode=driving transport_mode=riding transport_mode=walking
4.抽稀 取值范围[0,5],数值越大抽稀度力度越大,代表轨迹会越稀疏。若取值0,则代表不抽稀。
示例: vacuate_grade:0(不抽稀) vacuate_grade:2(抽稀力度为2)

supplement_mode

轨迹补偿交通方式选择

string(0-128)

默认值:no_supplement
在轨迹纠偏时,两个轨迹点定位时间间隔5分钟以上,被认为是中断。中断轨迹和里程提供以下5种估算方式。
no_supplement:不补充,中断两点间距离不记入里程。
straight:使用直线补充
driving:使用最短驾车路线规划补充
riding:使用最短骑行路线规划补充
walking:使用最短步行路线规划补充

coord_type_output

返回的坐标类型

string

默认值:bd09ll
该字段用于控制返回结果中的坐标类型。可选值为:
gcj02:国测局加密坐标
bd09ll:百度经纬度坐标
该参数仅对国内(包含港、澳、台)轨迹有效,海外区域轨迹均返回 wgs84坐标系

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
}
}
]
}
}

上一篇

轨迹分析

下一篇

ETC费用

本篇文章对您是否有帮助?