轨迹纠偏API

所有文档

服务概览

快速开始

使用准备

接口文档

服务功能

轨迹纠偏API

相关资料

更新日志常见问题资源下载使用指南

服务功能

下载开发文档

前往示例中心在线体验

接口说明

轨迹纠偏服务（又名Trackrectify API）是一类Web API接口服务，用于纠正一段或多段轨迹的漂移，通过去除噪点、绑路、补充道路形状点、抽稀等方式，还原真实轨迹。

使用说明

用于对一段连续长轨迹进行纠偏绑路、计算里程、返回道路等级和道路限速信息，如：对一辆车一个行程或一天的轨迹进行纠偏并计算里程。

API服务地址

https://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：轨迹点的速度，double类型，单位：公里/小时 direction：轨迹点的方向，int类型，单位：范围为[0,359]，0度为正北方向，顺时针方向递增 height：轨迹点的高度，double类型，单位：米 radius：定位时返回的定位精度，double类型，单位：米
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坐标系
sn	用户的权限签名	string	否	若用户所用ak的校验方式为sn校验时该参数必须。 sn校验说明

返回参数

参数名		含义	类型	备注
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
	coord_type	坐标类型	string	该字段仅在海外区域时返回，返回值为：wgs84。当坐标位于国内（含港、澳、台）时，返回坐标类型与请求参数 coord_type_output 所设一致，因此不再返回该字段

请求示例

POST BODY中请求参数填写示例


ak:<您的ak>
point_list: [{"loc_time":1624295452,"latitude":36.2715924153,"longitude":120.401133898,"coord_type_input":"bd09ll"},{"loc_time":1624295615,"latitude":36.2710674153,"longitude":120.401122046,"coord_type_input":"bd09ll"},{"loc_time":1624295715,"latitude":36.2710674153,"longitude":120.401122046,"coord_type_input":"bd09ll"},{"loc_time":1624295815,"latitude":36.26970681,"longitude":120.406126,"coord_type_input":"bd09ll"},{"loc_time":1624295915,"latitude":36.2626899159,"longitude":120.406257629,"coord_type_input":"bd09ll"},{"loc_time":1624296015,"latitude":36.2554959254,"longitude":120.401709345,"coord_type_input":"bd09ll"},{"loc_time":1624296115,"latitude":36.2482072286,"longitude":120.398668032,"coord_type_input":"bd09ll"},{"loc_time":1624296215,"latitude":36.2453202208,"longitude":120.390573255,"coord_type_input":"bd09ll"},{"loc_time":1624296315,"latitude":36.2462943954,"longitude":120.378697631,"coord_type_input":"bd09ll"},{"loc_time":1624296415,"latitude":36.2464401658,"longitude":120.368128971,"coord_type_input":"bd09ll"},{"loc_time":1624296515,"latitude":36.2411743783,"longitude":120.360663512,"coord_type_input":"bd09ll"}]

rectify_option: need_mapmatch:1|transport_mode:driving|denoise_grade:1|vacuate_grade:1

使用准备

更新日志

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