产品简介
直接上传轨迹计算服务,属于高德地图物流轨迹系列产品中的其中一个,本服务可独立使用,可以不与其他的服务一起使用。
本服务针对一段轨迹,实现的能力是:
首先进行纠偏抓路,排除噪点,补充道路,使轨迹连续;
其次对轨迹进行还原,得到轨迹行驶的完整路线,通过路线计算出整体的时间、里程、通行费用;
对轨迹进行了分段,每段分别计算了时间、里程、道路等级、限速信息等内容;
针对每段轨迹,进行了轨迹超速信息的判断和停留信息的判断;
最后返回纠偏后的轨迹点。
服务地址
URL | https://tsapi.amap.com/v1/logistics/track/upload?key=*********** (请把key放在url参数中) |
请求方式 | POST |
特别注意:该接口是物流API服务收费接口,您如果申请试用或者正式应用都请通过工单系统提交商务合作类工单进行沟通。
请求参数
参数名 | 类型 | 是否必填 | 说明 |
key | string | 是 | 应用标识,请在开发者后台进行申请 |
axis | int | 否 | 车辆轴数(默认2轴,可支持2、3、4、5、6轴)轴数与费用计算有关 |
tollInfo | int | 否 | 是否返回费用信息,0(不返回),1(返回),默认为0 |
points | array | 是 | 原始轨迹信息,最多上传5000个 |
| location | string | 是 | 定位点,格式 lon,lat; |
| locatetime | string | 否 | 定位时间,unix时间戳格式,精确到毫秒; 建议填写,可提升纠偏效果; 如果填写则必须保证各定位点的时间戳递增 |
| speed | double | 否 | 轨迹点的速度,速度有助于提升抓路准确性,有数据时建议上传。 |
| direction | double | 否 | 轨迹点的方向,有助于提升抓路准确性,有数据时建议上传。 |
| accuracy | double | 否 | 轨迹点的定位精度,有助于提升抓路准确性,有数据时建议上传。 |
stayTime | int | 否 | 最短停留时间,即停留时间小于此值不判断为停留点,单位秒,取值范围:大于等于60 |
stayDistance | int | 否 | 最长停留距离,即停留距离大于此值不判断为停留,单位m,取值范围:[1,1000] |
lightInfo | int | 否 | 是否返回轨迹中经过的红绿灯信息,0(不返回),1(返回),默认为0 |
返回参数
参数名 | 类型 | 说明 |
errcode | string | 错误码,参照errCode表 |
errmsg | string | 错误描述,参照errCode表 |
errdetail | string | 错误详情 |
data | json | 返回轨迹数据 |
| duration | long | 整个轨迹的累计时长 |
| distance | long | 整个轨迹的累计里程 |
| toll | long | 整个轨迹的总费用 |
| startTime | long | 整个轨迹的开始时间戳,unix时间戳,毫秒 |
| endTime | long | 整个轨迹的结束时间戳,unix时间戳,毫秒 |
| tracks | array | 轨迹数组,如果轨迹被判断中断,且按照行驶速度不可进行补路时,会返回多段,且两段之间路程不被计算入订单里程 |
|
| duration | long | 该段轨迹的时长 |
|
| distance | long | 该段轨迹的里程 |
|
| startTime | long | 该段轨迹的开始时间戳,unix时间戳,毫秒 |
|
| endTime | long | 该段轨迹的结束时间戳,unix时间戳,毫秒 |
|
| roadclass | int | 该段轨迹的道路等级,41000(高速公路),42000(国道),43000(城市快速路),其他内容暂不透出。 |
|
| formWay | int | 该段轨迹的道路的formway值,目前返回的参数包括(3、6、8、53、56、58)都代表的是匝道道路。其他类型暂不透出。 |
|
| speedLimit | double | 该路段的路段限速值,单位km/h |
|
| speedOverLimit | boolean | 相比于当前道路限速值,判断是否超速 |
|
| stayInfo | array | 所有停留信息,可能有多个或为空 |
|
|
| startTime | long | 该段停留的开始时间戳,unix时间戳,毫秒 |
|
|
| endTime | long | 该段停留的开始时间戳,unix时间戳,毫秒 |
|
|
| stayTime | long | 停留总时长,毫秒 |
|
|
| center | string | 停留位置的中心点,格式:x,y |
|
| points | array | 该段轨迹对应的轨迹点 |
|
|
| location | string | 定位坐标,格式:x,y |
|
|
| locatetime | long | 定位时间,unix时间戳,毫秒值 |
|
|
| speed | double | 纠偏后的轨迹速度,单位km/h |