《环保与公安、交通数据接口规范》

环保与公安、交通数据接口规范江苏省机动车排气检测规范环保与公安、交通数据接口规范江苏省环保厅机动车排气污染监督管理中心二0一一年一月目录前言III环保、公安和交通之间数据接口规范11适用范围12规范性引用文件13术语和定义131WEBSERVICE132XML14规范说明141数据交换方式142数据交换周期143硬件及网络要求244日志记录245数据交换格式25接口说明351接口列表352接口调用流程453接口约束454通用接口455环保上报数据接口556交警上报数据接口1557交通上报数据接口21前言为贯彻中华人民共和国环境保护法和中华人民共和国大气污染防治法，加强对机动车排气污染的检测、维修和违法查处工作的力度，实现环保与公安、交通数据和资源的共享，提高联合执法能力，控制机动车污染物排放，改善环境空气质量，制定本规范。本规范规定了环保与公安、交通部门数据交换的接口规范。本规范适用于对机动车排气监管要求高，且能与多个职能部门联合监管执法的地区或城市。本规范由江苏省环境保护厅提出。本规范为首次制订。本规范起草单位江苏省环保厅机动车排气污染监督管理中心。本规范由江苏省环境保护厅2011年1月20日批准。本规范自2011年2月1日实施。本规范由江苏省环保厅机动车排气污染监督管理中心负责解释。环保、公安和交通之间数据接口规范1适用范围本规范规定了环保与公安、交通职能部门之间数据交换方式与交换内容，提出了数据交换的基本思路，是江苏省各地方环保、公安、交通部门间须遵循的数据内容规范。本规范适用于按GB182852005点燃式发动机汽车排气污染物排放限值及测量方法（双怠速法及简易工况法）标准以及GB38472005车用压燃式发动机和压燃式发动机汽车排气烟度排放限值及测量方法标准进行污染物排放检测的新生产和在用汽车，为对机动车排气监管要求高，且能与多个职能部门联合监管执法的地区或城市使用。2规范性引用文件GB182852005点燃式发动机汽车排气污染物排放限值及测量方法（双怠速法及简易工况法）GB38472005车用压燃式发动机和压燃式发动机汽车排气烟度排放限值及测量方法HJ/T2892006汽油车双怠速法排气污染物测量设备技术要求HJ/T2902006汽油车简易瞬态工况法排气污染物测量设备技术要求HJ/T2912006汽油车稳态工况法排气污染物测量设备技术要求HJ/T2922006柴油车加载减速工况法排气烟度测量设备技术要求3术语和定义下列术语和定义适用于本规范。31WEBSERVICEWEBSERVICE是基于网络的、分布式的模块化组件，它执行特定的任务，遵守具体的技术规范，这些规范使得WEBSERVICE能与其他兼容的组件进行互操作。它主要利用HTTP和SOAP协议使数据在WEB上传输，SOAP通过HTTP调用商业对象执行远程功能调用，WEB用户能够使用SOAP和HTTP通过WEB调用的方法来调用远程对象。32XMLXML（EXTENSIBLEMARKUPLANGUAGE）即可扩展标记语言，它与HTML一样，都是SGMLSTANDARDGENERALIZEDMARKUPLANGUAGE，标准通用标记语言。XML是INTERNET环境中跨平台的，依赖于内容的技术，是当前处理结构化文档信息的有力工具。4规范说明41数据交换方式环保、公安、交通三个单位之间的数据交换均通过政府外网的政务信息交换平台来实现，根据政务信息交换平台提供的接口规范，各单位应开发提供资源服务的接口和服务程序，涉及到公安的数据需通过公安内部数据交换平台进行内外网数据交换。数据交换方式采用WEBSERVICE服务方法，通过调用对应的服务方法进行数据读写。42数据交换周期环保与交通之间实时数据交换，环保与公安之间数据交换为一天一次，环保和安检的接口采用调用的方式进行数据交换。143硬件及网络要求公安、环保和交通三者都需要设立专门的上传数据服务器。为保证数据传输速度，三者之间的网络带宽至少需要4M带宽。44日志记录三者之间在进行调用WEBSERVICE接口通信时，不管调用是否成功，都需在本地记录发送数据的日志。如果失败，记录相应的失败信息、时间等。45数据交换格式数据采用XML格式传输，以下是简要介绍，具体的格式将在随后的各种不同操作规程中详细给出451数据请求数据格式MESSAGEUNITCODE“单位编码“REQUESTNAME“接口请求名称“VERIFYID“验证编码“/REQUEST/MESSAGE例如MESSAGEUNITCODE“001“VERIFYID“00110000001“REQUESTNAME“LOGOUT“/MESSAGE说明1、UNITCODE为环保、公安、交通三者之间的单位编码。2、VERIFYID为验证编码，当客户端每次登录后，服务端将返回客户端随机的验证编码，后续上传下载数据时，客户端每次请求都需要向服务端提供这个ID，服务端会根据这个ID做合法性判断。452服务应答各单位系统在收到上报数据后，需要以XML格式反馈数据上报是否成功，如果部分数据未上传成功，则需要将未成功的数据编码返回给服务请求者，当服务请求者在下次发送数据时，需要将未成功的数据再次发送。数据格式为MESSAGEUNITCODE“001“RESPONDNAME“应答名称“VERIFYID“验证编码“RESULT/ERRORMESSAGE/RESPOND/MESSAGE其中RESULT元素是上报成功结果0上传成功；1部分上传成功；2上传失败；1服务器故障。ERRORMESSAGE保存了上传失败的原因或者是未上传成功数据的记录编号，其中每条记录的编号以“”分开，如101130。如果请求具体车辆信息或者检测结果信息，服务应答的数据格式为MESSAGEUNITCODE“001“RESPONDNAME“应答名称“VERIFYID“验证编码“2ROW返回的数据内容/ROW/RESPOND/MESSAGE每个数据实例放在一个ROW结点里。5接口说明51接口列表512环保数据接口列表5122与安检数据接口5123与交通数据接口513交警数据接口列表352接口调用流程53接口约束1、每次上传的数据，最大不能超过100条记录；2、如果数据内容为空，则以”表示；3、如果日期为空，则以00000000000000表示；4、同一天内同一车辆的数据需取最近时间的数据。54通用接口541系统登录接口环保、公安或交通任一单位在上报数据前，需连接欲上报的服务器系统，发送如下格式的数据，验证其是否具备数据上报的权限。数据格式MESSAGEUNITCODE“单位编码“REQUESTNAME“LOGIN“ROWUSERUSERID/USERPWDUSERPASSWORD/PWD/ROW/REQUEST/MESSAGE服务器收到登录验证信息后进行验证，无论用户信息验证是否通过，这时服务器返回的是“应答验证数据”数据包，在此数据包中返回验证是否成功信息，同时每次登录后，服务端需要随机返回验证编码，后续上传下载数据时，每次都需要向服务端提供这个ID，服务端会根据这个ID做合法性判断。服务应答MESSAGEUNITCODE“单位编码“VERIFYID“验证编码“RESPONDNAME“VERIFY“ROWRESULT验证结果/RESULTERRORMESSAGE/ERRORMESSAGE/ROW/RESPOND/MESSAGE41、RESULT元素的值如下0该用户不存在1该用户无此权限2用户密码错误1服务器故障2、如果发生了错误，ERRORMESSAGE以文本形式给出具体的错误原因，比如XML文件中某个字段名不正确、某个数据格式不正确等。各单位开发者可根据此ERRORMESSAGE中的详细描述判断问题所在。542注销登录接口环保、公安或交通任一单位在上报数据结束后，需注销本次用户的登录信息，发送如下格式的数据数据格式MESSAGEUNITCODE“单位编码“VERIFYID“验证编码“REQUESTNAME“LOGOUT“ROWUSERUSERID/USERPWDUSERPASSWORD/PWD/ROW/REQUEST/MESSAGE服务端根据验证编码，确定注销信息后完成用户的注销操作。应答MESSAGEUNITCODE“单位编码“VERIFYID“验证编码“RESPONDNAME“VERIFY“ROWRESULT验证结果/RESULTERRORMESSAGE/ERRORMESSAGE/ROW/RESPOND/MESSAGERESULT元素的值如下0注销成功1服务器故障如果发生了错误，ERRORMESSAGE以文本形式给出具体的错误原因，比如XML文件中某个字段名不正确、某个数据格式不正确等。各单位开发者可根据此ERRORMESSAGE中的详细描述判断问题所在。55环保上报数据接口551交警数据接口5511交警布控源信息接口本接口用于环保上报给交警的布控源信息，主要包括检测超标及违规的车辆信息。数据格式MESSAGEUNITCODE“单位编码“VERIFYID“验证编码“REQUESTNAME“UPLOADDISPATCHEDSOURCEINFO“ROWNID/CNUMBERPLATE/5CPLATETYPE/CVEHICLETYPE/CDISPATCHKIND/DDISPATCHDATE/CDISPATCHREASON/CDISPATCHREMARKS/CUNITNAME/CPERSONNAME/NPHONENUMBER/ROW/REQUEST/MESSAGE65512黄标车数据信息接口本接口用于环保上报给交警黄标车数据。MESSAGEUNITCODE“单位编码“VERIFYID“验证编码“REQUESTNAME“UPLOADYELLOWSIGNVEHICLEINFO“ROWNID/CNUMBERPLATE/CPLATETYPE/CVEHICLETYPE/COPERATEKIND/ROW/REQUEST/MESSAGE552与安检数据接口5521机动车基本信息接口本接口用于安检获取环保提供的机动车基本信息。数据请求MESSAGEUNITCODE“单位编码“VERIFYID“验证编码“REQUESTNAME“GETSAFEVEHICLEINFO“ROWCNUMBERPLATE/7CPLATETYPE/CVEHICLETYPE/ROWREQUEST/MESSAGE数据应答MESSAGEUNITCODE“单位编号“RESPONDNAME“GETSAFEVEHICLEINFO“ROWVEHICLECNUMBERPLATE/CPLATETYPE/CVEHICLETYPE/CVIN/REGISTERDATE/VEHICLETYPE/VEHICLEMODEL/GEARBOXTYPE/ADMISSIONMODE/VOLUME/ODOMETER/FUELTYPE/SUPPLYMODE/RATEDREV/RATEDPOWER/DRIVEMODE/OWNER/PHONE/ADDRESS/MAXMASS/REFMASS/HASPURGE/ISEFI/8MAXLOAD/CARORTRUCK/CYLINDER/VEHICLE/ROW/RESPOND/MESSAGE9105522排气污染检测结果接口本接口用于环保上报安检机动车排气污染检测结果信息。数据格式MESSAGEUNITCODE“单位编码“VERIFYID“验证编码“REQUESTNAME“GETCHECKRESULTINFO“ROWCNUMBERPLATE/CPLATETYPE/CVEHICLETYPE/ROWREQUEST/MESSAGE服务应答MESSAGEUNITCODE“单位编号“REQUESTNAME“GETCHECKRESULTINFO“ROWCNUMBERPLATE/CPLATETYPE/CVEHICLETYPE/NCHECKTYPE/NCHECKKIND/DCHECKDATE/CUNITCODE/NBISCHECKOUT/ROW/REQUEST/MESSAGE11553与交通数据接口5531车辆维修源信息接口本接口用于环保上报交通车辆维修源信息。数据格式MESSAGEUNITCODE“单位编码“VERIFYID“验证编码“REQUESTNAME“UPLOADMAINTENANCEINFO“ROWNID/CNUMBERPLATE/CPLATETYPE/CVEHICLETYPE/DMAINTENANCEDATE/CUNITCODE/12CPERSONNAME/ROW/REQUEST/MESSAGE5532排气污染检测结果接口本接口用于环保上报交通部门机动车排气污染检测结果信息。数据格式MESSAGEUNITCODE“单位编码“VERIFYID“验证编码“REQUESTNAME“UPLOADCHECKRESULTINFO“ROWNID/CNUMBERPLATE/CPLATETYPE/CVEHICLETYPE/NCHECKTYPE/NCHECKKIND/DCHECKDATE/CUNITCODE/CGASCHECKITEM/CDIESELCHECKITEM/NBISCHECKOUT/ROW/REQUEST13/MESSAGE1456交警上报数据接口561机动车基本信息接口本接口用于环保获取交警提供的机动车基本信息。数据格式MESSAGEUNITCODE“单位编码“VERIFYID“验证编码“REQUESTNAME“GETPOLICEVEHICLEINFO“/MESSAGE数据应答MESSAGEUNITCODE“单位编号“RESPONDNAME“GETPOLICEVEHICLEINFO“ROWNID/CNUMBERPLATE/CPLATETYPE/CVEHICLETYPE/CVIN/REGISTERDATE/VEHICLETYPE/VEHICLEMODEL/GEARBOXTYPE/ADMISSIONMODE/VOLUME/ODOMETER/FUELTYPE/SUPPLYMODE/RATEDREV/RATEDPOWER/DRIVEMODE/OWNER/PHONE/ADDRESS/MAXMASS/REFMASS/HASPURGE/ISEFI/15MAXLOAD/CARORTRUCK/CYLINDER/COPERATEKIND/ROW/RESPOND/MESSAGE1617562机动车过户信息接口本接口用于交警提供给环保的机动车过户信息。数据格式MESSAGEUNITCODE“单位编码“VERIFYID“验证编码“REQUESTNAME“UPLOADVEHICLETRANSFERINFO“ROWNID/CORIGINALNUMBERPLATE/CORIGINALPLATETYPE/CORIGINALOWNER/CCURRENTNUMBERPLATE/CCURRENTPLATETYPE/CCURRENTOWNER/DTRANSFERDATE/COPERATEKIND/ROW/REQUEST/MESSAGE18563机动车外地车转入信息接口本接口用于交警提供给环保的机动车外地车转入信息。数据格式MESSAGEUNITCODE“单位编码“VERIFYID“验证编码“REQUESTNAME“UPLOADVEHICLESHIFTINFO“ROWNID/CORIGINALNUMBERPLATE/CORIGINALPLATETYPE/CORIGINALOWNER/CCURRENTNUMBERPLATE/CCURRENTPLATETYPE/CCURRENTOWNER/DSHIFTDATE/COPERATEKIND/ROW/REQUEST/MESSAGE19564机动车环保违法信息接口本接口用于交警提供给环保的关于环保类的机动车交通违法信息。数据格式MESSAGEUNITCODE“单位编码“VERIFYID“验证编码“REQUESTNAME“UPLOADVEHICLEILLEGALINFO“ROWNID/CNUMBERPLATE/CPLATETYPE/CVEHICLETYPE/CILLEGALDATE/CILLEGALADDRESS/CBEHAVIOR/CUNITCODE/CFINES/CPERSON/NPROCESSRESULT/ROW/REQUEST/MESSAGE2057交通上报数据接口571车辆维修企业信息接口本接口用于