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