运单轨迹
请求地址
https://www.xxyb.cn/union/api/link/createWaybillTrajectory
Header
| 参数名 | 必选 | 类型 | 说明 |
|---|---|---|---|
| token | 是 | String | 应用令牌 |
| cid | 是 | String | 合作ID |
| corpId | 是 | String | 企业ID |
请求参数
ApiConsignorWaybillTrajectoryReq 运单轨迹请求
| 字段 | 类型 | 层级 | 描述 | 必填 |
|---|---|---|---|---|
| billCode | String | 1 | 运单编号 | 是 |
| waybillTrajectoryDomains | List<ApiWaybillTrajectoryDomain> | 1 | 运单轨迹信息 | 是 |
ApiWaybillTrajectoryDomain 运单轨迹信息
| 字段 | 类型 | 层级 | 描述 | 必填 |
|---|---|---|---|---|
| locationType | LocationTypeEnum | 2 | 定位类型 | 是 |
| licensePlateNumber | String | 2 | 车牌号 | 否 |
| locationAddress | String | 2 | 定位地址 | 否 |
| locationProvince | String | 2 | 定位省份 | 否 |
| locationCity | String | 2 | 定位市 | 否 |
| locationArea | String | 2 | 定位区 | 否 |
| lat | BigDecimal | 2 | 纬度 | 是 |
| lon | BigDecimal | 2 | 经度 | 是 |
| direction | String | 2 | 方向 | 否 |
| agl | String | 2 | 方向 原始数据 | 否 |
| speed | String | 2 | 速度 (km/h) | 否 |
| high | String | 2 | 高度 | 否 |
| mileage | String | 2 | 里程 | 否 |
| locationTime | Date | 2 | 定位时间 | 是 |
| description | String | 2 | 描述 | 否 |
| remark | String | 2 | 备注 | 否 |
请求参数示例
json
{
"billCode": "WB202506260001",
"waybillTrajectoryDomains": [
{
"locationType": "GPS",
"licensePlateNumber": "沪A12345",
"locationAddress": "上海市浦东新区世纪大道100号",
"locationProvince": "上海市",
"locationCity": "上海市",
"locationArea": "浦东新区",
"lat": 31.2304,
"lon": 121.4737,
"direction": "东北",
"agl": "90",
"speed": "60",
"high": "10",
"mileage": "1000",
"locationTime": "2025-06-27 10:30:00",
"locationStatus": true,
"description": "正常行驶中",
"remark": "高速公路路段"
},
{
"locationType": "BASE_STATION",
"licensePlateNumber": "沪A12345",
"locationAddress": "北京市朝阳区建国路88号",
"locationProvince": "北京市",
"locationCity": "北京市",
"locationArea": "朝阳区",
"lat": 39.9042,
"lon": 116.4074,
"direction": "西南",
"agl": "180",
"speed": "40",
"high": "50",
"mileage": "1200",
"locationTime": "2025-06-27 14:30:00",
"locationStatus": true,
"description": "到达目的地附近",
"remark": "城市道路路段"
}
]
}