轨迹纠偏 最后更新时间: 2022年04月15日
产品介绍
根据坐标点抓取道路,即根据给定的坐标点、车辆的方位角以及行驶速度,将用户的轨迹纠偏到路上,从而返回用户实际驾车经过的道路坐标。使用API前您需先申请Key,若无高德地图API账号需要先申请账号。
请注意:
- 针对个人认证开发者目前每天仅能访问该接口10000次,对于大批量的访问场景推荐使用猎鹰轨迹服务。
- 原有“抓路服务”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 |