Skip to content

JT/T 808 2013 网关数据交换格式

本页定义了 emqx_jt808EMQX 之间数据交换的格式。

约定:

  • Payload 采用 JSON 格式进行组装
  • JSON Key 采用全小写格式命名

JSON 结构示例

终端到服务器

json
{
  "header" : {
    "msg_id" : 1,
    "encrypt": 0,
    "len": VAL,
    "phone": 13900000000,
    "msg_sn": 0
  },
  "body": {
    "seq": 1,
    "id": 1,
    "result": 0
  }
}

服务器到终端

json
{
  "header": {
    "msg_id": 32769,
    "encrypt": 0,
    "phone": 13900000000,
    "msg_sn": 0
  },
  "body": {
    "seq": 1,
    "id": 1,
    "result": 0
  }
}

数据类型对照表

JT808 Defined TypeIn JSON TypeComment
BYTEintegerin decimal
WORDintegerin decimal
DWORDintegerin decimal
BYTE(n)string
BCD(n)string
STRINGstring

字段对照表

消息头字段对照表

FieldJSON Key nameValue TypeValue Type in JSON
消息 IDmsg_idwordinteger
数据加密方式encryptwordinteger
终端手机号phonebcd(6)string
消息流水号msg_snwordinteger
Optional FieldJSON Key nameValue TypeValue Type in JSON
消息总包数frag_totalwordinteger
消息包序号frag_snwordinteger
  • 存在 frag_totalfrag_sn 时表示消息体为长消息,进行分包处理

消息体字段对照表

终端通用应答 "msg_id": 1 0x0001

FieldJSON Key nameValue TypeValue Type in JSON
应答流水号seqwordinteger
应答 IDidwordinteger
结果resultbyteinteger

平台通用应答 "msg_id": 32769 0x8001

FieldJSON Key nameValue TypeValue Type in JSON
应答流水号seqwordinteger
应答 IDidwordinteger
结果resultbyteinteger

终端心跳 "msg_id": 2 0x0002

空 JSON

补传分包请求 "msg_id": 32771 0x8003

FieldJSON Key nameValue TypeValue Type in JSON
原始消息流水号seqwordinteger
重传包总数lengthbyteinteger
重传包 ID 列表idsbyte(2*length)list of integer

终端注册 "msg_id": 256 0x0100

FieldJSON Key nameValue TypeValue Type in JSON
省域 IDprovincewordinteger
市县域 IDcitywordinteger
制造商 IDmanufacturebyte(5)string
终端型号modelbyte(20)string
终端 IDdev_idbyte(7)string
车牌颜色colorbyteinteger
车辆标识license_numberstringstring

终端注册应答 "msg_id": 33024 0x8100

FieldJSON Key nameValue TypeValue Type in JSON
应答流水号seqwordinteger
结果resultbyteinteger

只有成功后才有此字段

Optional FieldJSON Key nameValue TypeValue Type in JSON
鉴权码auth_codestringstring

终端注销 "msg_id": 3 0x0003

空 JSON

终端鉴权 "msg_id": 258 0x0102

FieldJSON Key nameValue TypeValue Type in JSON
鉴权码codestringstring

设置终端参数 "msg_id": 33027 0x8103

FieldJSON Key nameValue TypeValue Type in JSON
参数总数lengthbyteinteger
参数项列表paramslistlist of id and value. [{"id":ID, "value": VAL}, ...]
参数项iddwordinteger
参数值valuebyteinteger

参数 ID 说明见协议规定。

查询终端参数 "msg_id": 33028 0x8104

空 JSON

查询指定终端参数 "msg_id": 33030 0x8106

FieldJSON Key nameValue TypeValue Type in JSON
参数总数lengthbyteinteger
参数 ID 列表idsbyte(2*length)list of id. [1, 2, 3, 4, ...]

参数 ID 列表中元素为 integer

查询终端应答参数 "msg_id": 260 0x0104

