JT808协议接入-华为云

设备接入 IOTDA-应用侧对接:文本信息下发接口说明

文本信息下发接口说明请求对应的消息ID：0x8300 响应对应的消息ID：0x0001（终端通用响应）请求示例 { "command_name": "SendTextMessage", "service_id": "Message", "paras": { "flag": 2, "lcdflag": true, "ttsflag": true, "text": "hello", "textType": 1 } } 请求参数 paras字段同协议中消息的映射关系表38 参数描述属性名协议字段类型参数描述 flag 文本信息标志 int 1：服务 2：紧急 3：通知 lcdflag 终端显示标志 boolean 为true时终端显示器显示 ttsflag 终端播读标志 boolean 为true时终端 TTS 播读 textType 文本类型 int 1：通知 2：服务 text 文本信息 string 最长1024字节响应示例 { "command_id": "1641969363120826882", "response": { "paras": { "flowNo": 0, "msgId": 33027, "resultCode": 0 }, "result_code": 0 } } 响应参数（终端通用响应） paras字段定义表39 参数描述字段名类型参数描述 flowNo int 应答流水号 msgId int 对应的平台的消息ID resultCode int 结果

设备接入 IOTDA JT808协议接入

设备接入 IOTDA-应用侧对接:历史视频上传

历史视频上传接口说明请求对应的消息ID：0x9206 响应对应的消息ID：0x0001（终端通用响应）请求示例 { "command_name": "Upload", "service_id": "VideoResource", "paras": { "serverIp": "***.***.***.***", "port": 10020, "username": "******", "password": "******", "path": "20220307", "channelNo": 1, "startTime": "220307153900", "endTime": "220307154000", "warningMark":0, "warningMarkHigh":0, "mediaType": 0, "streamType": 1, "memoryType": 1, "condition": 7 } } 请求参数 paras字段同协议中消息的映射关系表36 参数描述字段名类型协议字段参数描述 serverIp string 服务器地址 FTP服务器地址 port int 服务器端口 FTP服务器端口 username string 用户名 FTP服务器用户名 password string 密码 FTP服务器密码 path string 文件上传路径 FTP服务器文件上传路径 channelNo int 逻辑通道号标识所有通道 startTime string 开始时间 YYMMDDHHMMSS格式的起始时间 endTime string 结束时间 YYMMDDHHMMSS格式的结束时间 warningMark int 告警标志告警标志位定义 warningMarkHigh int 高位告警标志高位告警标志位定义 mediaType int 音视频资源类型 0：音视频，1：音频，2：视频3：视频或者音视频 streamType int 码流类型 0：所有码流1：主码流2：子码流 memoryType int 存储器类型 0：所有存储器，1：主存储器，2：灾备存储器 condition int 任务执cccc行条件gfdsgjfds Bit0：WIFI，为1时表示WI-FI下可下载； Bit1：LAN，为1时表示LAN连接时可下载； Bit2:3G/4G, 为1时表示3G/4G连接时可下载。响应示例 { "command_id": "1641969363120826882", "response": { "paras": { "flowNo": 0, "msgId": 33027, "resultCode": 0 }, "result_code": 0 } } 响应参数（终端通用响应） paras字段定义表37 参数描述字段名类型参数描述 flowNo int 应答流水号 msgId int 对应的平台的消息ID resultCode int 结果

设备接入 IOTDA JT808协议接入

设备接入 IOTDA-应用侧对接:车辆管理-删除多边形区域电子围栏

车辆管理-删除多边形区域电子围栏接口说明请求对应的消息ID：0x8605 响应对应的消息ID：0x0001（终端通用响应）请求示例 { "service_id": "VehicleManagement", "command_name": "RemovePolygonArea", "paras": { "areaIds": [ 1 ] } } 请求参数 paras字段同协议中消息的映射关系表28 参数描述字段名类型协议字段参数描述 areaIds stringList 区域ID列表 / 响应示例 { "command_id": "1641969363120826882", "response": { "paras": { "flowNo": 0, "msgId": 33027, "resultCode": 0 }, "result_code": 0 } } 响应参数（终端通用响应） paras字段定义表29 参数描述字段名类型参数描述 flowNo int 应答流水号 msgId int 对应的平台的消息ID resultCode int 结果

