开发 物流服务API 开发指南 物流轨迹服务 物流上传坐标轨迹计算

物流上传坐标轨迹计算 最后更新时间: 2023年12月07日

产品简介

直接上传轨迹计算服务,属于高德地图物流轨迹系列产品中的其中一个,本服务可独立使用,可以不与其他的服务一起使用。

本服务针对一段轨迹,实现的能力是:

  • 首先进行纠偏抓路,排除噪点,补充道路,使轨迹连续;
  • 其次对轨迹进行还原,得到轨迹行驶的完整路线,通过路线计算出整体的时间、里程、通行费用;
  • 对轨迹进行了分段,每段分别计算了时间、里程、道路等级、限速信息等内容;
  • 针对每段轨迹,进行了轨迹超速信息的判断和停留信息的判断;
  • 最后返回纠偏后的轨迹点。

服务地址

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

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