运输轨迹(货车 GPS)
按车牌查货车 GPS 轨迹,用于收购、运输业务的留痕与交易存证(比如给入库单配一条「货从哪儿来」的轨迹)。 鉴权与全站一致:X-App-Key + X-Timestamp + X-Sign 三个请求头。 本能力可作为独立产品单独签发密钥,也可为已有客户(如反向开票)附加开通;预检免费,轨迹/地图/位置查询按次计费。未开通调用会返回 403,开通请联系平台。
① 车辆入网预检(免费)
POST https://openapi.kailingteck.com/api/v1/trace/check
| 参数 | 必填 | 说明 |
|---|---|---|
plateNo | 必填 | 车牌号,如「渝A12345」 |
color | 选填 | 车牌颜色:2 黄牌 / 1 蓝牌 / 3 黄绿牌。不传自动依次试 |
返回 trackable=true/false 与命中的 color(车牌颜色)。 预检不收费——★正确姿势:先预检,trackable=true 再查轨迹,并把 color 带给后续接口,省掉按颜色试探的计费调用。 false 表示车辆未接入 GPS 网(私家车、未入网货车),查不到轨迹,业务上请走手动登记起终点。
② 查轨迹(车牌 + 时间段)
POST https://openapi.kailingteck.com/api/v1/trace/track
| 参数 | 必填 | 说明 |
|---|---|---|
plateNo | 必填 | 车牌号 |
startTime | 必填 | 轨迹开始时间,格式 yyyy-MM-dd HH:mm:ss |
endTime | 必填 | 轨迹结束时间,同上格式 |
color | 选填 | 车牌颜色(①预检返回的 color 直接传进来,省一轮试探) |
返回 found、mileage(里程)、points(轨迹点数组, 已换算成度数)与 raw(上游原始数据)。 ★坐标系是 WGS84;腾讯/高德地图是 GCJ-02,画图前必须转换,否则轨迹整体偏移数百米。
③ 轨迹地图链接(免画图)
POST https://openapi.kailingteck.com/api/v1/trace/map
| 参数 | 必填 | 说明 |
|---|---|---|
plateNo | 必填 | 车牌号 |
startTime | 必填 | 开始时间 yyyy-MM-dd HH:mm:ss |
endTime | 必填 | 结束时间 |
startAddr | 选填 | 起点地址文字,显示在地图页上 |
endAddr | 选填 | 终点地址文字 |
color | 选填 | 车牌颜色 |
返回 mapUrl——可直接打开看轨迹连线的地图页地址,不想自己处理坐标画图就用它。
④ 最新位置
POST https://openapi.kailingteck.com/api/v1/trace/position
传 plateNo(+可选 color),返回该车最近一次上报的位置position(原始字段)。在途监控用。
注意事项
- 时间一律
yyyy-MM-dd HH:mm:ss;查询时段就是运输时段(如 发货时间 → 过磅时间)。 - 车牌颜色不确定就不传,平台自动按 黄/蓝/黄绿 轮询;①预检返回的 color 请在后续查询里带上。
- 「查不到轨迹」不一定是错:车未入网、时段不对、车停着没动都会查不到,返回里 found=false + hint 有说明。
- 轨迹查询按次计费,预检免费——批量场景先预检再查,别拿查询接口当预检用。