FieldJSON Key nameValue TypeValue Type in JSON
应答流水号seqwordinteger
应答参数个数lengthbyteinteger
参数项列表paramslistlist of id and value. [{"id":ID, "value": VAL}, ...]
参数项iddwordinteger
参数值valuebyteinteger

参数 ID 说明见协议规定.

终端控制 "msg_id": 33029 0x8105

FieldJSON Key nameValue TypeValue Type in JSON
命令字commandbyteinteger
命令参数paramstringstring

查询终端属性 "msg_id": 33031 0x8107

空 JSON

查询终端属性应答 "msg_id": 263 0x0107

FieldJSON Key nameValue TypeValue Type in JSON
终端类型typewordinteger
制造商 IDmanufacturebyte(5)string
终端型号modelbyte(20)string
终端 IDidbyte(7)string
终端 SIM 卡 ICCIDiccidbyte(10)string
终端硬件版本号hardware_versionstringstring
终端硬件固件号firmware_versionstringstring
GNSS 模块属性gnss_propbyteinteger
通信模块属性comm_propbyteinteger
  • 终端硬件版本号长度、终端固件版本号长度,将被用于二进制报文解析,不向上暴露

下发终端升级包 "msg_id": 33032 0x8108

FieldJSON Key nameValue TypeValue Type in JSON
升级类型typebyteinteger
制造商 IDmanufacturerbyte(5)string
版本号长度ver_lenbyteinteger
版本号versionstringstring
升级数据包长度fw_lendwordinteger
升级数据包firmwarebinarystring(base64 encoded)

终端升级结果通知 "msg_id": 264 0x0108

FieldJSON Key nameValue TypeValue Type in JSON
升级类型typebyteinteger
升级结果resultbyteinteger

位置信息汇报 "msg_id": 512 0x0200

FieldJSON Key nameValue TypeValue Type in JSON
报警标志alarmdwordinteger
状态statusdwordinteger
纬度latitudedwordinteger
经度longitudedwordinteger
高程altitudewordinteger
速度speedwordinteger
方向directionwordinteger
时间timebcd(6)string
Optional FieldJSON Key nameValue TypeValue Type in JSON
位置附加信息项列表extra-map
  • 位置附加信息项列表, 在 extra
Field (附加信息描述)JSON Key nameValue TypeValue Type in JSON
里程mileagedwordinteger
油量fuel_meterwordinteger
行驶记录功能获取的速度speedwordinteger
需要人工确认报警事件的 IDalarm_idwordinteger
超速报警附加信息(长度1或5)overspeed_alarm-map
进出区域/路线报警附加信息in_out_alarm-map
路段行驶时间不足/过长报警附加信息path_time_alarm-map
扩展车辆信号状态位见状态位附表--
IO 状态位io_status-map
模拟量analog-map
无线通信网络信号强度rssibyteinteger
GNSS 定位卫星数gnss_sat_numbyteinteger
后续自定义信息长度custome-string(base64 encoded)
## TODO 自定义区域
  • 超速报警附加信息(长度1或5), 置于 map overspeed_alarm
FieldJSON Key nameValue TypeValue Type in JSON
位置类型typebyteinteger
Optional FieldJSON Key nameValue TypeValue Type in JSON
区域或路段 IDiddwordinteger
  • 进出区域/路线报警附加信息, 置于 map in_out_alarm
FieldJSON Key nameValue TypeValue Type in JSON
位置类型typebyteinteger
区域或路段 IDiddwordinteger
方向directionbyteinteger
  • 路段行驶时间不足/过长报警附加信息, 置于 map path_time_alarm
FieldJSON Key nameValue TypeValue Type in JSON
路段 IDiddwordinteger
路段行驶时间timewordinteger
结果resultbyteinteger
  • IO 状态位, 置于 map io_status
FieldJSON Key nameValue TypeValue Type in JSON
深度休眠状态deep_sleep1 bitinteger
休眠状态sleep1 bitinteger
  • 模拟量, 置于 map analog
FieldJSON Key nameValue TypeValue Type in JSON
模拟量 0ad016 bitsinteger
模拟量 1ad116 bitsinteger
  • 扩展车辆信号状态位, 置于 map extra