设备接入 IOTDA JT808协议接入

设备接入 IOTDA-应用侧对接:实时音视频-实时音视频传输请求

实时音视频 -实时音视频传输请求接口说明请求对应的消息ID：0x9101 响应对应的消息ID：0x0001（终端通用响应）请求示例 { "command_name": "VideoLiveRequest", "service_id": "VideoLive", "paras": { "serverIp": "***.***.***.***", "port": 8557, "channelNo": 1, "dataType": 0, "streamType": 0 } } 请求参数 paras字段同协议中消息的映射关系表30 参数描述字段名类型协议字段参数描述 serverIp string 服务器地址视频服务器地址 port int 服务器端口视频服务器端口 channelNo int 逻辑通道号逻辑通道号 dataType int 音视频资源类型 0：音视频， 1：视频 2：双向对讲 3：监听 4：中心广播 5：透传 streamType int 码流类型 0：主码流1：子码流响应示例 { "command_id": "1641969363120826882", "response": { "paras": { "flowNo": 0, "msgId": 33027, "resultCode": 0 }, "result_code": 0 } } 响应参数（终端通用响应） paras字段定义表31 参数描述字段名类型参数描述 flowNo int 应答流水号 msgId int 对应的平台的消息ID resultCode int 结果

设备接入 IOTDA JT808协议接入

设备接入 IOTDA-应用侧对接:实时音视频-音视频实时传输控制

实时音视频-音视频实时传输控制接口说明请求对应的消息ID：0x9102 响应对应的消息ID：0x0001（终端通用响应）请求示例 { "command_name": "VideoLiveControl", "service_id": "VideoLive", "paras": { "channelNo": 1, "commandId": 0, "mediaType": 0, "streamType": 1 } } 请求参数 paras字段同协议中消息的映射关系表32 参数描述字段名类型协议字段参数描述 channelNo int 逻辑通道号逻辑通道号 commandId int 控制指令平台可以通过该指令对设备的实时音视频传输进行控制： 0：关闭音视频传输指令。 1：切换码流 2：暂停该通道所有流的发送 3：恢复暂停前流的发送 4：关闭所向对讲 mediaType int 关闭音视频资源类型 0：关闭该通道有关的音视频数据 1：只关闭该通道有关的音频，保留该通道有关的视频。 2：只关闭该通道有关的视频，保留该通道有关的音频。 streamType int 码流类型将之前申请的码流切换为新申请的码流，音频与切换前保持一致。新申请的码流为： 0：主码流 1：子码流响应示例 { "command_id": "1641969363120826882", "response": { "paras": { "flowNo": 0, "msgId": 33027, "resultCode": 0 }, "result_code": 0 } }

设备接入 IOTDA JT808协议接入

设备接入 IOTDA-应用侧对接:实时音视频-查询视频资源列表

实时音视频-查询视频资源列表接口说明请求对应的消息ID：0x9205 响应对应的消息ID：0x1205 请求示例 { "command_name": "GetVideoResource", "service_id": "VideoResource", "paras": { "channelNo": 0, "startTime": "220314093900", "endTime": "220314174000", "warningMark":0, "warningMarkHigh":0, "mediaType": 0, "streamType": 0, "memoryType": 0 } } 请求参数 paras字段同协议中消息的映射关系表33 参数描述字段名类型协议字段参数描述 channelNo int 逻辑通道号 0标识所有通道 startTime string 开始时间 YYMMDDHHMMSS，全0表示无起始时间 endTime string 结束时间 YYMMDDHHMMSS，全0表示无结束时间 warningMark int 告警标志告警标志位定义，全0表示物报警类型条件 warningMarkHigh int 高位告警标志高位告警标志位定义，全0表示物报警类型条件 mediaType int 音视频资源类型 0：音视频，1：音频，2：视频3：视频或者音视频 streamType int 码流类型 0：所有码流1：主码流2：子码流 memoryType int 存储器类型 0：所有存储器，1：主存储器，2：灾备存储器响应示例 { "command_id": "c4eafd52-7411-483d-901c-858a2b7bc2a7", "response": { "paras": { "flowNo": 0, "count": 1, "items": [ { "channelNo": 1, "startTime": "200101000000", "endTime": "201231235959", "warningMark": 0, "warningMarkHigh": 0, "mediaType": 1, "streamType": 1, "memoryType": 1, "size": 1024 } ] }, "response_name": null, "result_code": 0 } } 响应参数 paras字段定义表34 参数描述字段名类型参数描述 flowNo int 应答流水号 count int 录像文件数量 items jsonObject 录像列表录像文件说明表35 参数描述字段名类型协议字段参数描述 channelNo int 逻辑通道号 0标识所有通道 startTime tring 开始时间 YYMMDDHHMMSS格式的视频开始时间 endTime string 结束时间 YYMMDDHHMMSS 式的视频结束时间 warningMark int 告警标志告警标志位定义 warningMarkHigh int 高位告警标志高位告警标志位定义 mediaType int 音视频资源类型 0：音视频，1：音频，2：视频3：视频或者音视频 streamType int 码流类型 0：所有码流1：主码流2：子码流 memoryType int 存储器类型 0：所有存储器，1：主存储器，2：灾备存储器

