普货车运输节点服务
4.1.1. 普货车运输节点服务
4.1.1.1. 服务使用场景
4.1.1.2. 产品功能说明
4.1.1.3. 业务规则
1.
2.
3.
4.
5.
4.1.1.4. API对接说明
/api/jjzy/save/apis/transTimeManageV4备注：接口方法指Http接口通用参数中的method，下同。
输入参数列表
| 请求参数 | 必须参数 | 参数类型 | 示例数据 | 说明 |
|---|---|---|---|---|
| vnos | 是 | String | 陕YH00091,冀YH00082 | 车牌号_车牌颜色，多个车辆以英文逗号分隔（最多100台车，颜色：见文档最后【车牌颜色】代码集） |
| startLonlat | 否* | String | 116.31795,30.4252 | 始发地坐标(WGS84坐标系) |
| endLonlat | 否* | String | 110.9946817,25.9089816 | 目的地坐标(WGS84坐标系) |
| startAreaCode | 否* | String | 431102 | 始发地行政区划编码（区县编码）（暂未启用） |
| endAreaCode | 否* | String | 450324 | 目的地行政区划编码（区县编码）（暂未启用） |
| timeNearby | 否 | Int | 24 | 时间范围，单位:小时，指返回车辆最近时间范围内的最后定位信息（注：单位为小时， 结合需要实际使用情况动态设置） |
| backLonLatType | 否 | String | WGS84 | 返回的经纬度类型: WGS84(国际通用)、GCJ02(高德、腾讯地图)、BD09(百度地图) *默认：GCJ02 |
*注：始发地坐标和目的地坐标为一组，始发地行政区划编码和目的地行政区划编码为一组，都输入的时候以始发地坐标、目的地坐标为准。
输出参数列表
| 响应参数 | 必须参数 | 参数类型 | 示例数据 | 说明 |
|---|---|---|---|---|
| code | 是 | Int | 200 | 状态码 |
| message | 是 | String | 请求成功 | 返回提示消息 |
| data | 否 | Object | - | 获取成功不为空 |
data字段包含
| 参数 | 说明 |
|---|---|
| firstVcl | 首车查询结果：JSON对象（详见下字段说明） |
| others | 其余车辆列表：JSON对象列表（详见下字段说明） |
firstVcl字段说明
| 响应参数 | 必须参数 | 参数类型 | 示例数据 | 说明 |
|---|---|---|---|---|
| vno | 是 | String | 沪FH8703 | 车牌号 |
| status | 是 | String | 1001 | 业务查询状态；详见附录A |
| lon | 是 | String | 64007815 | 经度，格式：1/600000;车辆最后定位经度（类型根据入参的backLonLatType决定，默认返回GCJ02） |
| lat | 是 | String | 17855836 | 纬度，格式：1/600000;车辆最后定位纬度（类型根据入参的backLonLatType决定，默认返回GCJ02） |
| adr | 是 | String | 上海市上海市浦东新区泥城镇 | 车辆地理位置名称 |
| utc | 是 | String | 1729588202000 | 车辆定位时间戳，单位：毫秒 |
| spd | 否 | String | 39.0 | 速度 |
| drc | 否 | String | 东南 | 车辆行驶方向 如: 东南 |
| direction | 否 | String | 307 | 车辆行驶方向值 如：357正北，大于0且小于90：东北，等于90：正东，大于90且小于180：东南，等于180：正南，大于180且小于270：西南，等于270：正西，大于270且小于等于359：西北，其他：未知 |
| province | 是 | String | 江苏省 | 省 |
| city | 是 | String | 镇江市 | 市 |
| country | 是 | String | 扬中市 | 县 |
| mil | 否 | String | 0.0 | 里程，单位：km（车机上报点自带里程）（暂未启用） |
| offlineState | 否 | String | true | 离线状态：true:离线，false:在线 |
| offlineTime | 否 | Integer | 5422 | 离线时长，单 位：分钟 |
| runDistance | 是 | String | 728.0 | 车辆已行驶距离，单位：km |
| remainDistance | 是 | String | 54.1 | 剩余运距，单位：km（若起始地、目的地不传则返回为空） |
| estimateArriveTime | 是 | String | 1626067123000 | 预计到达时间（时间戳）（若起始地、目的地不传则本字段返回为空），单位：毫秒 |
others字段说明（其余车辆列表JSON对象列表）
| 响应参数 | 必须参数 | 参数类型 | 示例数据 | 说明 |
|---|---|---|---|---|
| vno | 是 | String | 京AB0001 | 车牌号 |
| status | 是 | String | 1001 | 业务查询状态；详见附录A |
| lon | 是 | String | 64007815 | 经度，格式：1/600000;车辆最后定位经度（类型根据入参的backLonLatType决定，默认返回GCJ02） |
| lat | 是 | String | 17855836 | 纬度，格式：1/600000;车辆最后定位纬度（类型根据入参的backLonLatType决定，默认返回GCJ02） |
| adr | 是 | String | 上海市上海市浦东新区泥城镇 | 车辆地理位置名称 |
| utc | 是 | String | 1729588202000 | 车辆定位时间戳，如：1635497914000，单位：毫秒 |
| spd | 否 | String | 39.0 | 速度 |
| drc | 否 | String | 东南 | 车辆行驶方向 如: 东南 |
| direction | 否 | String | 307 | 车辆行驶方向值 如：357正北，大于0且小于90：东北，等于90：正东，大于90且小于180：东南，等于180：正南，大于180且小于270：西南，等于270：正西，大于270且小于等于359：西北，其他：未知 |
| province | 是 | String | 江苏省 | 省 |
| city | 是 | String | 镇江市 | 市 |
| country | 是 | String | 扬中市 | 县 |
| mil | 否 | String | 4003.0 | 里程，单位：km（车机上报点自带里程）（暂未启用） |