2021视频监控卡口数据传输技术规范

视频监控卡口数据传输技术规范2020II目 次前 言 II范围 1规性用件 1基要求 1通方式 1消组成 2息构 2息头 2协流程 2接协议 3端证平→备） 3端证V2（设平台） 4跳活号设→平） 5送口录设→平） 5送口录V2（备→台） 6附录A（范附）码表范 1011视频监控卡口数据传输技术规范范围本标准规定了视频卡口前端与平台之间的通信方式、消息组成、协议流程和接口协议等技术要求。本标准适用于视频监控卡口系统的方案设计、系统检测、验收以及与之相关的程序研发。UTF-8信息交换用UTF8编码字符集字节UTF-8C\0JPEGMP4协议中使用的数据类型见表1。表1数据类型数据类型描述及要求time_t8字节，表示从1970年1月1日0时到指定时间所经历的秒数（格林威治时间）。如无特殊说明，文档中所用的时间都是time_t类型。UINT32无符号整型，4字节。UINT64无符号整型，8字节。Float浮点型，4字节。String字符串22DB3311/TTCPTCPServer41022Server42022IP平台发往前端的消息以及前端返回平台的回应采用统一格式，如表2所示。表2消息结构消息头整体数据字节数消息体UINT32UINT32数据长度可变注：整体数据字节数为消息总的长度（按字节记），包括消息头、整体数据字节数和消息体消息头消息头的内容应采用规范表述，如表3所示。表3消息头内容类型消息标识说明数据流方向是否需要回复0xefff0001前端验证平台→前端是0xefff0002前端向平台反馈包前端→平台否0xefff0004卡口记录V1前端→平台是0xefff0005接收数据反馈包平台→前端否0xefff0007心跳信号前端→平台否0xefff0008卡口记录V2前端→平台是0x3fff000a前端验证V2前端→平台是0x3fff000b平台向前端反馈包平台→前端否前端与平台之间的协议交互流程如图1所示。33前端平台身份认证认证结果身份认证认证结果心跳保活上传卡口记录确认结果图1协议交互流程）5认证码由前端进行管理，前端应可以配置。表4认证包格式平台向前端发出验证包消息头：验证 0xefff0001整体数据长度：96字节消息体：数据内容1Char[44]用户名2Char[44]认证码44表5反馈包格式前端向平台反馈包消息头：认证状态整体数据长度：12字节消息体：0xefff0002数据内容1UINT320：认证成功、1：用户名错误、2：认证码错误V2（）前端连接平台时，应携带通道编号和验证码进行身份认证。认证包格式见表6，反馈包格式见表7。身份认证不成功，应返回认证失败消息且断开连接不提供服务。认证码由平台进行管理，平台应可以配置。表6认证包格式前端向平台发送验证包消息头：验证 0xefff000a整体数据长度：8+结构化信息长度+结构化信息消息体：描述名称类型备注结构化信息长度结构化信息长度Integer说明后面的结构化信息JSON的长度结构化信息结构化信息StringJSON封装的结构化信息结构化信息JSON如下，编码格式采用UTF-8。{"DeviceID":"通道编号","Password":"认证码"}表7反馈包格式平台向前端反馈包消息头：认证状态 0xefff000b整体数据长度：8+结构化信息长度+结构化信息消息体：描述名称类型备注结构化信息长度结构化信息长度Integer说明后面的结构化信息JSON的长度结构化信息结构化信息StringJSON封装的结构化信息结构化信息JSON如下，编码格式采用UTF-8。{"Result":0,//0：认证成功；1：用户名错误；2：认证码错误；3：重定向"RedirectAddress":"10.33.214.126:42022"55}）前端在通讯空闲时，应每5秒钟向平台发送一次心跳保活信号，心跳包格式见表8。11前端向平台发送心跳包整体数据长度：前端向平台发送心跳包整体数据长度：8字节消息头：心跳头0xefff0007）前端向平台发送卡口识别数据包见表10。平台向前端发送接收数据反馈包格式见表9。平台向前端反馈接收数据反馈包整体数据长度：平台向前端反馈接收数据反馈包整体数据长度：64字节消息体：消息头：接收数据成功0xefff0005数据内容1UINT64数据编号(在设备上的数据编号)2UINT32回复接收数据状态：0入库成功1解析第一步失败2解析第二步失败3入库失败3Char[44]通道编号66表10识别数据包格式前端向平台发送卡口识别数据包消息头：卡口识别数据头 0xefff0004整体数据长度：8+关于全景图的信息长度+图片数据长度+n*识别数据长度消息体：关于全景图的信息1UINT64图片编号，填默认值填02UINT32图片字节数3UINT32关于图片的识别数据个数n条4UINT32图片宽度5UINT*2图片高度6Char[48]通道编号7Char[48]图片存储路径，填默认值”\0”图片数据1Char[]保存的实际图片总数n条识别数据1UINT64数据编号，填默认值02UINT64在设备上的数据编号8字节3time_t过卡口时间8字节4UINT64关联的图片信息编号，填默认*05UINT32过卡口时间毫秒6float车辆速度单位公里7UINT32车道号8float识别精度9UINT3*方向代码(见附录A.2)10UINT32车牌类型(见附录A.1)11UINT32车牌颜色(见附录A.3)12UINT32车辆类型(见附录A.7)13UINT32车辆logo(见附录A.6)14U*NT32车辆颜色(见附录A.5)15UINT32车牌结构(见附录A.4)16UINT32在全景图中的特征图坐标x1如无填9999999917UINT32在全景图中的特征图坐标y1如无填9999999918UINT32在全景图中的特征图坐标x2如无填9999999919UINT32在全景图中的特征图坐标y2如无填9999999920Char[20]车牌号（“00000000”表示未识别出、行人或非机动车，“11111111”表示无牌车）V2（）前端向平台发送卡口识别数据包格式见表11。平台向前端反馈接收数据反馈包格式见表13。77前端向平台发送卡口识别数据包整体数据长度：前端向平台发送卡口识别数据包整体数据长度：8+结构化信息长度+结构化信息+图像数据消息体：消息头：卡口识别数据头0xefff0008描述名称类型备注结构化信息长度结构化信息长度Integer说明后面的结构化信息JSON的长度结构化信息结构化信息StringJSON封装的结构化信息，见表12图像数据总共N个图像UINT32图*个数。图像1大小UINT32图像数据的数据长度由图像大小确定。图像1数据Char[]保存的实际图片图像2大小UINT32图像2数据Char[]保存的实际图片…图像N大小UINT32图像N数据Char[]保存的实际图片结构化信息JSON如下，编码格式采用UTF-8。{"SeqID":"在设备上的数据编号","VehicleInfo":{"RecordID":"记录唯一ID","DeviceID":"通道编号","PlateNo":"车牌号码","VehicleType":"车辆类型","VehicleColor":"车辆颜色","VehicleBrand":"车辆品牌","VehicleModel":"车辆型号","VehicleStyles":"车辆年款","PlateType":"车牌种类","PlateColor":"车牌颜色","PlateStructure":车牌结构,"LaneNo":"车道号","Speed":"车速","MaxSpeed"MinSpeed"Direction":"行驶方向","VioCode":"违法代码","PassTime":"抓拍时间","ImageList":[{"ImageInfo"{//图像信息88"ImageNo":图像序号,"ImageType":图像类型,"ImageWidth":图像宽度,"ImageHeight":图像高度}"VehicleCoordinate":[{//X1,Y1,"X2":车牌坐标X2,"Y2":车牌坐标Y2}],"FaceCoordinate":[{//X1,Y1,"X2":人脸坐标X2,"Y2":人脸坐标Y2}],}],}表12结构化信息名称字段名类型备注数据编号SeqIDString在设备上的数据编号，唯一编号。RecordID记录IDString编码规则：通道ID+时间（YYYYMMDDHHMMSS）+流水号设备编号DeviceIDString通道编号。车牌号码PlateNoString车牌号“000011111”表示无牌车）车牌类型PlateTypeInteger见附录A.1方向代码DirectionString见附录A.2车牌颜色PlateColorInteger见附录A.3车牌结构PlateStructureInteger见附录A.4车辆颜色VehicleColorInteger见附录A.5车辆品牌VehicleBrandInteger见附录A.6车辆类型*VehicleTypeIntege见附录A.7车辆型号VehicleModelString品牌下的型号，如奥迪A4L，中文描述。车辆年款VehicleStylesString车型下的年份信息，汽车行业惯例，中文描述。车道号LaneNoInteger车辆行驶方向最左车道为1，由左向右顺序编号。车速SpeedInteger每小时公里数。速度上限MaxSpeedInteger每小时公里数。速度下限MinSpeedInteger每小时公里数。违法代码VioCodeString5位代码，编码规则按公安的相关规定，整个系统中违法代码统一，同时在前端可自定义配置违法代码99表12结构化信息（续）名称字段名类型备注抓拍时间PassTimetimestamp精度为毫秒（YYYYMMDDHHMMSSMMM）24MMMMMMM表示毫秒。图像序号ImageNoInteger图像类型ImageTypeInteger见附录A.8图像宽度ImageWidthInteger图像高度ImageHeightInteger平台向前端反馈接收数据反馈包整体数据长度：64字节平台向前端反馈接收数据反馈包整体数据长度：64字节消息体：消息头：接收数据成功0xefff0005数据内容1UINT64数据编号2UINT32回复接收数据状态：0入库成功1解析第一步失败2解析第二步失败3入库失败3Char[44]通道编号1010附录A（规范性附录）代码表规范车牌类型代码见表A.1。表A.1车牌类型代码代码代码名备注1大型汽车号牌黄底黑字（含02式号牌部分）2小型汽车号牌蓝底白字（含02式号牌部分）3使馆汽车号牌黑底白字、红“使”字4领馆汽车号牌黑底白字、红“领”字5境外汽车号牌黑底白／红字6外籍汽车号牌黑底白字7两、三轮摩托车号牌黄底黑字8轻便摩托车号牌蓝底白字9使馆摩托车号牌黑底白字、红“使”字10领馆摩托车号牌黑底白字、红“领”字11境外摩托车号牌黑底白字12外籍摩托车号牌黑底白字13农用运输车号牌黄底黑字黑框线，已按《道路交通安全法》取消农用运输车，不再发放14拖拉机号牌黄底黑字15挂车号牌黄底黑字黑框线16教练汽车号牌黄底黑字黑框线17教练摩托车号牌黄底黑字黑框线18试验汽车号牌19试验摩托车号牌20临时入境汽车号牌白底红字黑“临时入境”21临时入境摩托车号牌白底红字黑“临时入境”22临时行驶车号牌白底黑字黑框线23警用汽车号牌24警用摩托车号牌25原农机号牌26香港入出境车27澳门入出境车31武警号牌32军队号牌33应急号牌1111表A.1车牌类型代码（续）代码代码名备注41无号牌42假号牌43挪用号牌51大型新能源汽车号牌黄绿底黑字，黑框线52小型新能源汽车号牌渐变绿底黑字，黑框线97非机动车用于自定义电动车号牌等99其他号牌方向代码见表A.2。表A.2方向代码代码代码名备注1由东向西NULL2由西向东NULL3由南向北NULL4由北向南NULL5由北东向西南NULL6由东南向西北NULL7由西南向东北NULL8由西北向东南NULL99其它方向NULL车牌颜色代码见表A.3。表A.3车牌颜色代码代码代码名备注1蓝色NULL2黑色NULL3黄色NULL4白色NULL5绿色NULL6渐变白绿色新能源小型汽车7渐变黄绿色新能源大型汽车99其他颜色NULL1212车牌结构代码见表A.4。表A.4车牌结构代码代码代码名备注1单行2双行99其它车牌颜色代码见表A.5。表A.5车辆颜色代码代码代码名备注1白色NULL2银色NULL3黑色NULL4红色NULL5紫色NULL6蓝色NULL7黄色NULL8绿色NULL9褐色NULL10粉红色NULL11灰色NULL12混合色NULL99其它颜色NULL车标代码见表A.6。表A.6车标代码代码代码名备注1奥迪NULL2宝马NULL3现代NULL4奔驰NULL5本田NULL1313表A.6车标代码（续）代码代码名备注6大众NULL7马自达NULL8丰田NULL9别克NULL10雪弗兰NULL11雪铁龙NULL12标志NULL13福特NULL14凌志NULL15尼桑NULL16奇瑞NULL17比亚迪NULL18起亚NULL19荣威NULL20三菱NULL21斯柯达NULL22铃木NULL23昌河NULL24菲亚特NULL25沃尔沃NULL26吉普NULL27路虎NULL28通用NULL29红旗NULL30悍马NULL31金杯NULL32江淮NULL33江铃NULL34吉利NULL35陆风NULL36力帆NULL37名爵NULL38讴歌NULL39英菲尼迪NULL40中华NULL41众泰NULL42威麟NULL43斯巴鲁NULL44世爵NULL1414表A.6车标代码（续）代码代码名备注45双环NULL46萨博NULL47威兹曼NULL48全球鹰NULL49吉奥NULL50华泰NULL51华普NULL52哈飞NULL53东南NULL54帝豪NULL55长安NULL56长丰NULL57长城NULL58大宇NULL59五十铃NULL60大发NULL61捷豹NULL62欧宝NULL63克莱斯勒NULL64阿尔法-罗密欧NULL65林肯NULL66劳斯莱斯NULL67法拉利NULL68保时捷NULL69莲花NULL70阿斯顿马丁NULL71皇冠NULL72奔腾NULL73东风NULL74中顺NULL75长安福田NULL76五菱NULL77凯迪拉克NULL78玛莎拉蒂M3NULL79富士NULL80野马NULL81玛莎拉蒂NULL82雷诺NULL83依维柯NULL84道奇NULL1515表A.6车标代码（续）代码代码名备注85普利茅斯NULL86俊朗NULL87极品NULL88水星NULL89土星NULL90蓝旗亚NULL91西亚特NULL92双龙NULL93本特利NULL94绅宝NULL95庞蒂克NULL96奥士莫比NULL97兰博基尼NULL98奥斯汀NULL99陕汽重卡NULL100北奔重卡NULL101宇通客车NULL102羊城汽车NULL103福迪汽车NULL104广汽NULL105华德NULL106楚风NULL107春兰NULL108大运NULL109东风柳州NULL110佛山飞驰NULL111日野NULL112红岩NULL113华菱NULL114金旅NULL115联合NULL116曼NULL117青年NULL118日产NULL119神野NULL120十通NULL121斯堪尼亚NULL122五征NULL123徐工NULL1616表A.6车标代码（续）代码代码名备注124中通NULL125王牌NULL126宝骏NULL127理念NULL128宾利NULL129启辰NULL130传祺NULL131迷你NULL132哈佛NULL133纳智捷NULL134斯玛特NULL135汇众NULL136一汽NULL137开瑞NULL138南汽NULL139跃进NULL140解放NULL141金龙NULL142罗福NULL143中兴NULL144瑞麒NULL145曙光NULL146迈巴赫NULL147布加迪NU