接口功能介绍
轨迹纠偏
URI:http://api.map.baidu.com/rectify/v1/track? //POST请求
请求参数
参数名
参数含义
类型
是否必填
备注
AK
用户的AK,授权使用
string
是
point_list
轨迹点序列
string(1-1M)
是
最多不能超过2000个轨迹点,且轨迹里程不超过500公里(注:若轨迹里程超长,可能会出现响应时间过长或超时)。point_list格式为json, 其中每个point必须包含:latitude,longitude,coord_type_input,loc_time这4个字段,可选speed,direction,height,radius这4个字段,其他字段会被舍弃。
取值规则:
latitude:纬度,支持小数点后6位
longitude:经度,支持小数点后6位
coord_type_input:轨迹点的坐标系,支持以下值:bd09ll(百度经纬度坐标)、gcj02(国测局加密坐标)、wgs84(GPS所采用的坐标系)
loc_time:轨迹点的定位时间,使用UNIX时间戳
speed:轨迹点的速度,单位:公里/小时
direction:轨迹点的方向,单位:范围为[0,359],0度为正北方向,顺时针方向递增
height:轨迹点的高度,单位:米
radius:定位时返回的定位精度,单位:米
rectify_option
纠偏设置
string(0-128)
否
支持以下配置项,多个项之间用”|”竖线相隔。默认值为:need_mapmatch:1|transport_mode:auto|denoise_grade:1|vacuate_grade:1
取值规则为:
1. need_mapmatch(绑路)
是否需要将轨迹点绑路并补充道路形状点 ,示例:
need_mapmatch:0 不绑路
need_mapmatch:1 绑路
2. transport_mode(交通方式)
根据不同交通工具选择不同的纠偏策略和参数,目前支持:自动(即鹰眼自动识别的交通方式)、驾车、骑行和步行。示例:
transport_mode:auto
transport_mode:driving
transport_mode:riding
transport_mode:walking
3. 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定位点)
4. vacuate_grade(抽稀力度)
取值范围[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坐标系
extensions
返回结果控制
string
否
可选,默认:extensions=base
多个值用逗号分隔,目前支持以下值:
base:返回基础信息
road_info:在base的基础上增加返回道路等级(road_grade)、道路限速(car_limit_speed)信息(注:目前road_info仅在开发者申请开通了道路等级和道路限速字段权限后才生效)
示例:extensions=road_info,则返回base信息和road_grade、car_limit_speed
sn
用户的权限签名
string
否
若用户所用ak的校验方式为sn校验时该参数必须。 sn校验说明
point_list 格式参考:[{"loc_time":1526861692,"latitude":22.733438641365,"longitude":114.07100001253,"radius":58.720428,"speed":0,"direction":0,"coord_type_input":"bd09ll"},{"loc_time":1526861702,"latitude":22.733120470113,"longitude":114.07131277927,"direction":0,"height":105,"radius":12,"speed":0,"coord_type_input":"bd09ll"},{"loc_time":1526861708,"latitude":22.73317518682,"longitude":114.07123440645,"direction":0,"height":108,"radius":12,"speed":0,"coord_type_input":"bd09ll"},{"loc_time":1526861713,"latitude":22.733186754672,"longitude":114.07121244322,"direction":0,"height":105,"radius":10,"speed":0,"coord_type_input":"bd09ll"},{"loc_time":1526861718,"latitude":22.733189988356,"longitude":114.07120756194,"direction":0,"height":104,"radius":7,"speed":0,"coord_type_input":"bd09ll"},{"loc_time":1526861723,"latitude":22.733196461607,"longitude":114.07119915457,"direction":0,"height":104,"radius":6,"speed":0,"coord_type_input":"bd09ll"}]
返回参数
参数名
参数含义
类型
备注
status
状态码
int
message
响应信息
string
对status的中文描述
total
忽略掉page_index,page_size后的轨迹点数量
代表一共有多少条符合条件的track
distance
此段轨迹的里程数,单位:米
double
符合条件的所有轨迹点的总里程。
toll_distance
此段轨迹的收费里程数,单位:米
double
收费道路包括高速等收费路段。
points
历史轨迹点列表
longitude
经度
double
latitude
纬度
double
loc_time
定位时的设备时间
UNIX时间戳
该时间为用户上传的时间
direction
方向
int
范围为[0,359],0度为正北方向,顺时针
height
高度
double
只在GPS定位结果时才返回,单位米
speed
速度
double
单位:km/h
radius
定位精度
double
单位:m
road_name
轨迹对应的道路名称
string
仅当请求参数process_option中need_mapmatch=1且绑路成功时,返回该字段。注:该功能为高级付费功能,需通过反馈平台申请使用
road_grade
轨迹对应的道路等级
string
仅当请求参数process_option中need_mapmatch=1时,返回该字段。
可能的返回值:高速路;都市高速路;国道;省道;县道;乡镇道路;其他道路;九级路;轮渡;行人道路
注:该功能为高级付费功能,需通过反馈平台申请使用
car_limit_speed
道路限速
string
单位:km/h
注:该功能为高级付费功能,需通过反馈平台申请使用
coord_type
坐标类型
string
该字段仅在海外区域时返回,返回值为:wgs84。当坐标位于国内(含港、澳、台)时,返回坐标类型与请求参数 coord_type_output 所设一致,因此不再返回该字段
请求示例
返回示例{
"status": 0,
"message": "成功",
"total": 3,
"distance": 32.172129047817,
"toll_distance": 0,
"points": [
{
"loc_time": 1526861692,
"latitude": 22.733547054536,
"longitude": 114.0709706346,
"road_grade": "其它道路",
"car_limit_speed": 15,
"speed": 8.5501914136716,
"direction": 73.687141400957,
"radius": 58.720428
},
{
"loc_time": 1526861702,
"latitude": 22.733607032902,
"longitude": 114.07119283628,
"road_grade": "其它道路",
"car_limit_speed": 15,
"speed": 2.7561591304932,
"direction": 253.68318185279,
"height": 105,
"radius": 12
},
{
"loc_time": 1526861713,
"latitude": 22.733585760413,
"longitude": 114.07111404831,
"road_grade": "其它道路",
"car_limit_speed": 15,
"speed": 2.7561591304932,
"direction": 253.68318185279,
"height": 105,
"radius": 10
}
]
}