乐高易车联网数据交换中间件服务端(上级平台)使用手册
广西乐高易网络有限公司
www.legaoyi.com
修订日期:2024年2月20日
目录
乐高易软件 乐高易车联网数据交换中间件 技术支持:78772895QQ
1.引用标准
JT/T809-2011 《道路运输车辆卫星定位系统平台数据交换》
JT/T1078-2016《道路运输车辆卫星定位系统车载视频通信协议》
《道路运输车辆主动安全智能防控系统 第 3 部分:通讯协议规范》
2.系统架构
参考《乐高易车联网数据交换中间件服务端(上级平台)使用手册(JT809-2011)》文档对应章节。
3.消息定义
3.1数据交换方式
参考《乐高易车联网数据交换中间件服务端(上级平台)使用手册(JT809-2011)》文档对应章节。
3.2数据交换队列
参考《乐高易车联网数据交换中间件服务端(上级平台)使用手册(JT809-2011)》文档对应章节。
3.3数据交换消息类型
参考《乐高易车联网数据交换中间件服务端(上级平台)使用手册(JT809-2011)》文档对应章节。
3.4主动上传车辆主动安全智能防控终端安装信息消息1240
消息概述
(1) 消息名称:主动上传车辆主动安全智能防控终端安装信息消息
(2) 链路类型:主链路
(3) 消息Id:0x1240
乐高易软件 乐高易车联网数据交换中间件 技术支持:78772895QQ
(4) 消息描述主动安全智能防控平台收到车辆安全智能防控终端安装信息,并确认符合要求后, 向上级平台上传该车辆安全智能防控终端安装信息。
(5) 消息方向:下级平台->协议网关(中间件)->上级平台
(6) 业务逻辑:上级平台接收到该消息之后根据业务需求处理该消息。
消息体定义
字段名
类型
描述
vehicleNo
String
车牌号
vehicleColor
int
车牌颜色
dataType
String
子业务标识
platformId
String
车辆所属运营商平台唯一编码(部平台过检编号)
producer
String
设备厂商名称
terminalModel
String
设备型号
terminalId
String
设备编号
installTime
Long
安装时间戳
installCompany
String
安装单位
contacts
String
联系人
telephone
String
联系电话
complianceRequirements
Int
是否符合要求,0:否,1:是
消息示例
{ "exchangeId":"0", "messageId":"1000", "gatewayId":"elink-iov-exchange-server", "message":{ "messageHeader":{ "gnssCenterId":9616320, "protocol":"jt809_201", "protocolVersion":"tjsatl_2017", "messageId":"1200" }, "messageBody":{ "vehicleNo":"A00001", "vehicleColor":1, "dataType":"1240", "platformId":"30000000", "producer":"legaoyi", "terminalModel":"lgy_jt808", "terminalId":"123456", "installTime":1705400000000, "installCompany":"乐高易", "contacts":"高先生", "telephone":"13609616322", "complianceRequirements":1
乐高易软件 乐高易车联网数据交换中间件 技术支持:78772895QQ
} }}
3.5主动上报报警信息消息1402
消息概述
(1) 消息名称:主动上报报警信息消息
(2) 链路类型:主链路
(3) 消息Id:0x1402
(4) 消息描述:下级平台主动向上级平台上报某车辆上传的报警信息。
(5) 消息方向:下级平台->协议网关(中间件)->上级平台
(6) 业务逻辑:上级平台接收该消息后,根据业务需求处理该消息,可往下级平台发送“9404消息(主动安全报警附件目录请求消息)”获取告警附件信息。
消息体定义
字段名
类型
描述
vehicleNo
String
车牌号
vehicleColor
int
车牌颜色
dataType
String
子业务类型标识
warnSrc
int
报警信息来源:
0x01:车载终端
0x02:企业监控平台
0x03:政府监控平台
0x09:其他
warnType
Stirng
报警类型,详见5.3.2 报警类型编码表
warnTime
Stirng
报警时间
infoId
Stirng
报警信息ID
driver
Stirng
驾驶员姓名
driverNo
Stirng
驾驶员驾照号码
level
int
报警级别
lng
Double
经度
lat
Double
纬度
altitude
int
海拔高度,单位为米(m)
speed
int
行车速度,单位为千米每小时(km/h)
dvrSpeed
Long
行驶记录速度,单位为千米每小时(km/h)
state
int
报警状态,1:报警开始;2:报警结束
direction
int
方向,0-359,正北为 0,顺时针
infoContent
Stirng
上报报警信息内容
消息示例
乐高易软件 乐高易车联网数据交换中间件 技术支持:78772895QQ
{ "exchangeId":"4", "messageId":"1000", "message":{ "messageHeader":{ "gnssCenterId":9616320, "protocol":"jt809_201", "protocolVersion":"tjsatl_2017", "messageId":"1400" }, "messageBody":{ "vehicleNo":"A00001", "vehicleColor":1, "dataType":"1402", "direction":89, "driver":"", "driverNo":"", "dvrSpeed":36, "infoContent":"生理疲劳驾驶预警", "infoId":"0013959215867240111154632000400", "lat":23.213177, "level":2, "lng":113.0471, "speed":36, "state":2, "warnSrc":1, "warnTime":1704959192000, "warnType":"0106" } }}
3.6主动上报报警处理消息1403
消息概述
(1) 消息名称:主动上报报警处理消息
(2) 链路类型:主链路
(3) 消息Id:0x1403
(4) 消息描述:下级平台向主动向上级平台上报报警处理结果
(5) 消息方向:下级平台->协议网关(中间件)->上级平台
(6) 业务逻辑:上级平台接收该消息后,根据业务需求处理该消息。
乐高易软件 乐高易车联网数据交换中间件 技术支持:78772895QQ
消息体定义
字段名
类型
描述
vehicleNo
String
车牌号
vehicleColor
int
车牌颜色
dataType
String
子业务类型标识
infoId
String
报警信息ID
result
int
报警处理结果定义:
0x00:处理中
0x01:已处理完毕
method
int
报警处理方式:
0x00:快速拍照
0x01:语音下发
0x02:不做处理
0x03:其他。
operator
String
报警处理人姓名
company
String
报警处理人所属公司名称
消息示例
{ "exchangeId":"4", "messageId":"9000", "message":{ "messageHeader":{ "gnssCenterId":9616320, "protocol":"jt809_201", "protocolVersion":"tjsatl_2017", "messageId":"1400" }, "messageBody":{ "vehicleNo":"A00001", "vehicleColor":1, "dataType":"1403", "result":1, "infoId":"123456789000000", "method":1, "operator":"高先生", "company":"乐高易" } }}
乐高易软件 乐高易车联网数据交换中间件 技术支持:78772895QQ
3.7主动安全报警附件目录请求消息9404
消息概述
(1) 消息名称:主动安全报警附件目录请求消息
(2) 链路类型:从链路
(3) 消息Id:0x9404
(4) 消息描述:上级平台向下级平台发送主动安全报警附件目录请求业务。
(5) 消息方向:上级平台->协议网关(中间件)->下级平台
(6) 业务逻辑:上级平台需要获取主动安全告警附件信息时向下级平台发送该指令。
消息体定义
字段名
类型
描述
vehicleNo
String
车牌号
vehicleColor
int
车牌颜色
dataType
String
子业务类型标识
infoId
String
报警信息ID
消息示例
{ "exchangeId":"4", "messageId":"9000", "message":{ "messageHeader":{ "gnssCenterId":9616320, "messageId":"9400" }, "messageBody":{ "vehicleNo":"A00001", "vehicleColor":1, "dataType":"9404", "infoId":"12345678900000000" } }}
3.8主动安全报警附件目录请求应答1404
消息概述
(1) 消息名称:主动安全报警附件目录请求应答
乐高易软件 乐高易车联网数据交换中间件 技术支持:78772895QQ
(2) 链路类型:主链路
(3) 消息Id:0x1404
(4) 消息描述下级平台向上级平台发送主动安全报警附件目录请求应答业务,上级平台可通过 报警附件文件 URL FTP 协议自行下载报警附件文件。
(5) 消息方向:下级平台->协议网关(中间件)->上级平台
(6) 业务逻辑下级平台应答上级平台发送的“9404消息”,上级平台接接收到该消息之后根据业务需求存储。
消息体定义
字段名
类型
描述
vehicleNo
String
车牌号
vehicleColor
int
车牌颜色
dataType
String
子业务类型标识
infoId
String
报警信息ID
server
String
附件服务器IP或域名
port
String
附件服务器FTP协议端口号
userName
String
附件服务器用户名
password
String
附件服务武器密码
fileList
List
附件附件列表
fileList.fileName
String
文件名称
fileList.fileType
long
文件类型:
0x00:图片
0x01:音频
0x02:视频
0x03:记录文件
0x04:其它
fileList.fileSize
long
当前报警附件的大小
fileList. fileUrl
String
当前报警附件的完整URL地址
消息示例
{ "exchangeId":"0", "messageId":"1000", "gatewayId":"elink-iov-exchange-client", "message":{ "messageHeader":{ "gnssCenterId":9616320, "messageId":"1400" }, "messageBody":{ "vehicleNo":"A00001", "vehicleColor":1,
乐高易软件 乐高易车联网数据交换中间件 技术支持:78772895QQ
"dataType":"1404", "infoId":"123456789", "server":"127.0.0.1", "port":22, "userName":"legaoyi", "password":"123456", "fileList":[ { "fileName":"test.mp4", "fileType":2, "fileSize":1200, "fileUrl":"test/test.mp4" } ] } }}
3.9报警信息核查请求消息9405
消息概述
(1) 消息名称:报警信息核查请求消息
(2) 链路类型:从链路
(3) 消息Id:0x9405
(4) 消息描述:上级平台向下级平台发送主动安全报警核查请求业务。
(5) 消息方向:上级平台->协议网关(中间件)->下级平台
(6) 业务逻辑:上级平台根据业务需求发送对主动安全告警进行核查。
消息体定义
字段名
类型
描述
vehicleNo
String
车牌号
vehicleColor
int
车牌颜色
dataType
String
子业务类型标识,9405
warnType
String
报警类型,详见5.3.2 报警类型编码表
warnTime
Long
报警时间戳
消息示例
{
乐高易软件 乐高易车联网数据交换中间件 技术支持:78772895QQ
"exchangeId":"15", "messageId":"9000", "message":{ "messageHeader":{ "gnssCenterId":9616320, "messageId":"9400" }, "messageBody":{ "vehicleNo":"A00001", "vehicleColor":1, "dataType":"9405", "warnType":"0001", "warnTime":1705461675897 } }}
3.10报警信息核查请求应答1405
消息概述
(1) 消息名称:报警信息核查请求应答
(2) 链路类型:主链路
(3) 消息Id:0x1405
(4) 消息描述:下级平台应答上级平台发送“9405”消息
(5) 消息方向:下级平台->协议网关(中间件)->上级平台
(6) 业务逻辑:下级平台向上级平台响应上报某车辆上传的报警信息。
消息体定义
字段名
类型
描述
vehicleNo
String
车牌号
vehicleColor
int
车牌颜色
dataType
String
子业务类型标识
warnSrc
int
报警信息来源:
0x01:车载终端
0x02:企业监控平台
0x03:政府监控平台
0x09:其他
warnType
Stirng
报警类型,详见5.3.2 报警类型编码表
warnTime
Stirng
报警时间
infoId
Stirng
报警信息ID
driver
Stirng
驾驶员姓名
乐高易软件 乐高易车联网数据交换中间件 技术支持:78772895QQ
driverNo
Stirng
驾驶员驾照号码
level
int
报警级别
lng
Double
经度
lat
Double
纬度
altitude
int
海拔高度,单位为米(m)
speed
int
行车速度,单位为千米每小时(km/h)
dvrSpeed
Long
行驶记录速度,单位为千米每小时(km/h)
state
int
报警状态,1:报警开始;2:报警结束
direction
int
方向,0-359,正北为 0,顺时针
infoContent
Stirng
上报报警信息内容
消息示例
{ "exchangeId":"4", "messageId":"1000", "message":{ "messageHeader":{ "gnssCenterId":9616320, "protocol":"jt809_201", "protocolVersion":"tjsatl_2017", "messageId":"1400" }, "messageBody":{ "vehicleNo":"A00001", "vehicleColor":1, "dataType":"1405", "direction":89, "driver":"", "driverNo":"", "dvrSpeed":36, "infoContent":"生理疲劳驾驶预警", "infoId":"0013959215867240111154632000400", "lat":23.213177, "level":2, "lng":113.0471, "speed":36, "state":2, "warnSrc":1, "warnTime":1704959192000, "warnType":"0106" } }}
乐高易软件 乐高易车联网数据交换中间件 技术支持:78772895QQ
3.11报警统计核查请求消息9406
消息概述
(1) 消息名称:报警统计核查请求消息
(2) 链路类型:从链路
(3) 消息Id:0x9406
(4) 消息描述:上级平台向下级平台发送主动安全报警统计核查请求业务。
(5) 消息方向:上级平台->协议网关(中间件)->下级平台
(6) 业务逻辑上级平台需要对接主动安全报警进行统计核查时,向下级平台发送该消息。
消息体定义
字段名
类型
描述
vehicleNo
String
车牌号
vehicleColor
int
车牌颜色
dataType
String
子业务类型标识,9A01
startTime
long
统计开始时间戳
endTime
long
统计结束时间戳
消息示例
{ "exchangeId":"15", "messageId":"9000", "message":{ "messageHeader":{ "gnssCenterId":9616320, "messageId":"9400" }, "messageBody":{ "vehicleNo":"A00001", "vehicleColor":1, "dataType":"9406", "startTime":1705400000000, "endTime":1705461670000 } }}
乐高易软件 乐高易车联网数据交换中间件 技术支持:78772895QQ
3.12报警统计核查请求应答1406
消息概述
(1) 消息名称:报警统计核查请求应答
(2) 链路类型:主链路
(3) 消息Id:0x1406
(4) 消息描述: 下级平台应答上级平台发送的“9406”消息
(5) 消息方向:下级平台->协议网关(中间件)->上级平台
(6) 业务逻辑: 下级平台向上级平台响应上报主动安全报警统计核查请求业务
消息体定义
字段名
类型
描述
vehicleNo
String
车牌号
vehicleColor
int
车牌颜色
dataType
String
子业务类型标识
list
List
报警统计列表
list.warnType
String
报警类型,详见常量定义中的报警类型
list.statics
Int
报警数量
消息示例
{ "exchangeId":"4", "messageId":"1000", "message":{ "messageHeader":{ "gnssCenterId":9616320, "protocol":"jt809_201", "protocolVersion":"tjsatl_2017", "messageId":"1400" }, "messageBody":{ "vehicleNo":"A00001", "vehicleColor":1, "dataType":"1406", "list":[ { "warnType":"0001", "statics":1 } ] } }
乐高易软件 乐高易车联网数据交换中间件 技术支持:78772895QQ
}
4.二次开发
参考《乐高易车联网数据交换中间件服务端(上级平台)使用手册(JT809-2011)》档对应章节。