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

轨迹纠偏 最后更新时间: 2024年06月19日

产品介绍

根据坐标点抓取道路,即根据给定的坐标点、车辆的方位角以及行驶速度,将用户的轨迹纠偏到路上,从而返回用户实际驾车经过的道路坐标。

注意

适用场景

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

使用限制

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

使用说明

1
第一步
申请 【Web服务API】密钥(Key)
2
第二步
此服务为POST请求方式,请务必参阅1.1以及1.2之中的要求,并严格按照要求实现
3
第三步
接收HTTP请求返回的数据(JSON格式),解析数据
如无特殊声明,接口的输入参数和输出数据编码全部统一为 UTF-8
成为开发者并创建 Key 

为了正常调用 Web 服务 API ,请先注册成为高德开放平台开发者,并申请 Web 服务的 key ,点击具体操作

注意

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

轨迹纠偏

轨迹纠偏API服务地址

URL

https://restapi.amap.com/v4/grasproad/driving 

请求方式

POST

请求参数

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 

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