开发 Web服务 API 开发指南 基础 API 文档 轨迹纠偏

轨迹纠偏 最后更新时间: 2022年04月15日

产品介绍

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

时间 

tm以秒为单位,第一个采集点的tm值从1970年0点开始,其他采集点为与第一个采集点时间的差值

是 

 无   

sp

速度 

车辆/设备的移动速度,单位:km/h ,小数、整数均可,在计算纠偏时如果速度值不合理,会比较大概率导致纠偏计算失败。在使用时请传入合理的速度值。

是 

 无   

  • 请求示例

body之中的样例

[{"x":116.478928,"y":39.997761,"sp":19,"ag":0,"tm":1478031031},{"x":116.478907,"y":39.998422,"sp":10,"ag":0,"tm":2},{"x":116.479384,"y":39.998546,"sp":10,"ag":110,"tm":3},{"x":116.481053,"y":39.998204,"sp":10,"ag":120,"tm":4},{"x":116.481793,"y":39.997868,"sp":10,"ag":120,"tm":5},{"x":116.482898,"y":39.998217,"sp":10,"ag":30,"tm":6},{"x":116.483789,"y":39.999063,"sp":10,"ag":30,"tm":7},{"x":116.484674,"y":39.999844,"sp":10,"ag":30,"tm":8}]
  • 返回结果参数说明

返回字段

含义

data

数据体


distance

总距离


points

返回坐标合集



x

经度



y

维度

errcode

30001错误表示抓路失败。当传入点数较少或较稀疏时,可能会导致抓路失败。

errdetail  


errmsg 


返回顶部 示例中心 常见问题 智能客服 公众号
二维码