3.1 车辆数据导入

3.1.1 说明

请求方式:通过POST方式进行接口请求,以JSON格式返回结果。

接口名称:v1/import_truck.php

简要描述:用于企业ERP/WMS导入车辆信息数据到物流云平台,导入成功后,可通过“物流云平台 -> 运力管理 -> 车辆管理”进行管理。车牌号码存在时则覆盖,否则新增。

错误编码:0,1001,1002,1003,1004,1005,1900,2000

3.1.2 请求参数

参数名称格式描述参与签名必填
carlicense String 车牌号码(作为对接车辆的唯一标识) Y Y
carlicense_remark String 车牌备注(可作为挂车车牌) Y N
sourceid Integer

车辆属性

1 为自有车辆

2 为社会车辆

Y Y
groupname String 所属车队名称(与“物流云平台 -> 运力管理 -> 车队管理”中名称一致) Y Y
carmodel String 车辆类型(按车厢结构分,填写如:厢式货车、栏板式货车等;与“物流云平台 -> 数据字典 -> 车辆管理 -> 车辆类型”中名称一致) Y Y
cartype Integer 车辆型号(按吨位分,填写序号:1-微型 2-轻型 3-中型 4-重型) Y Y
carvin String 车架号 Y N
carengine String 发动机号 Y N
carbrand String 车辆品牌(与“物流云平台 -> 数据字典 -> 车辆管理 -> 车辆品牌”中名称一致) Y N
manufactory String 制造商(已作废,为了兼容保留参数) Y N
locatetype Integer 设备类型(已作废,为了兼容保留参数) Y N
iddumber String 设备号(已作废,为了兼容保留参数) Y N
carweight Float 载重(吨) Y N
carvol Float 容积(方) Y N
carlong Float 车辆长度(米) Y N
carwidth Float 车辆宽度(米) Y N
carheight Float 车辆高度(米) Y N
avgoil Float 百公里油耗(升) Y N
公共输入参数 详见公共请求参数

3.1.3 返回结果

参数名称格式描述
errcode Integer 错误编码(详见错误编码
errmsg String 错误提示

3.2 车辆实时定位

3.2.1 说明

请求方式:通过POST方式进行接口请求,以JSON格式返回结果。

接口名称:v1/get_real_track.php

简要描述:通过车辆的绑定设备ID或车牌号获取车辆实时位置。

错误编码:0,1001,1002,1003,1004,1005,1900,2000

3.2.2 请求参数

参数名称格式描述参与签名必填
duid String 设备ID(多个以逗号分隔,单次最多50个) Y N
carlicense String 车牌号码(与“设备ID”参数为二选一必填,二者都传参时忽略此参数;单车辆查询) Y N
公共输入参数 详见公共请求参数

3.2.3 返回结果

参数名称格式描述
errcode Integer 错误编码(详见错误编码
errmsg String 错误提示
datas x Array Integer 坐标X
y Integer 坐标Y
time Integer 采集时间(UTC时间戳)
speed Integer 即时速度(km/h)
high Integer 高程 (m)
direction Integer 行驶方向(正北为0度,顺序针)
duid Integer 设备ID

PS:返回结果的datas属性是JSON数组,数组下标为设备ID。

3.3 车辆历史轨迹

3.3.1 说明

请求方式:通过POST方式进行接口请求,以JSON格式返回结果。

接口名称:v1/get_history_track.php

简要描述:通过车辆的绑定设备ID或车牌号获取车辆的行驶历史轨迹(时间跨度不能超过24小时)。

错误编码:0,1001,1002,1003,1004,1005,1900,2000

3.3.2 请求参数

参数名称格式描述参与签名必填
duid Integer 设备ID Y N
carlicense String 车牌号码(与“设备ID”参数为二选一必填,二者都传参时忽略此参数;单车辆查询) Y N
btime Integer 开始时间(UTC时间戳) Y Y
etime Integer 结束时间(UTC时间戳) Y Y
公共输入参数 详见公共请求参数

3.3.3 返回结果

参数名称格式描述
errcode Integer 错误编码(详见错误编码
errmsg String 错误提示
datas x Array Integer 坐标X
y Integer 坐标Y
time Integer 采集时间(UTC时间戳)
speed Integer 即时速度(km/h)
high Integer 高程 (m)
direction Integer 行驶方向(正北为0度,顺序针)
duid Integer 设备ID
 
版权所有 ©马蹄圈,并保留所有权利。
粤ICP备16121480号