行程数据上报 MQTT 协议

1. 主题与域名定义

项目 说明
域名 gpsmqtt.yudoplatform.com
端口号 1883
主题 gps/trip
QoS 推荐 QoS 1(至少一次)
Retain 不保留(Retain = 0)
消息方向 车载终端 → 服务端

2. 消息格式

整条消息为纯文本字符串,使用 管道符 | 分隔不同字段。

2.1 字段顺序及说明

序号 字段名称 类型 说明 示例
1 计划开始时间戳 数字 Unix 时间戳(秒),行程计划开始时间 1782383495
2 计划结束时间戳 数字 Unix 时间戳(秒),行程计划结束时间 1782383495
3 订单编号 字符串 唯一订单号 202601261234
4 工作类型 数字 业务:0/安装:1/试模:2/AS:3 1
5 车牌号 字符串 车辆牌照 粤S123M12
6 员工编号 字符串 执行行程的员工工号 20241
7 工作内容 字符串 工作内容 设备巡检
8+ 轨迹点 对象 每个轨迹点格式为 经度,纬度,时间戳;多个轨迹点用 ` ` 分隔

注意:

  • 从第 7 个字段开始,每个字段代表一个轨迹点,由逗号分隔的 经度,纬度,Unix时间戳 组成。
  • 轨迹列表中第一个组合是实际开始的经纬度和时间戳,第二个组合是实际结束的经纬度和时间戳,第三个开始是按顺序的目的地组合
  • 轨迹点之间仍然使用 | 分隔,至少 1 个,无上限,按拜访顺序排列。
  • 所有时间戳均采用秒级 Unix 时间戳。
  • 经纬度采用 WGS-84 坐标系,使用小数格式。

3. 消息示例

`text
1782383495|1782383495|202601261234|1|S123M12|20241|设备巡检|113.736459,23.048129,1782383495|113.736459,23.048129,1782383495|113.736459,23.048129,1782383495

作者:钟健钊  创建时间:2026-06-26 09:48
最后编辑:钟健钊  更新时间:2026-06-29 10:33