环保与公安交通数据接口规范.pdf
《环保与公安交通数据接口规范.pdf》由会员分享,可在线阅读,更多相关《环保与公安交通数据接口规范.pdf(27页珍藏版)》请在冰豆网上搜索。
![环保与公安交通数据接口规范.pdf](https://file1.bdocx.com/fileroot1/2022-10/9/662c3c0c-b0a3-43f8-b368-2963f2db6db5/662c3c0c-b0a3-43f8-b368-2963f2db6db51.gif)
江苏省机动车排气检测规范环保与公安、交通数据接口规范江苏省环保厅机动车排气污染监督管理中心二0一一年一月目录前言.III环保、公安和交通之间数据接口规范.11适用范围.12规范性引用文件.13术语和定义.13.1WebService.13.2XML.14规范说明.14.1数据交换方式.14.2数据交换周期.14.3硬件及网络要求.24.4日志记录.24.5数据交换格式.25接口说明.35.1接口列表.35.2接口调用流程.45.3接口约束.45.4通用接口.45.5环保上报数据接口.55.6交警上报数据接口.155.7交通上报数据接口.21前言为贯彻中华人民共和国环境保护法和中华人民共和国大气污染防治法,加强对机动车排气污染的检测、维修和违法查处工作的力度,实现环保与公安、交通数据和资源的共享,提高联合执法能力,控制机动车污染物排放,改善环境空气质量,制定本规范。
本规范规定了环保与公安、交通部门数据交换的接口规范。
本规范适用于对机动车排气监管要求高,且能与多个职能部门联合监管执法的地区或城市。
本规范由江苏省环境保护厅提出。
本规范为首次制订。
本规范起草单位:
江苏省环保厅机动车排气污染监督管理中心。
本规范由江苏省环境保护厅2011年1月20日批准。
本规范自2011年2月1日实施。
本规范由江苏省环保厅机动车排气污染监督管理中心负责解释。
1环保、公安和交通之间数据接口规范1适用范围本规范规定了环保与公安、交通职能部门之间数据交换方式与交换内容,提出了数据交换的基本思路,是江苏省各地方环保、公安、交通部门间须遵循的数据内容规范。
本规范适用于按GB18285-2005点燃式发动机汽车排气污染物排放限值及测量方法(双怠速法及简易工况法)标准以及GB3847-2005车用压燃式发动机和压燃式发动机汽车排气烟度排放限值及测量方法标准进行污染物排放检测的新生产和在用汽车,为对机动车排气监管要求高,且能与多个职能部门联合监管执法的地区或城市使用。
2规范性引用文件GB18285-2005点燃式发动机汽车排气污染物排放限值及测量方法(双怠速法及简易工况法)GB3847-2005车用压燃式发动机和压燃式发动机汽车排气烟度排放限值及测量方法HJ/T289-2006汽油车双怠速法排气污染物测量设备技术要求HJ/T290-2006汽油车简易瞬态工况法排气污染物测量设备技术要求HJ/T291-2006汽油车稳态工况法排气污染物测量设备技术要求HJ/T292-2006柴油车加载减速工况法排气烟度测量设备技术要求3术语和定义下列术语和定义适用于本规范。
3.1WebServiceWebService是基于网络的、分布式的模块化组件,它执行特定的任务,遵守具体的技术规范,这些规范使得WebService能与其他兼容的组件进行互操作。
它主要利用HTTP和SOAP协议使数据在Web上传输,SOAP通过HTTP调用商业对象执行远程功能调用,Web用户能够使用SOAP和HTTP通过Web调用的方法来调用远程对象。
3.2XMLXML(ExtensibleMarkupLanguage)即可扩展标记语言,它与HTML一样,都是SGML(StandardGeneralizedMarkupLanguage,标准通用标记语言)。
XML是Internet环境中跨平台的,依赖于内容的技术,是当前处理结构化文档信息的有力工具。
4规范说明4.1数据交换方式环保、公安、交通三个单位之间的数据交换均通过政府外网的政务信息交换平台来实现,根据政务信息交换平台提供的接口规范,各单位应开发提供资源服务的接口和服务程序,涉及到公安的数据需通过公安内部数据交换平台进行内外网数据交换。
数据交换方式采用WebService服务方法,通过调用对应的服务方法进行数据读写。
4.2数据交换周期环保与交通之间实时数据交换,环保与公安之间数据交换为一天一次,环保和安检的接口采用调用的方式进行数据交换。
24.3硬件及网络要求公安、环保和交通三者都需要设立专门的上传数据服务器。
为保证数据传输速度,三者之间的网络带宽至少需要4M带宽。
4.4日志记录三者之间在进行调用webservice接口通信时,不管调用是否成功,都需在本地记录发送数据的日志。
如果失败,记录相应的失败信息、时间等。
4.5数据交换格式数据采用XML格式传输,以下是简要介绍,具体的格式将在随后的各种不同操作规程中详细给出:
4.5.1数据请求数据格式:
例如:
说明:
1、UnitCode为环保、公安、交通三者之间的单位编码。
2、VerifyID为验证编码,当客户端每次登录后,服务端将返回客户端随机的验证编码,后续上传下载数据时,客户端每次请求都需要向服务端提供这个ID,服务端会根据这个ID做合法性判断。
4.5.2服务应答各单位系统在收到上报数据后,需要以XML格式反馈数据上报是否成功,如果部分数据未上传成功,则需要将未成功的数据编码返回给服务请求者,当服务请求者在下次发送数据时,需要将未成功的数据再次发送。
数据格式为:
其中:
元素是上报成功结果:
0:
上传成功;1:
部分上传成功;2:
上传失败;-1:
服务器故障。
保存了上传失败的原因或者是未上传成功数据的记录编号,其中每条记录的编号以“:
”分开,如10:
11:
30。
如果请求具体车辆信息或者检测结果信息,服务应答的数据格式为:
3返回的数据内容每个数据实例放在一个结点里。
5接口说明5.1接口列表5.1.1通用接口接口名称接口定义备注登录Login注销Logout5.1.2环保数据接口列表5.1.2.1与交警数据接口接口名称接口定义备注交警布控的源信息数据UploadDispatchedSourceInfo黄标车车辆数据信息UploadYellowSignVehicleInfo5.1.2.2与安检数据接口接口名称接口定义备注机动车基本信息getSafeVehicleInfo排气污染检测结果getCheckResultInfo5.1.2.3与交通数据接口接口名称接口定义备注车辆维修源信息UploadMaintenanceInfo排气污染检测结果UploadCheckResultInfo5.1.3交警数据接口列表接口名称接口定义备注机动车基本信息getPoliceVehicleInfo机动车过户信息UploadVehicleTransferInfo机动车转入信息UploadVehicleShiftInfo机动车环保类违法信息UploadVehicleIllegalInfo5.1.4交通数据接口列表接口名称接口定义备注车辆维修企业信息UploadMaintenanceCompanyInfo车辆维修接收信息数据UploadAcceptCertificateInfo车辆维修合格数据UploadMaintenancePassInfo45.2接口调用流程系统登录上传/下载数据注销登录5.3接口约束1、每次上传的数据,最大不能超过100条记录;2、如果数据内容为空,则以”表示;3、如果日期为空,则以0000-00-0000:
00:
00表示;4、同一天内同一车辆的数据需取最近时间的数据。
5.4通用接口5.4.1系统登录接口环保、公安或交通任一单位在上报数据前,需连接欲上报的服务器系统,发送如下格式的数据,验证其是否具备数据上报的权限。
数据格式:
UserIDUserPassword服务器收到登录验证信息后进行验证,无论用户信息验证是否通过,这时服务器返回的是“应答验证数据”数据包,在此数据包中返回验证是否成功信息,同时每次登录后,服务端需要随机返回验证编码,后续上传下载数据时,每次都需要向服务端提供这个ID,服务端会根据这个ID做合法性判断。
服务应答:
验证结果51、Result元素的值如下:
0:
该用户不存在1:
该用户无此权限2:
用户密码错误-1:
服务器故障2、如果发生了错误,ErrorMessage以文本形式给出具体的错误原因,比如:
XML文件中某个字段名不正确、某个数据格式不正确等。
各单位开发者可根据此ErrorMessage中的详细描述判断问题所在。
5.4.2注销登录接口环保、公安或交通任一单位在上报数据结束后,需注销本次用户的登录信息,发送如下格式的数据:
数据格式:
UserIDUserPassword服务端根据验证编码,确定注销信息后完成用户的注销操作。
应答:
验证结果Result元素的值如下:
0:
注销成功-1:
服务器故障如果发生了错误,ErrorMessage以文本形式给出具体的错误原因,比如:
XML文件中某个字段名不正确、某个数据格式不正确等。
各单位开发者可根据此ErrorMessage中的详细描述判断问题所在。
5.5环保上报数据接口5.5.1交警数据接口5.5.1.1交警布控源信息接口本接口用于环保上报给交警的布控源信息,主要包括检测超标及违规的车辆信息。
数据格式:
6每个Row代表一条数据。
元素名称类型描述nIDVARCHAR编号最大12位cNumberPlateVARCHAR车牌号码最长9位cPlateTypeNUMBER车牌类型0:
蓝牌、1:
黄牌、2:
黑牌、3:
白牌cVehicleTypeVARCHAR车辆类型0:
汽油车(含天然气)、1:
柴油车、2:
三轮汽车和低速货车、3:
纯电动车、4:
摩托车cDispatchKindVARCHAR布控类别最长20位dDispatchDateDATETIME布控时间日期格式:
YYYY-MM-DDcDispatchReasonVARCHAR布控原因0:
逾期未检测1:
无检测合格凭证2:
闯入限行区域3:
其他cDispatchRemarksVARCHAR布控描述最长100位cUnitNameVARCHAR联系单位最长40位cPersonNameVARCHAR联系人最长10位7元素名称类型描述nPhoneNumberNUMBER联系电话最大20位5.5.1.2黄标车数据信息接口本接口用于环保上报给交警黄标车数据。
每个Row代表一条数据。
元素名称类型描述nIDVARCHAR编号最大12位cNumberPlateVARCHAR车牌号码最长9位cPlateTypeNUMBER车牌类型0:
蓝牌、1:
黄牌、2:
黑牌、3:
白牌cVehicleTypeVARCHAR车辆类型0:
汽油车(含天然气)、1:
柴油车、2:
三轮汽车和低速货车、3:
纯电动车、4:
摩托车cOperateKindVARCHAR操作类型0:
增加、1:
删除交警接口部分需要针对操作类型对环保类黄标车数据库进行相关操作。
5.5.2与安检数据接口5.5.2.1机动车基本信息接口本接口用于安检获取环保提供的机动车基本信息。
数据请求:
8元素名称类型描述cNumberPlateVARCHAR车牌号码最长9位cPlateTypeNUMBER车牌类型0:
蓝牌、1:
黄牌、2:
黑牌、3:
白牌cVehicleTypeVARCHAR车辆类型0:
汽油车(含天然气)、1:
柴油车、2:
三轮汽车和低速货车、3:
纯电动车、4:
摩托车数据应答:
9元素名称类型描述cNumberPlateVARCHAR车牌号码最长9位cPlateTypeNUMBER车牌类型0:
蓝牌1:
黄牌2:
黑牌3:
白牌cVehicleTypeVARCHAR车辆类型0:
汽油车(含天然气)、1:
柴油车、2:
三轮汽车和低速货车、3:
纯电动车、4:
摩托车VINVARCHARVIN号RegisterDateDATETIME车辆登记日期VehicleTypeNUMBER车辆类型。
0:
6座以下小型客车1:
6座以上小型客车2:
中型客车3