设备接入 IOTDA JT808协议接入

设备接入 IOTDA-应用侧对接:车辆管理-设置多边形区域电子围栏

车辆管理-设置多边形区域电子围栏接口说明请求对应的消息ID：0x8604 响应对应的消息ID：0x0001（终端通用响应）请求示例 { "service_id": "VehicleManagement" "command_name": "SetPolygonArea", "paras": { "areaId": 1, "areaProperty": 1, "startTime": "211119170110", "endTime": "211119170111", "maxSpeed": 0, "durationOverSpeed": 0, "vertices": [ { "latitude": 0, "longitude": 1 } ], "maxNightSpeed": 0, "areaName": "test" } } 请求参数 paras字段同协议中消息的映射关系表25 参数描述字段名类型协议字段参数描述 areaId int 区域ID 区域ID areaProperty int 区域属性区域属性 startTime string 起始时间格式为YYMMDDHHMMSS endTime string 结束时间格式为YYMMDDHHMMSS vertices jsonObject 区域定点多边形区域定点信息 maxSpeed int 最高速度单位为千米每小时（km/h） durationOverSpeed int 超速持续时间单位为秒（s） maxNightSpeed int 夜间最高速度单位为千米每小时（km/h） areaName string 区域名称区域的名称描述 vertice字段同协议中消息的映射关系表26 参数描述字段名类型协议字段参数描述 latitude int 中心点纬度以度为单位的纬度值乘以10的6次方，精确到百万分之一。 longitude int 中心点经度以度为单位的经度值乘以10的6次方，精确到百万分之一。响应示例 { "command_id": "1641969363120826882", "response": { "paras": { "flowNo": 0, "msgId": 33027, "resultCode": 0 }, "result_code": 0 } } 响应参数（终端通用响应） paras字段定义表27 参数描述字段名类型参数描述 flowNo int 应答流水号 msgId int 对应的平台的消息ID resultCode int 结果

设备接入 IOTDA JT808协议接入

设备接入 IOTDA-应用侧对接:车辆管理-删除圆形区域电子围栏

车辆管理-删除圆形区域电子围栏接口说明请求对应的消息ID：0x8601 响应对应的消息ID：0x0001（终端通用响应）请求示例 { "service_id": "VehicleManagement", "command_name": "RemoveRoundArea", "paras": { "areaIds": [ 1 ] } } 请求参数 paras字段同协议中消息的映射关系表23 参数描述字段名类型协议字段参数描述 areaIds stringList 区域ID列表 / 响应示例 { "command_id": "1641969363120826882", "response": { "paras": { "flowNo": 0, "msgId": 33027, "resultCode": 0 }, "result_code": 0 } } 响应参数（终端通用响应） paras字段定义表24 参数描述字段名类型参数描述 flowNo int 应答流水号 msgId int 对应的平台的消息ID resultCode int 结果

设备接入 IOTDA JT808协议接入

设备接入 IOTDA-应用侧对接:位置及报警-临时位置跟踪控制