FieldJSON Key nameValue TypeValue Type in JSON
信号signal- 2 bitsmap, {"low_beam": VAL, "high_beam": VAL}
右转向灯信号right_turn1 bitinteger
左转向灯信号left_turn1 bitinteger
制动信号brake1 bitinteger
倒档信号reverse1 bitinteger
雾灯信号fog1 bitinteger
示廓灯side_marker1 bitinteger
喇叭状态horn1 bitinteger
空调状态air_conditioner1 bitinteger
空档信号neutral1 bitinteger
缓速器工作retarder1 bitinteger
ABS 工作abs1 bitinteger
加热器工作heater1 bitinteger
离合器状态cluth1 bitinteger
  • 信号状态, 置于 map signal
FieldJSON Key nameValue TypeValue Type in JSON
近光灯信号low_beam1 bitinteger
远光灯信号high_beam1 bitinteger

示例:

json
{
  "header" : {
    "msg_id" : 1,
    "encrypt": 0,
    "len": VAL,
    "phone": 13900000000,
    "msg_sn": 0
  },
  "body": {
    "alarm": VAL,
    "status": VAL,
    "latitude": VAL,
    "longitude": VAL,
    "altitude": VAL,
    "speed": VAL,
    "direction": VAL,
    "time": VAL,
    "extra": {
      "mileage": VAL,
      "fuel_unit": VAL,
      "speed": VAL,
      "alarm_id": VAL,
      "overspeed_alarm": {
        "type": VAL,
        "id": VAL
      },
      "in_out_alarm": {
        "type": VAL,
        "id": VAL,
        "direction": VAL
      },
      "path_time_alarm": {
        "id": VAL,
        "time": VAL,
        "result": VAL
      },
      "signal": {
        "low_beam": VAL,
        "high_beam": VAL
      },
      "right_turn": VAL,
      "left_turn": VAL,
      "break": VAL,
      "reverse": VAL,
      "fog": VAL,
      "side_marker": VAL,
      "horn": VAL,
      "air_conditioner": VAL,
      "neutral": VAL,
      "retarder": VAL,
      "abs": VAL,
      "heater": VAL,
      "cluth": VAL,
      "io_status": {
        "deep_sleep": VAL,
        "sleep": VAL
      },
      "analog": {
        "ad0": VAL,
        "ad1": VAL
      }
    }
  }
}

位置信息查询 "msg_id": 33281 0x8201

空 JSON

位置信息查询应答 "msg_id": 513 0x0201

FieldJSON Key nameValue TypeValue Type in JSON
应答流水号seqwordinteger
位置信息汇报params-map

临时位置跟踪控制 "msg_id": 33282 0x8202

FieldJSON Key nameValue TypeValue Type in JSON
时间间隔periodwordinteger
跟踪位置有效期expirydwordinteger

人工确认报警消息 "msg_id": 33283 0x8203

FieldJSON Key nameValue TypeValue Type in JSON
报警消息流水号seqwordinteger
人工确认报警类型typedwordinteger

文本信息下发 "msg_id": 33536 0x8300

FieldJSON Key nameValue TypeValue Type in JSON
标志flagbyteinteger
文本信息textstringstring

事件设置 "msg_id": 33537 0x8301

FieldJSON Key nameValue TypeValue Type in JSON
设置类型typebyteinteger
设置总数lengthbyteinteger
事件项列表eventslistlist of event. [{"id": ID, "length": LEN, "content": CON}, ...]
事件 IDidbyteinteger
事件内容长度lengthbyteinteger
事件内容contentstringstring

事件报告 "msg_id": 769 0x0301

FieldJSON Key nameValue TypeValue Type in JSON
事件 IDidbyteinteger

提问下发 "msg_id": 33538 0x8302

FieldJSON Key nameValue TypeValue Type in JSON
标志flagbyteinteger
问题内容长度lengthbyteinteger
问题questionstringstring
候选答案列表answerslistlist of answer. [{"id": ID, "len": LEN, "answer": ANS}, ...]
答案 IDidbyteinteger
答案内容长度lenbyteinteger
答案内容answerstringstring

