示例中心
功能在线体验
控制台
您现在的位置: 开发 > Web服务 API > 开发指南 > API文档 > 轨迹纠偏 >

高德 开发 Web服务 API 开发指南 API文档 轨迹纠偏

更新时间:2018年08月28日

产品介绍

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

请注意:

  • 针对个人开发者目前每天仅能访问该接口100次,详情请查阅服务调用量配额。
  • 原有“抓路服务”API由轨迹纠偏服务替代,抓路服务开发文档地址

适用场景

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

使用限制

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

使用说明

第一步,申请”web服务 API”密钥(Key)

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

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

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

轨迹纠偏

轨迹纠偏API服务地址:

http://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


errdetail  


errmsg 



 

示例中心 功能
在线体验
常见问题