轨迹纠偏最后更新时间: 2021年01月22日

产品介绍

根据坐标点抓取道路，即根据给定的坐标点、车辆的方位角以及行驶速度，将用户的轨迹纠偏到路上，从而返回用户实际驾车经过的道路坐标。使用API前您需先申请Key，若无高德地图API账号需要先申请账号。

请注意：

用于将行车产生的轨迹坐标点匹配到道路上。

服务调用量的限制请点击这里查阅。

第一步，申请”web服务 API”密钥（Key）

第二步，此服务为POST请求方式，请务必参阅1.1以及1.2之中的要求，并严格按照要求实现

第三步，接收HTTP请求返回的数据（JSON格式），解析数据。如无特殊声明，接口的输入参数和输出数据编码全部统一为UTF-8。

请注意：纠偏效果取决于轨迹中定位点的密集程度，定位点间隔效果最优理论值5~10秒，也就是每5秒或者10秒一个定位点构成的轨迹纠偏效果最优。

轨迹纠偏API服务地址：

https://restapi.amap.com/v4/grasproad/driving

1.1通用参数

1.1之中参数需要置于queryString之中

参数名称	含义	规则说明	是否必填	默认值
key	客户唯一标示	用户申请，由高德后台自动分配	是	无

1.2业务参数

1.2之中参数需要置于body体之中

Post数据格式为JsonArray，里面需要包含JsonObject

x、y、ag、tm、sp此为一个JsonObject，每个JsonObject需要保持完整，最多有500个JsonObject

参数名称	含义	规则说明	是否必填	默认值
x	经度	小数点后最多6位	是	无
y	纬度	小数点后最多6位	是	无
ag	角度	与正北方向的夹角,小数、整数均可需要注意的是，计算时需要参考到设备的角度来判别方向，如果ag参数是0，或者是不合法的参数，会比较大概率导致纠偏计算失败。	是	无
tm	时间	1970年到当前的秒数第一个点对应的tm参数为unix时间戳；从第二个点的tm参数开始，tm取值为相对于前一个tm的时间增量，起始时间戳和时间增量均不能为0，需要真实合理的时间。	是	无
sp	速度	车辆/设备的移动速度，单位：km/h ,小数、整数均可，在计算纠偏时如果速度值不合理，会比较大概率导致纠偏计算失败。在使用时请传入合理的速度值。	是	无

body之中的样例

[{

	"x": 116.449429,

	"y": 40.014844,

	"sp": 4,

	"ag": 110,

	"tm": 1478831753

}, {

	"x": 116.449639,

	"y": 40.014776,

	"sp": 3,

	"ag": 110,

	"tm": 23

}, {

	"x": 116.449859,

	"y": 40.014716,

	"sp": 3,

	"ag": 111,

	"tm": 33

}, {

	"x": 116.450074,

	"y": 40.014658,

	"sp": 3,

	"ag": 110,

	"tm": 31

}, {

	"x": 116.450273,

	"y": 40.014598,

	"sp": 3,

	"ag": 111,

	"tm": 20

}]

返回字段			含义
data			数据体
	distance		总距离
	points		返回坐标合集
		x	经度
		y	维度
errcode			30001错误表示抓路失败。当传入点数较少或较稀疏时，可能会导致抓路失败。
errdetail
errmsg