提问应答 "msg_id": 770 0x0302

FieldJSON Key nameValue TypeValue Type in JSON
应答流水号seqwordinteger
答案 IDidbyteinteger

信息点播菜单设置 "msg_id": 33539 0x8303

FieldJSON Key nameValue TypeValue Type in JSON
设置类型typebyteinteger
信息项总数lengthbyteinteger
信息项列表menuslistlist of menu
信息类型typebyteinteger
信息名称长度lengthwordinteger
信息名称infostringstring

信息点播/取消 "msg_id": 771 0x0303

FieldJSON Key nameValue TypeValue Type in JSON
信息类型idbyteinteger
点拨/取消标志flagbyteinteger

信息服务 "msg_id": 33540 0x8304

FieldJSON Key nameValue TypeValue Type in JSON
信息类型typebyteinteger
信息长度lengthwordinteger
信息内容infostringstring

电话回拨 "msg_id": 33792 0x8400

FieldJSON Key nameValue TypeValue Type in JSON
标志typebyteinteger
电话号码phonestringstring

设置电话本 "msg_id": 33793 0x8401

FieldJSON Key nameValue TypeValue Type in JSON
设置类型typebyteinteger
联系人总数lengthbyteinteger
联系人项contactslistlist of contact.
标志typebyteinteger
号码长度phone_lenbyteinteger
电话号码phonestringstring
联系人长度name_lenbyteinteger
联系人namestringstring

联系人项示例

json
[{"type": TYPE, "phone_len", PH_LEN, "phone": PHONE, "name_len": NAME_LEN, "name": NAME}, ...]

车辆控制 "msg_id": 34048 0x8500

FieldJSON Key nameValue TypeValue Type in JSON
标志控制flagbyteinteger

车辆控制应答 "msg_id": 1280 0x0500

FieldJSON Key nameValue TypeValue Type in JSON
应答流水号seqwordinteger
位置信息汇报消息体locationmapmap of location

设置圆形区域 "msg_id": 34304 0x8600

FieldJSON Key nameValue TypeValue Type in JSON
设置属性typebyteinteger
区域总数lengthbyteinteger
区域项areaslistlist of area.
区域 IDiddwordinteger
区域属性flagdwordinteger
中心点纬度center_latitudedwordinteger
中心点经度center_longitudedwordinteger
半径radiusdwordinteger
起始时间start_timestringstring
结束时间end_timestringstring
最高速度max_speedwordinteger
超速持续时间overspeed_durationbyteinteger

区域列表示例

json
[{"id": ID,
   "flag": FLAG,
   "center_latitude": CEN_LAT,
   "center_longitude": CEN_LON,
   "radius": RADIUS,
   "start_time": START_TIME,
   "end_time": END_TIME,
   "max_speed", MAX_SPEED,
   "overspeed_duration", OVERSPEED_DURATION
   },
  ...
 ]

删除圆形区域 "msg_id": 34305 0x8601

FieldJSON Key nameValue TypeValue Type in JSON
区域数lengthbyteinteger
区域 ID 列表idslistlist of id.
区域 ID 1~n-dwordinteger

[ID1, ID2, ...]

设置矩形区域 "msg_id": 34306 0x8602

FieldJSON Key nameValue TypeValue Type in JSON
设置属性typebyteinteger
区域总数lengthbyteinteger
区域项areaslistlist of rectangle area.
区域 IDiddwordinteger
区域属性flagdwordinteger
左上点纬度lt_latdwordinteger
左上点经度lt_lngdwordinteger
右下点纬度rb_latdwordinteger
右下点经度rb_lngdwordinteger
起始时间start_timestringstring
结束时间end_timestringstring
最高速度max_speedwordinteger
超速持续时间overspeed_durationbyteinteger

删除矩形区域 "msg_id": 34307 0x8603

FieldJSON Key nameValue TypeValue Type in JSON
区域数lengthbyteinteger
区域 ID 列表idslistlist of id.
区域 ID 1~n-dwordinteger