位置及报警-临时位置跟踪控制接口说明请求对应的消息ID：0x8202 响应对应的消息ID：0x0001（终端通用响应）请求示例 { "service_id": "Location", "command_name": "LocationTrace", "paras": { "timeInterval": 10, "period": 20 } } 请求参数 paras字段定义表14 参数描述字段名必选/可选类型参数描述 timeInterval 必选 int 时间间隔，单位为秒（s） period 必选 int 位置跟踪有效期，单位为秒（s）响应示例 { "command_id": "1641971752394383473", "response": { "paras": { "flowNo": 0, "msgId": 33282, "resultCode": 0 }, "result_code": 0 } } 响应参数 paras字段定义表15 参数描述字段名类型参数描述 flowNo int 应答流水号 msgId int 对应的平台的消息ID resultCode int 结果

设备接入 IOTDA JT808协议接入

设备接入 IOTDA-应用侧对接:位置及报警-人工确认报警信息

位置及报警-人工确认报警信息接口说明对应的消息ID：0x8203 请求示例 { "service_id": "Location", "command_name": "AlarmConform", "paras": { "flowNo": 123, "criticalAlarm": false, "dangerousWarning": false, "areaAlarm": true, "routeAlarm": false, "drivingTimeAlarm": false, "startingAbnormalAlarm": false, "displacementAbnormalAlarm": false } } 请求参数 paras字段定义表16 参数描述字段名必选/可选类型参数描述 flowNo 必选 int 报警消息流水号 criticalAlarm 必选 boolean 确认紧急报警 dangerousWarning 必选 boolean 确认危险预警 areaAlarm 必选 boolean 确认进出区域报警 routeAlarm 必选 boolean 确认进出路线报警 drivingTimeAlarm 必选 boolean 确认路段行驶时间不足/过长报警 startingAbnormalAlarm 必选 boolean 确认车辆非法点火报警 displacementAbnormalAlarm 必选 boolean 确认车辆非法位移报警响应示例 { "command_id": "1641971845905632317", "response": { "paras": { "flowNo": 0, "msgId": 33283, "resultCode": 0 }, "result_code": 0 } } 响应参数 paras字段定义表17 参数描述字段名类型参数描述 flowNo int 应答流水号 msgId int 对应的平台的消息ID resultCode int 结果

设备接入 IOTDA JT808协议接入

设备接入 IOTDA-应用侧对接:位置及报警-链路检测

位置及报警-链路检测接口说明请求对应的消息ID：0x8204 响应对应的消息ID：0x0001（终端通用响应）请求示例 { "service_id": "Location", "command_name": "CheckConnection", "paras": {} } 响应示例 { "command_id": "1641971911322353065", "response": { "paras": { "flowNo": 0, "msgId": 33284, "resultCode": 0 }, "result_code": 0 } } 响应参数 paras字段定义表18 参数描述字段名类型参数描述 flowNo int 应答流水号 msgId int 对应的平台的消息ID resultCode int 结果

设备接入 IOTDA JT808协议接入

设备接入 IOTDA-应用侧对接:车辆管理-设置圆形区域电子围栏

