轨迹纠偏 最后更新时间: 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服务地址：
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 |
时间 |
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 |
|||