设置多边形区域 "msg_id": 34308 0x8604

FieldJSON Key nameValue TypeValue Type in JSON
区域 IDiddwordinteger
区域属性flagdwordinteger
起始时间start_timestringstring
结束时间end_timestringstring
最高速度max_speedwordinteger
超速持续时间overspeed_durationbyteinteger
区域总顶点数lengthwordinteger
顶点项列表pointslistlist of point.
顶点纬度latdwordinteger
顶点经度lngdwordinteger

删除多边形区域 "msg_id": 34309 0x8605

FieldJSON Key nameValue TypeValue Type in JSON
区域数lengthbyteinteger
区域 ID 列表idslistlist of id.
区域 ID 1~n-dwordinteger

设置路线 "msg_id": 34310 0x8606

FieldJSON Key nameValue TypeValue Type in JSON
路线 IDiddwordinteger
路线属性flagwordinteger
起始时间start_timestringstring
结束时间end_timestringstring
路线总拐点数lengthwordinteger
拐点项pointslistlist of point.
拐点 IDpoint_iddwordinteger
路段 IDpath_iddwordinteger
拐点纬度point_latdwordinteger
拐点经度point_lngdwordinteger
路段宽度widthbyteinteger
路段属性attribbyteinteger
路段行驶过长阈值passedwordinteger
路段行驶不足阈值uncoveredwordinteger
路段最高速度max_speedwordinteger
路段超速持续时间overspeed_durationbyteinteger

删除路线 "msg_id": 34311 0x8607

FieldJSON Key nameValue TypeValue Type in JSON
路线数lengthbyteinteger
路线列表idslistlist of id
路线 ID-dwordinteger

行驶记录数据采集命令 "msg_id": 34560 0x8700

FieldJSON Key nameValue TypeValue Type in JSON
命令字commandbyteinteger
数据块paramstring(base64 encoded)string

行驶记录数据上传 "msg_id": 1792 0x0700

FieldJSON Key nameValue TypeValue Type in JSON
应答流水号seqwordinteger
命令字commandbyteinteger
数据块datastring(base64 encoded)string

行驶记录参数下传命令 "msg_id": 34561 0x8701

FieldJSON Key nameValue TypeValue Type in JSON
命令字commandbyteinteger
数据块paramstring(base64 encoded)string

电子运单上报 "msg_id": 1793 0x0701

FieldJSON Key nameValue TypeValue Type in JSON
电子运单长度lengthdwordinteger
电子运单内容datastring(base64 encoded)string

上报驾驶员身份信息请求 "msg_id": 34562 0x8702

空 JSON

驾驶员身份信息采集上报 "msg_id": 1794 0x0702

FieldJSON Key nameValue TypeValue Type in JSON
状态statusbyteinteger
时间timestringstring
IC 卡读取结果ic_resultbyteinteger
驾驶员姓名driver_namestringstring
从业资格证编码certificatestringstring
发证机构名称organizationstringstring
证件有效期cert_expirystringstring

定位数据批量上传 "msg_id": 1796 0x0704

FieldJSON Key nameValue TypeValue Type in JSON
位置数据类型typebyteinteger
数据项个数lengthwordinteger
位置汇报数据项locationlistlist of location

CAN 总线数据上传 "msg_id": 1797 0x0705

FieldJSON Key nameValue TypeValue Type in JSON
数据项个数lengthwordinteger
CAN 总线数据接收时间timebcd(5)integer
CAN 总线数据项can_datalistlist of can data.
CAN 总线通道号channel1 bitinteger
帧类型frame_type1 bitinteger
数据采集方式data_method1 bitinteger
CAN 总线 IDid29 bitsinteger
CAN 数据databinarystring(base64 encoded)

多媒体时间信息上传 "msg_id": 2048 0x0800

FieldJSON Key nameValue TypeValue Type in JSON
多媒体数据 IDiddwordinteger
多媒体类型typebyteinteger
多媒体编码格式formatbyteinteger
事件项编码eventbyteinteger
通道 IDchannelbyteinteger