车辆管理-设置圆形区域电子围栏接口说明请求对应的消息ID：0x8600 响应对应的消息ID：0x0001（终端通用响应） { "service_id": "VehicleManagement", "command_name": "SetRoundArea", "paras": { "type": 1, "areas": [{ "areaId": 1, "areaProperty": 1, "latitude": 0, "longitude": 0, "radius": 0, "startTime": "211119170110", "endTime": "211119170111", "maxSpeed": 0, "durationOverSpeed": 0, "maxNightSpeed": 0, "areaName": "test" }] } } 请求参数 paras字段同协议中消息的映射关系表19 参数描述字段名类型协议字段参数描述 type int 设置属性 0：更新区域 1：追加区域 2：修改区域 areas jsonObject 区域圆形区域列表 Area字段说明表20 参数描述字段名类型协议字段参数描述 areaId int 区域ID 区域ID areaProperty int 区域属性区域属性 latitude int 中心点纬度以度为单位的纬度值乘以10的6次方，精确到百万分之一。 longitude int 中心点经度以度为单位的经度值乘以10的6次方，精确到百万分之一。 radius int 半径单位为米 startTime string 起始时间格式为YYMMDDHHMMSS endTime string 结束时间格式为YYMMDDHHMMSS maxSpeed int 最高速度单位为千米每小时（km/h） durationOverSpeed int 超速持续时间单位为秒（s） maxNightSpeed int 夜间最高速度单位为千米每小时（km/h） areaName string 区域名称区域的名称描述区域属性说明表21 属性说明位标志 0 是否开启起始时间与结束时间的判断规则，0:否；1:是 1 是否启用最高速度，超速持续时间和夜将最高速度的判断规则，0：否；1：是 2 进区域是否报警给驾驶员，0:1；1：是 3 进区域是否报警给平台，0:1；1：是 4 出区域是否告警给驾驶员，0：否；1：是 5 出区域是否告警给平台，0：否；1：是 6 0：北纬；1：南纬 7 0：东经；1：西经 8 0：允许开门；1：禁止开门 9-13 保留 14 0：进区域开启通信模块；1：进区域关闭通信模块 15 0：进区域不采集GNSS详细定位数据；1：进区域采集GNSS详细定位数据响应示例 { "command_id": "1641971911322353065", "response": { "paras": { "flowNo": 0, "msgId": 33284, "resultCode": 0 }, "result_code": 0 } } 响应参数（终端通用响应） paras字段定义表22 参数描述字段名类型参数描述 flowNo int 应答流水号 msgId int 对应的平台的消息ID resultCode int 结果

设备接入 IOTDA JT808协议接入

设备接入 IOTDA-应用侧对接:终端管理-终端控制

终端管理-终端控制接口说明请求对应的消息ID：0x8105 响应对应的消息ID：0x0001（终端通用响应）请求示例 { "service_id": "TerminalManagement", "command_name": "TerminalControl", "paras": { "commandId": 4, "parameter": null } } 请求参数 paras字段定义表9 参数描述字段名必选/可选类型参数描述 commandId 必选 int 命令字（十进制表示） parameter 可选 string 命令参数响应示例 { "command_id": "1641970324270870620", "response": { "paras": { "flowNo": 0, "msgId": 33029, "resultCode": 0 }, "result_code": 0 } } 响应参数（终端通用响应） paras字段定义表10 参数描述字段名类型参数描述 flowNo int 应答流水号 msgId int 对应的平台的消息ID resultCode int 结果

设备接入 IOTDA JT808协议接入

设备接入 IOTDA-应用侧对接:位置及报警-位置信息查询

位置及报警-位置信息查询接口说明请求对应的消息ID：0x8201 响应对应的消息ID：0x0201 请求示例 { "service_id": "Location", "command_name": "QueryLocation", "paras": {} } 响应示例 { "command_id": "1641971430850245415", "response": { "paras": { "flowNo": 0, "locationReport": { "alarm": { "emergencyAlarm": 0, "overSpeedAlarm": 1, "fatigueDrivingAlarm": 0, "dangerousDrivingAlarm": 1, "powerVoltageAlarm": 0, "powerOffAlarm": 0, "cameraErrorAlarm": 1, "overSpeedWarning": 1, "fatigueDrivingWarning": 0, "violationDrivingAlarm": 0, "tirePressureWarning": 0, "rightTurnErrorAlarm": 0, "overDrivingTimeAlarm": 0, "overParkAlarm": 0, "drivingAreaAlarm": 0, "drivingRouteAlarm": 0, "drivingTimeAbnormalAlarm": 0, "offCourseAlarm": 0, "gasolineAlarm": 0, "stolenAlarm": 0, "startingAbnormalAlarm": 0, "displacementAbnormalAlarm": 0, "rolloverAlarm": 0, "rolloverWarning": 0, "gnsserrorAlarm": 1, "gnssantennaNotConnectedAlarm": 0, "lcderrorAlarm": 1, "ttserrorAlarm": 0, "icerrorAlarm": 0, "vssalarm": 0, "gnssantennaShortCircuitAlarm": 1 }, "status": { "accStatus": 0, "positioningStatus": 0, "latitudeStatus": 0, "longitudeStatus": 1, "businessStatus": 0, "encryptedStatus": 1, "forwardCollisionWarningStatus": 0, "laneDeviationAlarmStatus": 0, "loadStatus": 0, "oilStatus": 1, "powerStatus": 0, "doorStatus": 1, "firstDoorStatus": 1, "secondDoorStatus": 1, "thirdDoorStatus": 0, "fourthDoorStatus": 0, "fifthDoorStatus": 0, "galileoStatus": 0, "vehicleStatus": 0, "gpsstatus": 0, "bdsstatus": 0, "glonassstatus": 0 }, "longitude": 0.041957, "latitude": 0.056143, "height": 48243, "speed": 10001, "direction": 300, "dateTime": "220112151406", "extend": [] } }, "result_code": 0 } } 响应参数表12 参数描述字段名类型参数描述 flowNo int 应答流水号 locationReport jsonObject 字段定义参考表2 表13 协议报文字段与属性对应表起始字节字段数据类型对应属性 0 报警标志 DWORD alarm 4 状态 DWORD status 8 纬度 DWORD longitude 12 经度 DWORD latitude 16 高程 WORD height 18 速度 WORD speed 20 方向 WORD direction 21 时间 BCD[6] dateTime

