东莞市交通运输局重点监管车辆监控平台数据接口规范1012

东莞市交通运输局重点监管车辆监控平台数据接口协议V1.01东莞市交通运输局重点监管车辆监控平台数据接口协议接口协议：Socket通信方式A.1概述参照《DB44/T769—2010重点监管车辆监控平台数据接口规范》和《省道路运政信息系统卫星定位数据联网监管接口技术规范》，结合东莞市交通运输局实际需要，制定本协议。本协议规定了GPS营运商或运输企业监控平台(以下简称监控平台)与东莞市交通运输局市级接收基准平台(以下简称市级基准平台)之间以Socket通信方式进行数据交换的接口协议。A.2数据传输约定A.2.1通信约定通信协议采用TCP/IP协议，监控平台和市级接收基准平台之间保持在线连接。A.2.2登录登录是指监控平台向市级接收基准平台登录。监控平台登录时，向市级接收基准平台发送“登录请求”（LoginREQ），市级接收基准平台验证登录请求的OMC代码、IP地址、用户帐号、密码以及随机序列，确认合法性后，向监控平台返回“登录回应”（LoginRSP）。若登录成功，市级接收基准平台将接收并处理监控平台上报的数据，反之，将丢弃监控平台上报的数据，并强制断开与监控平台建立的连接。A.2.3链路检测链路检测是指监控平台与市级接收基准平台之间的网络链路检测。监控平台登录后，需每隔1分钟向市级接收基准平台发送“链路检测请求”（TestLinkREQ）；市级接收基准平台收到链路检测请求后，向监控平台回应“链路检测回应”（TestLinkRSP），告知监控平台链路正常。如果监控平台连续发送3个的链路检测请求都没收到回应，则可认为与市级接收基准平台连接中断，可尝试重新登录市级接收基准平台。A.2.4安全认证安全认证是为保障监控平台接入市级接收基准平台的合法性认证，具体流程如下。——市级接收基准平台为各监控平台分配用户帐号、密码。——监控平台与市级接收基准平台建立连接后，市级接收基准平台校验连接IP，对非法IP将强行断开，对合法IP连接产生一个随机序列（10字节字符串）发送给监控平台，监控平台将事先分配的帐号、密码与随机序列按先后顺序组合后进行MD5加密，并向市级接收基准平台发出“登录请求”，市级接收基准平台接收到登录请求后，验证用户帐号、密码和随机序列的正确性，如果不合法，则认证失败。——市级接收基准平台收到登录请求后，先验证IP地址，如果IP与约定的不一致，则认证失败。——市级接收基准平台对于建立链接后，对最近2分钟内未发送“登陆申请或递交链路检测请求”的监控平台强制断开链接处理。东莞市交通运输局重点监管车辆监控平台数据接口协议V1.02注：同一IP只允许一个连接成功。A.2.5数据编码对字符串数据采用GBK编码（兼容ASCII及GB2312编码）。对不定长数据字段，如果可能出现保留的分隔符，则需采用BASE64进行二次编码，防止和保留的分隔符产生歧义。数据长度按进行BASE64编码后的长度计算。数据协议中对需进行BASE64编码的字段特别注明。对固定长度字符串，不足部分后面补0x00。对多字节整数类型，高位在前，低位在后，不足部分前面补0x00。消息格式中“数据”字段前后为固定长度，分隔符仅作协议合法性校验。消息格式中“数据”字段中含有不定长字段，分隔符作字段识别作用，除特别注明外，必须确保不定长字段中不含分隔符。A.2.6数据协议框架A.2.6.1消息格式开始符数据长度功能关键字数据分隔符结束符分隔符企业监控平台代码分隔符图A.1消息格式定义其中数据长度是数据的总字节数。功能关键字：3字节，字符串，如“U01”；企业监控平台代码：即OMC代码，4字节，整数，如0x00000F01，表示十进制第3841号监控平台，由政府职能部门指定机构统一分配。数据长度：4字节，整数，数据长度不超过2048字节。A.2.6.2数据格式数据字段1数据分隔符数据字段2数据分隔符……数据字段n图A.2数据格式定义A.2.6.3协议字符开始符：“~”；结束符：“#”；分隔符：“&”；数据分隔符：“|”。A.2.6.4功能关键字功能关键字采用分类标识+2字节序号，如U01。表A.1功能关键字分类定义标识字符说明LLogin首字母，监控平台与市级接收基准平台之间的登录数据标识东莞市交通运输局重点监管车辆监控平台数据接口协议V1.03TTestLink首字母，监控平台与市级接收基准平台之间的链路检测数据标识UUpload首字母，监控平台向市级接收基准平台上传的数据标识DDownload首字母，监控平台下载市级接收基准平台下传的数据标识A.3登录流程连接流程市级接收基准平台监控平台发起连接对此连接产生一个随机字符串加密用户名+密码+随机字符串，发送登陆申请TCP/IP发送随机字符串TCP/IP验证用户名+密码+随机字符串组合是否正确，验证IP等是否合法登录回应代码登录回应完成连接，开始上传或下载数据登陆成功图A.3登录流程图注1：如登录不成功，则市级接收基准平台强制断开监控平台的TCP连接。连接断开后重连时，需要重新发起登录申请。A.4登录数据协议A.4.1登录随机序列表A.2登录随机序列说明表关键字L00数据字段1字段名称随机序列说明由市级接收基准平台随机产生的字符串序列长度固定长度10字节A.4.2登录请求表A.3登录请求协议说明表关键字L01数据字段1字段名称用户名说明由政府职能部门指定机构统一分配长度不定长东莞市交通运输局重点监管车辆监控平台数据接口协议V1.04数据字段2字段名称密码说明由政府职能部门指定机构统一分配，用户名＋密码＋随机序列字符串的MD5码,MD5码中字母部分约定为小写。长度固定长度32字节数据字段3字段名称随机序列说明来自市级接收基准平台随机产生的字符串序列长度固定长度10字节A.4.3登录回应市级接收基准平台收到监控平台发起登录申请后，进行下传和接受数据的准备工作，进行验证后向监控平台返回登录回应。表A.4登录回应协议说明表关键字L02数据字段1字段名称登录回应代码说明整数。长度固定长度4字节表A.5回应代码对应表序号回应值描述10x00000000成功20x00000001无效数据包30x00000002无效数据包类型40x00000003无效用户名50x00000004密码错误60x00000005申请拒绝，随机序列错70x00000006登录拒绝，IP错，运营商错A.5链路检测流程OMC服务器市级接收基准平台TestLink_REQTestLink_RSP图A.4链路检测通信流程示意图A.6链路检测申请由监控平台发起，每隔1分钟发送一次。表A.6链路检测申请协议说明表东莞市交通运输局重点监管车辆监控平台数据接口协议V1.05关键字T01数据字段无A.7链路检测回应由市级接收基准平台回应。表A.7链路检测回应协议说明表关键字T02数据字段无A.8上传数据协议A.8.1总则上传数据包的协议说明只是整个包的数据部分和关键字的描述，数据部分和关键字与开始符、结束符、分隔符、数据分隔符一起组成完整的传输数据包。基础编码约定：表1车辆用途编码序号车辆用途编码1省际班车0x012市际班车0x023县际班车（跨镇班车、城巴、小巴）0x034县内班车（镇内公汽）0x045省际包车0x056市际包车0x067县际包车0x078县内包车0x089危险货物运输0x0910出租的士（普通的士、蓝色公的）0x0a11公共的士（黄色公的）0x0b12普通货运(重型货车、汽车列车)0x0c13测试车辆0x0d14执法车0x0e15驾驶员教练车0x0f16校车0x1017散装物料车Ox11表2车牌颜色编码序号颜色编码1蓝0x01东莞市交通运输局重点监管车辆监控平台数据接口协议V1.062黄0x023白0x034黑0x04表3警告类型编码序号警告类型编码1超速0x002越界0x013疲劳驾驶0x024其它0x03A.8.2卫星定位数据包表A.8卫星定位数据包协议说明表关键字U01数据字段1字段名称车牌号说明完整合法的车牌号，符合GA36-2007《中华人民共和国机动车号牌》要求，不含分隔符长度不定长数据字段2字段名称车牌颜色说明整数。长度固定长度1字节。数据字段3字段名称基本卫星定位数据包说明与DB44/T578-2009相同。长度固定长度30字节表A.9基本卫星定位数据包内容（30字节）序号内容长度（字节）描述1时间6年月日时分秒采用BCD码2经度4DDDFF.FFF采用BCD码3纬度40DDFF.FFF采用BCD码4速度1单位：km/h，优先使用行车记录仪速度5方向1单位：2dec6高度2单位：m7里程4单位：0.1km采用BCD码8状态8见后面附加信息说明。注：OMC平台需保证上传的卫星定位数据及时准确，服务器对不正确数据作丢弃处理。A.8.3图片数据包表A.10图片数据包协议说明表关键字U02数据字段1字段名称车牌号说明完整合法的车牌号，符合GA36-2007《中华人民共和国机动车号牌》要求，不含分隔符长度不定长东莞市交通运输局重点监管车辆监控平台数据接口协议V1.07数据字段2字段名称车牌颜色说明整数。长度固定长度1字节。数据字段3字段名称拍摄时间说明BCD码，格式为YYMMDDHHMMSS长度固定长度6字节数据字段4字段名称摄像头编号说明整数长度固定长度1字节数据字段5字段名称图片格式说明图片文件后缀，字符串，如：jpg、gif、tiff长度不定长数据字段6字段名称本图片数据包总数说明整数，图片数据包按顺序传输，当数据包序号与数据包总数相等时表示最后一包。长度固定长度4字节数据字段7字段名称数据包序号说明整数，序号从1开始。长度固定长度4字节。数据字段8字段名称图片数据说明二进制数据流，可含分隔符，无需编码。长度不定长，长度由数据长度和前面字段长度计算。每包图片数据不超过1024字节。注：图片数据包应完整，单幅图片分成多个数据包传输，应按照序号逐包顺序传输。网络连接正常时，TCP协议可保证数据包不丢失，对于传输超时的图片，服务器将作超时丢弃处理。A.8.4紧急报警数据包与A.8.2卫星定位数据包U01相同。A.8.5超速报警数据包与A.8.2卫星定位数据包U01相同。A.8.6疲劳驾驶报警数据包与A.8.2卫星定位数据包U01相同。A.8.7越界报警数据包与A.8.2卫星定位数据包U01相同。A.8.8上传OMC代码及车辆静态信息表A.11OMC代码及车辆静态信息数据包协议说明表关键字U03数据字段1字段名称企业监控平台代码说明整数，由政府职能部门指定机构统一分配东莞市交通运输局重点监管车辆监控平台数据接口协议V1.08长度固定长度4字节数据字段2字段名称MDT规格型号说明字符串长度不定长数据字段3字段名称MDT代码说明厂商代码＋终端ID，符合DB44/T578-2009标准的规定长度固定长度6字节数据字段4字段名称车牌号说明完整合法的车牌号，符合GA36-2007《中华人民共和国机动车号牌》要求，不含分隔符长度不定长数据字段5字段名称车牌颜色说明整数。长度固定长度1字节。数据字段6字段名称号牌种类说明字符串，符合GA24.7的要求。长度不定长。数据字段7字段名称车辆类型说明字符串，符合GA24.4的要求长度不定长。数据字段8字段名称车辆用途说明整数，见前表4车辆用途编码长度固定长度1字节数据字段9字段名称车辆单位组织机构代码说明字符串，由政府职能部门指定机构统一分配，组织机构代码证的代码，一般9位长度不定长数据字段10字段名称车辆单位名称说明字符串，单位全称长度不定长数据字段11字段名称车辆从业资格证号码说明由政府职能部门指定机构统一分配，字符串长度不定长注：MDT规格型号、车辆所属公司、监控分组、车辆分类、运营商等基本资料由市级基准平台维护人员录入，车辆资料一般由U03同步，市级基准平台作资料核准，U03上传的资料必须保证MDT规格型号、车辆单位名称与基准平台的资料一致，对不一致的数据，服务器将作无效数据丢弃。车辆资料的删除、更改请联系市级平台维护人员手工操作。A.8.9上传事故疑点信息表A.12事故疑点信息数据包协议说明表关键字U04数据