第六节 车载终端经典报文定义(仅供参考)

亮子 | 2026-02-25 09:13:21 | 27 | 0 | 0 | 0

(1)车辆注册(0003)

{
  "msgId": "123456789",
  "vin": "LFV3A23K9P3123456",
  "imei": "868693056712345",
  "msgType": "0003",                // 车载终端注册
  "timestamp": "1701312347000",     // 时间戳
  // ----- 车辆绑定信息(物流专用)-----
  "vehicleBinding": {
    "vin": "LFV3A23K9P3123456",          // 车辆识别代号/车架号: 车的唯一ID (String, 物流场景强烈建议)
    "plateNumber": "京A·12345",          // 车牌号 (String, 可选)
    "plateColor": 1,                       // 车牌颜色: 0=蓝, 1=黄, 2=绿(新能源) (Integer)
    "vehicleModel": "解放J6P领航版3.0",      // 车辆型号 (String, 可选)
    "bindTime": "1701312345123"               // 绑车时间戳 (Long, 可选)
  }
}
{
  "msgId": "123456789",
  "msgType": "0004",                // 车载终端注册应答
  "timestamp": "1701312347000",     // 时间戳
  // ----- 应答消息 -----
  "result": {
      "resultCode": 0,                   // 注册结果: 0=成功, 1=终端已被禁用, 2=设备不存在, 3=版本过低, 4=鉴权失败
      "resultMsg": "SUCCESS"             // 结果描述
  }
}

(2)车辆注销(0005)

{
  "msgId": "123456789",
  "vin": "LFV3A23K9P3123456",
  "imei": "868693056712345",
  "msgType": "0005",                // 车载终端注销
  "timestamp": "1701312347000",     // 时间戳
}

(3)车辆心跳(0001)

{
  "msgId": "123456789",
  "vin": "LFV3A23K9P3123456",
  "imei": "868693056712345",
  "msgType": "0001",                // 车载终端心跳
  "timestamp": "1701312347000",     // 时间戳
  // ----- 车载终端心跳报文-----
  "heartbeat": {
    "status": 1,                      // 终端工作状态: 1=正常 (int)
    "voltage": 24.3,                    // 当前电压 (V, float)
    "signalIntensity": 78                 // 信号强度 (0-100, int)
  }
}
{
  "msgId": "123456789",
  "msgType": "0002",                // 车载终端心跳应答
  "timestamp": "1701312347000",     // 时间戳
  // ----- 应答消息 -----
  "result": {
      "resultCode": 0,                   // 应答结果: 0=成功, 1=终端已被禁用, 2=设备不存在, 3=版本过低, 4=鉴权失败
      "resultMsg": "SUCCESS"             // 结果描述
  }
}

(4)车辆位置上报(1001)

{
  "msgId": "123456789",
  "vin": "LFV3A23K9P3123456",
  "imei": "868693056712345",
  "msgType": "1001",                // 车载终端位置上报
  "timestamp": "1701312347000",     // 时间戳

  // ----- 位置信息(GPS/北斗)-----
  "location": {
    "lon": 116.397423,                // 经度 GCJ02/WGS84坐标系 (double)
    "lat": 39.908723,                  // 纬度 (double)
    "speed": 65.5,                     // 车速 (km/h, float)
    "direction": 135,                   // 行驶方向 0-359度, 0正北 (int)
    "altitude": 45,                     // 海拔 (米, int)
    "gnssTime": "2023-11-30 14:45:32",  // GNSS卫星时间 (string)
    "posAccuracy": 3,                    // 定位精度 (米, int) 数值越小越准
    "satelliteCount": 12                  // 当前搜星数量 (int)
  }
}

(5)车辆状态上报(1009)

{
  "msgId": "123456789",
  "vin": "LFV3A23K9P3123456",
  "imei": "868693056712345",
  "msgType": "1009",                // 车辆状态上报
  "timestamp": "1701312347000",     // 时间戳

  // ----- 车辆状态(来自CAN总线)-----
  "vehicleStatus": {
    "engineStatus": 1,                  // 发动机状态: 0=熄火, 1=运行 (int)
    "totalMileage": 123456.7,            // 车辆总里程 (公里, float)
    "fuelLevel": 65,                      // 油箱液位/电量百分比 (0-100, int)
    "batteryVoltage": 24.5,                // 电瓶电压 (V, float)
    "odometer": 125.3,                      // 本次行程里程 (公里, float)
    "rpm": 2100,                             // 发动机转速 (转/分钟, int)
    "fuelConsumption": 18.5                  // 百公里实时油耗 (L/100km, float)
  }
}

(6)电子围栏报警信息(2009)

{
  "msgId": "123456789",
  "vin": "LFV3A23K9P3123456",
  "imei": "868693056712345",
  "msgType": "2009",                // 车辆状态上报
  "timestamp": "1701312347000",     // 时间戳
  
    "alarmId": "ALM20231130144532123", // 报警唯一ID,用于去重 (string)
  "alarmType": "FATIGUE",            // 报警类型: FATIGUE=疲劳驾驶, DISTRACT=分神, SMOKE=抽烟, COLLISION=碰撞, GEO=电子围栏 (string)
  "alarmLevel": 2,                    // 报警级别: 1=提示, 2=严重, 3=紧急 (int)
  
    // 报警发生时的快照数据
  "snapshot": {
    "lon": 116.398123,
    "lat": 39.908901,
    "speed": 82.3,
    "direction": 180,
    "timestamp": 1701312345998
  },
  
  // ----- 电子围栏详情 -----
  "fenceInfo": {
    "fenceId": "FENCE20231130001",           // 围栏ID(云端下发的围栏标识)
    "fenceName": "北京市五环内-禁行区",        // 围栏名称(用于显示)
    "fenceType": 2,                           // 围栏类型: 1=圆形, 2=多边形, 3=路线, 4=行政区域
    "fenceAction": "ENTER",                    // 触发动作: ENTER=进入, EXIT=驶出, OVERSPEED=超速, OVERSTAY=超时停留
    "fenceRule": "NO_ENTRY",                   // 围栏规则: NO_ENTRY=禁止进入, NO_EXIT=禁止驶出, SPEED_LIMIT=限速, TIME_LIMIT=限时
    
    // 围栏几何信息(根据fenceType不同)
    "geometry": {
      // 多边形围栏示例
      "type": "Polygon",
      "coordinates": [
        [116.397, 39.908],    // 顶点1
        [116.408, 39.915],    // 顶点2
        [116.415, 39.902],    // 顶点3
        [116.398, 39.895],    // 顶点4
        [116.397, 39.908]     // 回到起点闭合
      ],
      // 如果是圆形围栏
      // "type": "Circle",
      // "center": [116.405, 39.908],
      // "radius": 5000  // 半径(米)
    },
    
    "boundary": {
      "minLon": 116.395,           // 围栏最小经度(外包矩形)
      "maxLon": 116.418,            // 围栏最大经度
      "minLat": 39.890,              // 围栏最小纬度
      "maxLat": 39.920                 // 围栏最大纬度
    }
  }
}