江苏省运输管理综合信息服务平台

1江苏省运输管理综合信息服务平台GPS数据转发接口规范V1.2.1江苏省交通厅运管局2008.092阅读指南【手册目标】本规范是车船GPS基本信息转发的接口协议介绍。本规范详细介绍了车辆、船舶GPS的接口标准及要求，通过阅读本规范，能够了解市运管处对GPS数据采集的范围、方式、以及具体实现的接口开发的方法。【阅读对象】本手册是为实现GPS数据转发的开发人员及相关负责人编写的。阅读者应该具备一定的开发基础知识，对系统有一定的了解。在开发系统接口前，请仔细阅读本手册的各章节。【内容简介】本手册包含如下内容：第一部分：概述。概要GPS信息采集的基本情况，以及一些常用的术语、缩略语。第二部分：接口标准。详尽的介绍了数据传递接口的格式，对接口中数据的含义进行了描述。3一概述1.1.简要描述近年来，随着社会经济与交通运输业的飞速发展，交通安全和交通运输信息化越来越成为运输行业主管部门关注的两个重要问题。运输主管部门作为交通运输的管理单位，有责任和必要采取措施加强安全防范。其中一个有效的途径就是充分利用信息化手段，在安全问题发生之前尽可能地发现，并将其消除于端倪。交通信息化担负着协助管理、提供决策分析的重要使命。省运输管理局从行业管理平台的要求出发，考虑到运输业现有系统建设状况、交通行业信息化建设状况、行业资源的利用状况等各类情况，决定建设一个综合的GPS管理平台。通过此平台的建设，建立GIS地理信息功能、建立全行业的GPS接入和管理功能，以加强对营运及船舶的监控，有效预防交通运输事故，提高应急处理能力，并实现资源共享，为管理部门提供有效的车辆管理、监督、安全监控手段，为有关部门制定决策提供科学依据。通过预防为主、事前监督来降低行车事故发生率；通过信息共享，强化车辆管理手段和市场秩序，提高行业宏观调控和监管力度；利用新型数字化管理增强监管能力，促使运输行业管理再上新台阶。本规范就是为了实现以上目标而制定的GPS数据转发协议，要求各运营商实时将GPS基本信息按照密度要求转发给各地市GPS数据采集服务器，图一描述了目前各地市GPS使用情况以及本规范要求未来实现的拓扑图。4图一51.2.术语及缩略语序号术语解释1GPSGLOBALPOSITIONINGSYSTEM。2江苏省运输管理综合信息服务平台省运管局建设的省市两级软件平台，系统的建设主要体现对外和对内两个层面，对外：加强数据资源、网络资源、应用界面等方面的深层次整合，加强与社会的互动，为社会公众提供更多的信息访问渠道，为公众提供更方便快捷的服务。3运营商是指提供GPS服务的厂家和公司。二接口规范定义1.1GPS信息要素要求各GPS运营平台上报的GPS数据中，必须包含但不限于以下要素：名称源码命名示例服务商编码ServerID0001表示某服务商编号地区编码AreaCode地区编码(见表1)车船类型VehicleType车船类型(见表2)车牌号码VehicleNum苏字省略，例如AY8888，表示苏AY8888超速报警AlarmSpeed1表示超速0表示没有超速超速时长OverSpeedTime052表示超速度52秒，最大999秒，无法提供填0纬度Latitude32.1325换算成10进度经度Longitude118.2312换算成10进制速度Speed23.3表示23.3公里/小时高度Altitude+10.3表示海拔10.3米方向角Direction78.2表示方向角为78.2度时间RecordTimeYYMMDDhhmmss例如0805121113252008年05月12日11点13分25秒61.2GPS信息密度要求GPS数据密度要求：满足15秒-60秒/条。三Socket接口数据报文格式本接口中报文传输格式为TCP/WebService方式，服务器TCP监听端口为：8001，长连接方式（如果中途断掉请重新连接）。测试用服务器地址为：218.206.106.110可以单条记录发送：*ServerID,XX,VehicleType，Mark,YYMMDDHHMMSS,AlarmSpeed,OverSpeedTime,latitude,longitude,speed,direction#也可以多条记录拼在一起发送给服务器。报文格式：*ServerID,XX,VehicleType，Mark,YYMMDDHHMMSS,AlarmSpeed,OverSpeedTime,latitude,longitude,speed,direction#*ServerID,XX,VehicleType，Mark,YYMMDDHHMMSS,AlarmSpeed,OverSpeedTime,latitude,longitude,speed,direction#其中：*命令头；ServerID服务商编号，统一分配；,分隔符；XX车辆所属地区名称，具体见表2.1；车船类型编码，见附表2.2；Mark车牌号码，去掉真实号码的第一个字，例如AY8888，表示苏AY8888；YYMMDDHHMMSS日期表示年月日小时分钟秒，例如：08520133412为北京时间2008年5月20日13点34分12秒；AlarmSpeed：1表示超速0表示没有超速；OverSpeedTime：052表示超速度52秒，最大999秒；Latitude：纬度，换算成10进制，保留四位小数，例如118.2312表示118.2312度；longitude：经度，换算成10进度，保留四位小数，例如32.1325表示32.1325度；Speed速度，范围000.00-999.99公路小时，保留两位小数；direction方位角，正北为0度，分辨率1度，顺时针方向；＃结束符。7四接口参数说明序号地区编码1南京NJ2苏州SZ3无锡WX4常州CZ5南通NT6扬州YZ7泰州TZ8镇江ZJ9徐州XZ10连云港LYG11盐城YC12淮安HA13宿迁SQ表1序号车船类型编码1客车102大型客车113中型客车124小型客车135轿车146大型卧铺客车157中型卧铺客车168出租车179普通货车2010大型普通货车2111中型普通货车22812小型普通货车2313专用运输车3014集装箱车3115大件运输车3216保温冷藏车3317商品运输专用车3418罐车3519牵引车3620挂车3721平板车3822其他专用车辆3923危险品运输车4029特种拖拉机6430其他车辆9031执法车辆9132船舶100表2五TCP接口范例利用TCP方式发送发送GPS数据：*NJ09002,NJ,10,A3950,080626093423,1,052,118.212,32.1232,56.3,0#描述：上述示例表示车牌号为1辆车的GPS数据。*NJ09002,NJ,10,A3950,080626093423,1,052,118.212,32.1232,56.3,0#*NJ09002,NJ,10,A3950,080626093423,1,052,118.212,32.1232,56.3,0#*NJ09002,NJ,10,A3950,080626093423,1,052,118.212,32.1232,56.3,0#*NJ09002,NJ,10,A3950,080626093423,1,052,118.212,32.1232,56.3,0#*NJ09002,NJ,10,A3950,080626093423,1,052,118.212,32.1232,56.3,0#*NJ09002,NJ,10,A3950,080626093423,1,052,118.212,32.1232,56.3,0#*NJ09002,NJ,10,A3950,080626093423,1,052,118.212,32.1232,56.3,0#描述：上述示例表示车牌号为7辆车的GPS数据。9六WebService接入方式WebService调用方法如下：///paramname=ServerID服务商编码/param///paramname=AreaCode地区编码/param///paramname=VehicleType车辆类型/param///paramname=VehicleNum车牌号码/param///paramname=AlarmSpeed超速报警/param///paramname=OverSpeedTime超速时长(秒)/param///paramname=Longitude经度(度格式)/param///paramname=Latitude纬度(度格式)/param///paramname=Speed速度(公里/小时)/param///paramname=Altitude海拔高度/param///paramname=Direction方位角/param///paramname=RecTime记录时间/param///returns标志|错误信息,标志:0(成功),1(数据格式错),2(其它错误)/returnspublicstringAddGPSPosInfo(stringServerID,stringAreaCode,stringVehicleType,stringVehicleNum,stringAlarmSpeed,stringOverSpeedTime,stringLongitude,stringLatitude,stringSpeed,stringAltitude,stringDirection,stringRecTime)接口的wsdl如下，其中WebService的部署时确定：?xmlversion=1.0encoding=utf-8?-wsdl:definitionsxmlns:soap=:tm=:soapenc=:mime=:tns=:s=:soap12=:http==:wsdl=:types10-s:schemaelementFormDefault=qualifiedtargetNamespace=:elementname=AddGPSPosInfo-s:complexType-s:sequences:elementminOccurs=0maxOccurs=1name=ServerIDtype=s:string/s:elementminOccurs=0maxOccurs=1name=XXtype=s:string/s:elementminOccurs=0maxOccurs=1name=VehicleTypetype=s:string/s:elementminOccurs=0maxOccurs=1name=Marktype=s:string/s:elementminOccurs=0maxOccurs=1name=AlarmSpeedtype=s:string/s:e