普货车运输行程服务

4.1.2. 普货车运输行程服务

4.1.2.1. 服务使用场景

在物流运输完成后，往往缺乏有效的手段来追溯运单的真实性和途经区域的情况，这增加了企业后期分析和复盘的难度。

而通过运输行程服务，企业可以详细了解货物在运输过程中的途经城市、停车点以及运输线路，从而实现全程追溯。此外，在费用结算时，该服务还能帮助校验业务的真实性，确保结算的准确性和透明性。

4.1.2.2. 产品功能说明

基于实时计算引擎分析运输全程停车点、途径城市信息，支撑调度人员管理。可追溯近6个月行程，单次最长可追溯72小时行程。能够精确反馈停车及途径城市的情况。

输入车牌号、车牌颜色、车辆出发时间和到达时间、始发地，目的地、始发地坐标、目的地坐标、停车时长。返回行程节点坐标、途径城市情况、中途停留点情况。

4.1.2.3. 业务规则

时间段：最长时间差是72小时（注：72小时规则：包含起止日期在内，日期部分不能超过3天，e.g; 开始日期时间为2024-12-18 02:20:50，则截止日期时间最大为：2024-12-20 23:59:59），最长历史时间是6个月以内。

支持蓝色车牌，黄色车牌和黄绿色车牌。

停车时长若是不填写，默认10分钟，若填写则最小10分钟。

4.1.2.4. API对接说明

接口基本信息

接口名称：普货车运输行程服务

请求方式：POST

接口地址：/api/jjzy/trackServerV3

接口方法：TRANSPORTATION_ITINERARY_SERVICE

输入参数列表

请求参数	必须参数	参数类型	示例数据	说明
vclN	是	String	陕YH0009	车牌号
vco	是	String	2	车牌颜色(见文档最后【车牌颜色】代码集)
qryBtm	是	String	2024-10-08 19:00:00	开始时间，近6个月自然月
qryEtm	是	String	2024-10-08 21:00:00	结束时间，与开始时间相差72小时之内
startLonlat	否*	String	116.31795,30.4252	始发地坐标(WGS84坐标系)
endLonlat	否*	String	110.9946817,25.9089816	目的地坐标(WGS84坐标系)
startAreaCode	否*	String	431102	始发地行政区划编码（暂未启用）
endAreaCode	否*	String	450324	目的地行政区划编码（暂未启用）
parkMins	否	Integer	10	停车时长（分钟）：不填默认10min,(若输入，则最小值为5min，最大值为10000min)
backLonLatType	否	String	WGS84	返回经纬度坐标系:WGS84(国际通用)、GCJ02(高德、QQ地图)、BD09(百度地图)；默认WGS84，格式:1/600000

*注：始发地坐标和目的地坐标为一组，始发地行政区划编码和目的地行政区划编码为一组，都输入的时候以始发地坐标、目的地坐标为准。

输出参数列表

响应参数	必须参数	参数类型	示例数据	说明
code	是	Int	200	状态码
message	是	String	请求成功	返回提示消息
data	是	Object	-	获取成功不为空

data字段包含

参数	必须参数	参数类型	示例数据	说明
mileage	是	String	100.9	路程总里程，单位：千米
parkSize	是	Int	3	停车次数
parkArray	-	Array	-	停车列表
trackArray	-	Array	-	轨迹列表
cityArray	-	Array	-	途经城市列表：以下信息若始发地、目的地或始发地行政区划、目的地行政区划未传入，则不显示

parkArray（停车列表）字段说明

响应参数	必须参数	参数类型	示例数据	说明
parkAdr	是	String	重庆市渝北区铁家湾,东北方向,229.0米	停车地址
parkBte	是	String	1628477210000	停车开始时间,时间戳，单位：毫秒
parkEte	是	String	1628485611000	停车结束时间,时间戳，单位：毫秒
parkLat	是	String	17855836	纬度：格式：1/600000（类型根据入参的backLonLatType决定）
parkLon	是	String	64007815	经度：格式：1/600000（类型根据入参的backLonLatType决定）
parkMins	是	Int	30	停车时长，单位：分钟

trackArray（轨迹列表）字段说明

响应参数	必须参数	参数类型	示例数据	说明
mlg	否	String	123.0	上报里程，单位：千米
agl	是	Int	270	车辆最后定位时的车头方向（0度为正北方向，顺时针方向递增）
gtm	是	String	20210809/104650	GPS时间
hgt	否	String	326	海拔，单位：米
lat	是	String	17855836	纬度，格式：1/600000.0（类型根据入参的backLonLatType决定）
lon	是	String	64007815	经度，格式：1/600000.0（类型根据入参的backLonLatType决定）
spd	否	String	54	GPS速度,单位：千米/小时

cityArray（途经城市列表）字段说明

响应参数	必须参数	参数类型	示例数据	说明
cityName	否	String	郑州市	城市名
cityCode	否	String	500106	城市编码
vInOutTime	否	String	1628486013000	进出城市时间：时间戳，单位：毫秒
vInOutType	否	String	1	进出城市类型，1-进 2-出

4.1.2. 普货车运输行程服务#

4.1.2.1. 服务使用场景#

4.1.2.2. 产品功能说明#

4.1.2.3. 业务规则#

4.1.2.4. API对接说明#

输入参数列表#

输出参数列表#

data字段包含#

parkArray（停车列表）字段说明#

trackArray（轨迹列表）字段说明#

cityArray（途经城市列表）字段说明#