《车辆路面动态检测技术监控数据传输.docx》由会员分享，可在线阅读，更多相关《车辆路面动态检测技术监控数据传输.docx（43页珍藏版）》请在课桌文档上搜索。
1、车辆路面动态检测技术监控数据传输接口规范目录1数据交换总体要求错误!未定义书签。2 数据交换机制错误!未定义书签。1. 1及时性保证机制错误!未定义书签。2. 2完整性保证机制错误!未定义书签。3. 3安全性保证机制错误!未定义书签。3 数据交换指标错误!未定义书签。3.1 登录信息错误!未定义书签。3.2 称重检测信息错误!未定义书签。3.3 设备状态消息信息错误!未定义书签。3.4 大件运输许可通行名单信息错误!未定义书签。3.5 营运车辆黑名单信息错误!未定义书签。1.1 6设备检定记录信息错误!未定义书签。3.7 对账信息错误!未定义书签。3.8 交通流量调查信息错误!未定义书签。4数
2、据交换接口错误!未定义书签。4.1 接口说明错误!未定义书签。4.2 接口协议错误!未定义书签。4.3 接口方法定义错误!未定义书签。附件1公路货运车辆车型代码错误!未定义书签。1数据交换总体要求数据接口规范主要用于车辆路面动态检测技术监控设备和治超监测监控指挥中心对接交换，交换的数据包括称重检测数据（含外廓尺寸）、交通流量调查、称重检测图片视频文件信息（含电子抓拍）、设备状态、大件运输许可通行名单、对账信息等。2数据交换机制车辆路面动态检测技术监控设备，要保障与治超监测监控指挥中心数据交换的及时性、完整性和安全性，设计完善可靠的数据交互机制，是业务正常运行的核心。车辆路面动态检测技术监控设备
3、通过实时程序向治超监测监控指挥中心发送数据交换请求，数据交换机制主要包含3个方面的内容：2.1及时性保证机制车辆路面动态检测技术监控设备采集到车辆数据后，发起数据上传操作，治超监测监控指挥中心接收完成后回复接收确认消息。2.2完整性保证机制数据交换采用SM3算法，用于提供消息的完整性校验。对于获取数据的请求不需要做SM3校验。2.3安全性保证机制治超监测监控指挥中心数据交换采用HTTPS技术，并对车辆路面动态检测技术监控设备进行身份认证，实现消息的安全传输。3数据交换指标3.1登录信息序号字段代码字段说明数据类型必填备注1username用户名String是2password密码String是
4、3token登录后返回的令牌String是4expire过期时间String是单位：秒，默认86400秒（24小时）；token过期后，需重新获取3.2称重检测信息3.2.1称重检测数据信息序号字段名称字段说明数据类型必填说明1CheckNo检测单号String是检测单号=称重检测设备编号+检测日期+顺序数2SiteName站点名称String车辆路面动态检测技术监控点名称3site1.d站点编号String是站点编号=行政区划代码6位+4位数字。行政区划代码详见GB22604IaneNumber检测车道编号String是按行进方向从左到右排列，依次为01、025equip1.d称重检测设备编
5、号String是站点编号+3位数字。6CheckType检测数据类型String是I-超限检测站初检数据；2-超限检测站复检数据；3-预检；4-车辆路面动态检测技术监控：5-卸载场复称；&源头企业；7-高速公路入口称重检测；8-公安交通联合治超站（固定站）7CheckTime检测时间String是yyyy-MM-ddHH:mm:ss.SSS8IinkCheckNo关联检测单号String当检测数据类型为2时，此项必填9Vehic1.eType车辆类型String是0非货运车辆：1-违法超限超载货车：2-合法装载货车10Vehic1.eNo车辆号牌String是11P1.ateCo1.or号牌颜
6、色Integer是蓝色；I-黄色；2-黑色；3-白色：序号字段名称字段说明数据类型必填说明4-渐变绿色；5-黄绿双拼色；6-蓝白渐变色；9未确定：11-绿色；12.红色Vehic1.eNo不为空或不为空串时，此项必填12Vehic1.eAx1.esType车辆轴型String详见附录1公路货运车辆车型代码13tota1.车货总质量Integer是精确到个位。单位：千克14ax1.es车辆轴数Integer是轴数不能小于215weight1轴重1Integer精确到个位。单位：千克16weight!轴重2Integer精确到个位。单位：千克17weight3轴重3Integer精确到个位。单位：
7、千克18weight4轴重4Integer精确到个位。单位：千克19weight5轴重5Integer精确到个位。单位：千克20weight6轴重6Integer精确到个位。单位：千克21weight7轴重7Integer精确到个位。单位：千克22speed车速Integer是精确到个位。单位：km/h23IimitWeight最大允许总质量Integer是精确到个位。单位：千克24overWeight超限量Integer是精确到个位。单位：千克25overRate超限超载率Doub1.e是精确到小数点后2位。单位：%26Un1.oadWeight卸载重量Integer当检测数据类型为2时，此
8、项必填27tota1.1.ength车货总长度Integer单位：亳米28tota1.Width车货总宽度Integer单位：亳米序号字段名称字段说明数据类型必填说明29Iota1.Height车货总高度Integer单位：亮米30over1.ength超长量Integer单位：亳米31overWidth超宽量Integer单位：亮米32overHeight超高量Integer单位：亳米33bu1.kVehic1.e是否为大件运输车辆String是OI为大件运输车辆，00为非大件运输车辆34HcNo匹配的大件运输许可证号String若“是否为大件运输车辆”为01,则必填35Vehic1.e1.
9、istType车辆名单类型Integer是0普通车辆：1-黑名单车辆；2-违法取证未处罚车辆36direction行股方向Integer是非现场检测点必须1：上行2：下行37obu1.dOBU编号String如有ETC则必填38ObuVehic1.eNoOBU车牌编号String同上39ObuP1.ateCo1.orOBU车牌颜色Integer同上40ObuVehicIeTypeOBU收费车型Integer同上41obuVehic1.eCustomTypeOBU车辆用户类型Integer同上42ObuTota1.MassOBU车辆总质量Integer同上43ObuMaintenanceMass
10、OBU整备质量Integer同上44ObuPermittedTowWeightOBU车辆准牵引总质量Integer同上45ObuPennittedWeightOBU车辆核定载质Integer同上46ObuVehic1.e1.engthOBU车辆长Integer同上47ObuVehic1.eWidthOBU车辆宽Integer同上序号字段名称字段说明数据类型必填说明48ObuVehicIeHeightOBU车辆高Integer同上49SecurityInfoiTnation防伪信息String50Vehic1.ef1.owType交调机动车车型StringO1.中小客车、02-小型货车、03-大
11、客车、04-中型货车、05-大型货车、06-特大型货车、07-集装箱车、08-摩托车1.1 2.2称重检测图片视频文件信息序号字段名称字段说明数据类型必填说明1CheckNo检测单号String是检测单号=称重检测设备编号+检测日期+顺序数2SiteId站点编号String站点编号=行政区划代码6位+4位数字。行政区划代码详见GB2260。3CheckTime检测时间String时间格式：yyyy-MM-ddHH:mm:ss.SSS4Vehic1.eNo车辆号牌String5Vehic1.eType车辆类型Integer是违法超限超载货车；2.合法装载货车6VideoEquip1.d视频抓拍设
12、备标识String是7fi1.eName文件名String是图片、视频文件名，包含后缀例如：48dataType数据类型String是值域：O1.-车头第一张图片；02-车头第二张图片；H-前部45度角照片；21-侧面第一张照片：22-侧面第二张照片：31-车尾照片：41-号牌特写照片;81-视频。序号字段名称字段说明数据类型必填说明9Jata1.ength数据长度Integer是文件字节数。10dataContent数据内容String是图片、视频文件经过BASE64转码后字符串。3.3 设备状杰消息信息序号字段代码字段说明数据类型必填备注1equip1.d设备编号String是设备唯一编码
13、2equipStatus设备状态Integer是0-正常：1-传感器故障：2-光栅故障；4-线圈故障；8-轮胎识别器故障；16-通讯故障。当多种故障时，返回值为各故障值之和。3type设备分类Integer是1：称重设备2：视频抓拍设备4sendTime消息发送时间String是格式：yyyy-MM-ddHH:mm:ss.SSS3.4 大件运输许可通行名单信息序号字段代码字段说明数据类型必填备注1IicNo大件运输许可证号String是对应的大件运输许可证编号2Vehic1.eNo车辆号牌String是车辆号码3P1.ateCo1.or号牌颜色String是O-蓝色：】-黄色；2-黑色：3-白
14、色；4-渐变绿色：5-黄绿双拼色；6-蓝白渐变色；9-未确定；绿色；12红色4Vehic1.eWeight空车重量Integer是精确到个位。单位：千克5tota1.车货总质量Integer是精确到个位。单位：千克6ax1.es车辆轴数Integer是轴数不能小于27IssueUnitName发证单位String是8IicTime许可证发证时间String是格式：yyyy-MM-ddHH:mm:ss.SSS9CarrierName承运单位String是IOgoods1.nfb货物信息String是11effectiveRange有效范围String否12PassageTime通行日期Sirin
15、g是格式：yyyy-MM-dd13tPuckCargoTota1.1.ength车货总长Integer否单位：亳米14IruckCargoTOta1.Width车货总宽Integer否单位：亳米15IruckCargoTota1.Height车货总高Integer否单位：亳米16road1.d通行线路String是3.5 营运车辆黑名单信息序号字段名字段说明数据类型必填备注1b1.ack1.istVehic1.eCode车辆黑名单案件号String2vehic1.eNo车辆号牌String3p1.ateCo1.or号牌颜色Integer是I-蓝色；I-黄色；2黑色：3.白色;4-渐变绿色;5-
16、黄绿双拼色；6-蓝白渐变色；9未确定；11-绿色：12-红色4Vehic1.eTransportDist道路运输证字String5Vehic1.eTransportCode道路运输证号String6Vio1.ationCaseNo违章案件号String7Vio1.ationTimes违章次数Integer8b1.ack1.istType黑名单类型IntegerI未处罚黑名单：2-已处罚黑名单；3-退出黑名单9Vehic1.eRegistrationOrg车籍地机构String序号字段名字段说明数据类型必填备注Id10Pena1.tyType处罚类型Integer吊销道路运输证11Pena1.t
17、yDecisionDate处罚决定日期StringYYYY-MM-DD12Pena1.tyEndDate处罚结束日期StringYYYY-MM-DD13org1.d执法机构String14persone1.1.d执法人员String15Pena1.tyDecisionImage行政处罚决定书String附件，最大5MB3.6 设备检定记录信息序号字段名字段说明数据类型必填备注1equip1.d设备IDString2VerificationRecordNo检定编号String3effectiveDate检定有效期至String3.7 对账信息序号字段代码字段说明数据类型必填备注1verifj,D
18、ate对账日期String是2site1.d站点标识String是3Up1.oadNum应传数量Integer是4SendTime消息发送时间String是格式：yyyy-MM-ddHH:mm:ss.SSS3.8 8交通流量调查信息序号字段代码字段说明数据类型必填备注1SendTime数据包发送时String是格式：yyyy-MM-ddHH：mm：ss.SSS序号字段代码字段说明数据类型必填备注间2da(a1.ength实时交通数据包数据长度Integer是文件字节数。3dataPacket实时交通数据包String是文件经过BASE64转码后字符串4datapacketType数据包类型St
19、ring是I-实时交通数据包5equip1.d设备身份识别码String是6SiteId站点编码String是7equipError设备硬件错误码String00-代表设备硬件工作正常：OI-代表设备硬件工作异常。8SurveyContent调查内容String9year年String是10month月String是11date日String是12trafficf1.ourCyc1.e交通数据处理周期Integer是以分钟为单位，默认为5分钟13timeSeq时间序号Integer是14IaneQuantity车道数Integer是15Vehic1.e1.aneNo车道号String是单车道代
20、码规则：上行01,下行03。2车道以上公路车道号代码规则：上行从内至外按11、12、13连续编号；下行按31、32、33连续编号。车道号排列规则：先上行、后下行，同一个行驶方向先内侧车道、后外侧车道。16fo1.1.owRate跟车百分比Doub1.e是17averageSpace平均车头间距Doub1.e是18IimeownRate时间占有率Doub1.e是序号字段代码字段说明数据类型必填备注19SedanQuantity中小客车交通量Integer是20SedanavgSpeed中小客车平均地点车速Integer是21VanQuantity小型货车交通量Integer是22VanavgSp
21、eed小型货车平均地点车速Integer是23busQuantity大客车交通量Integer是24busavgSpeed大客车平均地点车速Integer是25midsizetruckQuantity中型货车交通量Integer是26midsizetruckavgSpeed中型货车平均地点车速Integer是27IargetruckQuantiy大型货车交通量Integer是28IargetruckavgSpeed大型货车平均地点车速Integer是29extra1.argetruckQuantity特大型货车交通量Integer是30extra1.argeiruckavgSeed特大型货车平
22、均地点车速Integer是31ContainertruckQuantity集装箱车交通量Integer是32ContainertruckaVgSpeed集装箱车平均地点车速Integer是33IractorQuantity拖拉机交通量Integer是34IractoravgSpeed拖拉机平均地Integer是序号字段代码字段说明数据类型必填备注点车速35ITiotorbikeQuant叼摩托车交通量Integer是36motorbikeavgSpeed摩托车平均地点车速Integer是注：交通流量调查数据发送还应符合交通流量调查相关规范要求。4数据交换接口4.1接口说明1、数据交换接口是用于
23、车辆路面动态检测技术监控与市级治超监测监控指挥中心之间的数据交换共享，采用响应式（服务式），传输协议选择HnPS协议，编码格式统一为UTF-8编码，请求和响应数据格式为JSON。2、数据传输需要对传输请求进行鉴权和对传输数据进行访问控制。3、除接口特殊需求，接口中提及的SERVER_PATH统一使用一个，具体地址IP在市级治超监测监控中心建设完成后给出。4、流程说明：（1）调用“4.3.1登录”接口获取token,将token放在需要调用接口的请求头headers中，headers中的属性名为AUthoriZatiOn；（2）按一定频率调用“4.3.4大件运输许可通行名单获取接口”同步大件运输
24、许可信息，用于判断超限超载的货车是否有大件运输许可，并将结果通过“432.1称重检测数据上传接口”的bu1.kVehic1.e.IicNo字段上传；（3）按一定频率调用“435营运车辆黑名单获取接口”同步营运车辆黑名单，用于判断车辆是否在黑名单，并将结果通过“432.1称重检测数据上传接口”的Vehic1.e1.istType字段上传；（4）通过“4.321称重检测数据上传接口”上传检测数据；（5）通过“4.322称重检测图片视频文件上传接口”上传检测过程中采集的视频图片数据；（6）按固定频率调用“4.3.3设备状态消息上传接口”上传站点相关设备的状态信息。5、流程图：包含大件运输许可同步流程
25、、营运车辆黑名单同步流程、超限超载检测判定上传、设备状态消息上传。设各状态流皂上传4.2接口协议4.2.1Request请求属性名是否必填备注RequestHeadersRequestMethod必填HTTP请求方法sysCode必填系统代码distCode必填行政区划代码请求属性名是否必填备注dataSM3选填数据SM3摘要，用于数据完整性校验；PoST请求需要校验，GET请求不需要校验。进行SM3加密时，Content里的参数需经过排序，对所有传入参数按照字段名的ASCII码从小到大排序。例如登录的json：password:密码”JusemameY用户名”加密后的结果：1Obde1ed6
26、6dd9816edbdf504cc0776eAuthorization必填鉴权码，调用登录接口登录成功后获取的tokenContent-Type选填app1.ication/jsonContent必填JSoN格式字符串数据4.2.2Response请求属性名是否必填备注ResponseHeadersHTTPStatusCode必填HTTP状态码Contentcode必填返回码message必填返回的消息当code700时返回错误信息字符串。data非必填请求结果返回的数据4.2.3HTTP状态码HTTP请求默认60s超时。状杰码描述状态码描述HTTP自定义返回码（600）：200（成功）服务器
27、已成功处理了请求。201（已创建）请求成功并且服务器创建了新的资源。202（已接受）服务器已接受请求，但尚未处理。203（非授权信息）服务器已成功处理了请求，但返回的信息可能来自另一来源。204（无内容）服务器成功处理了请求，但没有返回任何内容。205（重置内容）服务器成功处理了请求，但没有返回任何内容。206（部分内容）服务器成功处理了部分GET请求。300（多种选择）针对请求，服务器可执行多种操作。301（永久移动）请求的网页已永久移动到新位置。302（临时移动）服务器目前从不同位置的网页响应请求，但请求者应继续使用原有位置来进行以后的请求。303（查看其他位置）请求者应当对不同的位置使用
28、单独的GET请求来检索响应时，服务器返回此代码。304（未修改）自从上次请求后，请求的网页未修改过。服务器返回此响应时，不会返回网页内容。305（使用代理）请求者只能使用代理访问请求的网页。如果服务器返回此响应，还表示请求者应使用代理。307（临时重定向）服务器目前从不同位置的网页响应请求，但请求者应继续使用原有位置来进行以后的请求。400（错误请求）服务器不理解请求的语法。401（未授权）请求要求身份验证。403（禁止）服务器拒绝请求。404（未找到）服务器找不到请求的网页。405（方法禁用）禁用请求中指定的方法。406（不接受）无法使用请求的内容特性响应请求的网页。状态码描述407（需要代
29、理授权）此状态代码与401（未授权）类似，但指定请求者应当授权使用代理。408（请求超时）服务器等候请求时发生超时。409（冲突）服务器在完成请求时发生冲突。410（已删除）如果请求的资源已永久删除，服务器就会返回此响应。411（需要有效长度）服务器不接受不含有效内容长度标头字段的请求。412（未满足前提条件）服务器未满足请求者在请求中设置的其中一个前提条件。413（请求实体过大）服务器无法处理请求，因为请求实体过大，超出服务器的处理能力。414（请求的UR1.过长）请求的UR1.（通常为网址）过长，服务器无法处理。415（不支持的媒体类型）请求的格式不受请求页面的支持。416（请求范围不符合
30、要求）如果页面无法提供请求的范围，则服务器会返回此状态代码。417（未满足期望值）服务器未满足请求头“期望”字段中预期内容的要求。500（服务器内部错误）服务器遇到错误，无法完成请求。501（尚未实施）服务器不具备完成请求的功能。502（错误网关）服务器作为网关或代理，从上游服务器收到无效响应。503（服务不可用）服务器目前无法使用（由于超载或停机维护）。504（网关超时）服务器作为网关或代理，但是没有及时从上游服务器收到请求。505（HTTP版本不受支持）服务器不支持请求中所用的HTTP协议版本。4.2.4COde返回码返回码描述返回码描述系统服务返回码(错误码)(700-949)：具体接口
31、的错误码701接收失败702文件解析失败703文件格式校验失败704业务校验失败705数据入库失败706命令不存在707数据重复上传708附件信息不完整709收件人邮箱格式错误710邮件服务器异常711无数据712附件不存在713数据未准备好714生成压缩文件失败715文件名重复716响应失败790暂停服务795格式错误796内容不能为空797内容长度错误798请求服务权限错误799服务端系统内部错误801链接过多802有正在处理的交易包返回码描述945不支持此类文件946响应文件不存在947请求数据格式错误948请求文件名格式不正确949协议中未定义此类文件名系统服务预留返回码（950999
32、）950鉴权失败951文件SM3校验失败952格式校验失败953请求文件为空954dataSM3不能为空955取值范围不正确956数据不正确999未知错误4.3接口方法定义4.3.1登录接口接口说明检测系统登录治超系统接口地址httpsSERVERPATHzcapiusercheckWeightZ1.ogin请求方式POST请求示例消息头RequsetHeadersRequestMethodPOSTsysCode1000distCode350700dataSM31Obde1ed66dd9816edbdf504cc0776ee185c43e4d3fc8bb30588ec342Content-Ty
33、peapp1.ication/json消息体Content“password”:密码“，“username”:“用户名“响应HTTPStatusCode200Content“code”:。,data“expire”:86400,“token”:“ZeOKtQCXR4Yh7SK6UImY60kB0sFRKi0rN-rBTC6iAVG655H9jApD1nDjO9NFxpDYVs931b3dNQdtfwZH-Xx1.TUbfbpHS8AoNJR6yppe3Ic3ZU88P-_CRUcNI9jGWqKxzC7P8rISzTwmmVRgOW84ImRCifJTPbA47yE5meY，“message”
34、:登录成功!,)备注说明3.9 3.1.1ASE密码加密AES加密方式key:fjzcg1.sw3nBetterIv:fjzc2g19NgoodIvA1.GORITHMSTR:AESCBCPKCS5Padding*CBC模式密码分组链接模式CipherB1.ockChaining为了解决ECB模式的密文块相同的缺点，CBC的模式引入了一个初始向量概念，该向量必须是一个与密钥长度相等的数据，在第一次加密前，会使用初始化向量与第一块数据做异或运算，生成的新数据再进行加密，加密第二块之前，会拿第一块的密文数据与第二块明文进行异或运算后再进行加密，以此类推，解密时也是在解密后，进行异或运算，生成最终的
35、明文。过程如下：明文（63字节）密钥（16字节）初始向量iv（16字节）明文1（16字节）明文2（16字节）明文3（16字节）明文4+一个0（16字节）异或+初始向量+密文1+密文2+密文3密文1（16字节）密文2（16字节）密文3（16字节）密文4（16字节）密文（64字节）注意：1 .向量必须是一个与密钥长度相等的数据2 .由于在加密前和解密后都会做异或运算，因此我们的明文可以不用补全,不是16个字节的倍数也可以，CBC中会自动用0补全进行异或运算3 .在解密时是解密后才会再做异或运算，保证数据解密成功4 .由于自动进行了补全，所以解密出的数据也会在后面补全0,因此获取到数据时，需要将末尾
36、的0去除，或者根据源数据长度来截取解密后的数据。4.3.1.2SM3加密进行SM3加密时，COntent里的参数需经过排序，对所有传入参数按照字段名的ASCII码从小到大排序。例如登录的json：password：密码，username：用户名加密后的结果：10bde1.ed66dd9816edbdf504cc0776ee1.85c43e4d3fc8bb30588ec3424.3.2称重检测信息4.3.2.1称重检测数据上传接口接口说明检测系统将称重检测数据推送给治超系统（包括省级/市县级平台、部级平台），实时推送。检测系统为客户端，治超系统为服务端。根据VehiCIeTyPe（车辆类型）：O
37、-非货运车辆；I-违法超限超载货车；2-合法装载货车，使用不同的SERVER_PATH将不同车辆类型的结构化数据上传到相应的服务器。SERVER_PATH在治超系统IP规划完成后给出。接口地址httpsSERVERPATH)zcapicheckWeightdataUp1.oad请求方式POST请求示例消息头RequsetHeadersRequestMethodPOSTsysCode1000distCode350700dataSM366c7ft)1462eeedd9d1f2d46bdc10e4e24167c4875cf2f7a2297daO2b8f4ba8eOAuthorization登录成功后
38、返回的tokenContent-Typeapp1.ication/json消息体Content(checkNo:“120”，siteName:“兴礼站”，,site1.d:,1.aneNumber02,equip1.dn:,Gh,FheckTypdTT,checkTime:n2019-12-0915:49:07.777,vehic1.eTypen:1,nVehic1.eNon:京W88888,p1.ateCo1.or,0,“vehic1.eAx1.esType:“02，tota:1000,ax1.es:4,weight,:120,weight2,1:120,weight3,1:120,weig
39、ht4,:120,weight5:120,weight6:120,weight7,1:120,speed:60,nIimitWeightn:6000,overWeight:1000,overRate:0.0,tota1.1.ength,:10000,tota1.Widthn:6000,tota1.Height:5000,oVer1.ength”:0,“overWidth”:。，,overHeightrO,bu1.kVehic1.e:,00,1.icNo:nu1.1.,nVehic1.e1.istTypen:2,direction:2,obu1.d:nu1.1.,nObuVehicIeNo:京W88888”，nObuP1.ateCo1.orn:2,nObuVehic1.eTypen:11,obuVehic1.eCustomTypen:1,nObuTota1.Massn:1000,nObuMaintenanceMass:1000,nObuPennittedTowWeight,1:2000,n