设备接入 IOTDA JT808协议接入

设备接入 IOTDA-应用侧对接:终端管理-查询终端属性

终端管理-查询终端属性接口说明请求对应的消息ID：0x8107 响应对应的消息ID：0x0107 请求示例 { "service_id": "TerminalManagement", "command_name": "QueryTerminalProperty", "paras": {} } 响应示例 { "command_id": "1641970411683486238", "response": { "paras": { "clientType": { "passenger": true, "dangerousGoods": true, "track": true, "taxis": true, "video": true, "splitter": false, "trailer": false }, "manufacturerId": "2D_AN", "deviceType": "BSJ-GF-06", "nodeId": "5kw3noL", "iccId": "12345678901234567890", "hardwareVersion": "3.0.0", "firmwareVersion": "1.1.25", "gssn": { "galileo": true, "gps": true, "bds": true, "glonass": true }, "communication": { "other": false, "gprs": true, "cdma": true, "tdscdma": true, "wcdma": true, "cdma2000": true, "tdlte": true } }, "result_code": 0 } } 响应参数 paras字段定义表11 参数描述字段名类型参数描述 clientType JsonObject 终端类型 passenger：false-不适用客运车辆，true-适用客运车辆 dangerousGoods：false-不适用危险品车辆，true-适用危险品车辆 track：false-不适用普通货运车辆，true-适用普通货运车辆 taxis：false-不适用出租车辆，true-适用出租车辆 video：false-不支持硬盘录像，true-支持硬盘录像 splitter：false-一体机，true-分体机 trailer：false-不适用挂车，true-适用挂车 manufacturerId string 制造商ID deviceType string 终端型号 nodeId string 终端ID iccId string 终端SIM卡ICCID hardwareVersion string 终端硬件版本号 firmwareVersion string 终端固件版本号 gssn jsonObject GNSS模块属性 galileo：false-不支持Galileo定位，true-支持Galileo定位 gps：false-不支持GPS定位，true-支持GPS定位 bds：false-不支持北斗定位，true-支持北斗定位 glonass：false-不支持GLONASS定位，true-支持GLONASS定位 communication jsonObject 通信模块属性 other：false-不支持其他通信方式，true-支持其他通信方式 gprs：false-不支持GPRS通信方式，true-支持GPRS通信方式 cdma：false-不支持 CDM A通信方式，true-支持CDMA通信方式 tdscdma：false-不支持TD-SCDMA通信方式，true-支持TD-SCDMA通信方式 wcdma：false-不支持WCDMA通信方式，true-支持WCDMA通信方式 cdma2000：false-不支持CDMA2000通信方式，true-支持CDMA2000通信方式 tdlte：false-不支持TD-LTE通信方式，true-支持TD-LTE通信方式

设备接入 IOTDA JT808协议接入

云服务器内容精选

JT808协议接入

7*24

备案

专业服务

退订

建议反馈

售前咨询热线