多媒体数据上传 "msg_id": 2049 0x0801

FieldJSON Key nameValue TypeValue Type in JSON
多媒体 IDiddwordinteger
多媒体类型typebyteinteger
多媒体编码格式formatbyteinteger
事件项编码eventbyteinteger
通道 IDchannelbyteinteger
位置信息汇报locationbyte(28)map
多媒体数据包multimediabinarystring(base64 encoded)

多媒体数据上传应答 "msg_id": 34816 0x8800

FieldJSON Key nameValue TypeValue Type in JSON
多媒体 IDmm_iddwordinteger
重传包总数lengthbyteinteger
重传包 ID 列表retx_idslistlist of retry IDs

摄像头立即拍摄命令 "msg_id": 34817 0x8801

FieldJSON Key nameValue TypeValue Type in JSON
通道 IDchannel_idbyteinteger
拍摄命令commandwordinteger
拍照间隔/录像时间periodwordinteger
保存标志savebyteinteger
分辨率resolutionbyteinteger
图像/视频质量qualitybyteinteger
亮度brightbyteinteger
对比度contrastbyteinteger
饱和度saturatebyteinteger
色度chromaticitybyteinteger

摄像头立即拍摄应答 "msg_id": 2053 0x0805

FieldJSON Key nameValue TypeValue Type in JSON
应答流水号seqwordinteger
结果resultbyteinteger
多媒体 ID 个数lengthwordinteger
多媒体 ID 列表idsbyte(4*length)integer

存储多媒体数据检索 "msg_id": 34818 0x8802

FieldJSON Key nameValue TypeValue Type in JSON
多媒体类型byte
通道 IDbyte
事件项编码byte
起始时间string
结束时间string

存储多媒体数据检索应答 "msg_id": 2050 0x0802

FieldJSON Key nameValue TypeValue Type in JSON
应答流水号seqwordinteger
多媒体数据项总数lengthwordinteger
检索项resultlistlist of search result
多媒体 IDiddwordinteger
多媒体类型typebyteinteger
通道 IDchannelbyteinteger
事件项编码eventbyteinteger
位置信息汇报locationbyte(28)map

存储多媒体数据上传命令 "msg_id": 34819 0x8803

FieldJSON Key nameValue TypeValue Type in JSON
多媒体类型typebyteinteger
通道 IDchannelbyteinteger
事件项编码eventbyteinteger
起始时间start_timestringstring
结束时间end_timestringstring
删除标志deletebyteinteger

录音开始命令 "msg_id": 34820 0x8804

FieldJSON Key nameValue TypeValue Type in JSON
录音命令commandbyteinteger
录音时间timewordinteger
保存标志savebyteinteger
音频采样率ratebyteinteger

单条存储多媒体j叔叔检索上传命令 "msg_id": 34821 0x8805

FieldJSON Key nameValue TypeValue Type in JSON
多媒体 IDiddwordinteger
删除标志flagbyteinteger

数据下行透传 "msg_id": 35072 0x8900

FieldJSON Key nameValue TypeValue Type in JSON
透传消息类型typebyteinteger
透传消息内容databinarystring(base64 encoded)

数据上行透传 "msg_id": 2304 0x0900

FieldJSON Key nameValue TypeValue Type in JSON
透传消息类型typebyteinteger
透传消息内容databinarystring(base64 encoded)

数据压缩上报 "msg_id": 2305 0x0901

FieldJSON Key nameValue TypeValue Type in JSON
压缩消息长度lengthdwordinteger
压缩消息体databinarystring(base64 encoded)

平台 RSA 公钥 "msg_id": 35328 0x8A00

FieldJSON Key nameValue TypeValue Type in JSON
eedwordinteger
nnbyte(128)string(base64 encoded)

终端 RSA 公钥 "msg_id": 2560 0x0A00

FieldJSON Key nameValue TypeValue Type in JSON
eedwordinteger
nnbyte(128)string(base64 encoded)

保留 0x8F00 ~ 0x8FFF

保留 0x0F00 ~ 0x0FFF