江苏省运输管理综合信息服务平台GPS数据采集接口协议(1

第1页共36页江苏省运输管理综合信息服务平台GPS数据采集接口协议V1.3江苏省交通厅运管局2009.12第2页共36页版本修改记录日期版本说明修改内容作者2009-10-231.3.0初始版本韩松2009-12-101.3.1正式版本1、调整了8.2表2中车辆类型2、增加了公交车营运线路数据的补充规约，见第六部分韩松2010-1-51.3.2正式版本1、更新了一些文字描述错误2、更正了客运车辆载客数据规约中的数据范例韩松第3页共36页阅读指南【手册目标】本规范是车船GPS基本信息转发的接口协议介绍。本规范详细介绍了车辆、船舶GPS的接口标准及要求，通过阅读本规范，能够了解市运管处对GPS数据采集的范围、方式、以及具体实现的接口开发的方法。【阅读对象】本手册是为实现GPS数据转发的开发人员及相关负责人编写的。阅读者应该具备一定的开发基础知识，对系统有一定的了解。在开发系统接口前，请仔细阅读本手册的各章节。【内容简介】本手册包含如下内容：第一部分：概述。概要GPS信息采集的基本情况，以及一些常用的术语、缩略语。第二部分：技术要求，描述了对接数据的要求和技术要求。第三、四、五、六部分：数据规约。详尽的介绍了数据传递接口的格式，对接口中数据的含义进行了描述。第七部分：描述了危险品车辆的载货信息和客运车辆的载客信息网上填报的要求。第八部分：数据的编码对照表。第4页共36页一概述1.1.简要描述近年来，随着社会经济与交通运输业的飞速发展，交通安全和交通运输信息化越来越成为运输行业主管部门关注的两个重要问题。运输主管部门作为交通运输的管理单位，有责任和必要采取措施加强安全防范。其中一个有效的途径就是充分利用信息化手段，在安全问题发生之前尽可能地发现，并将其消除于端倪。交通信息化担负着协助管理、提供决策分析的重要使命。省运输管理局从行业管理平台的要求出发，考虑到运输业现有系统建设状况、交通行业信息化建设状况、行业资源的利用状况等各类情况，决定建设一个综合的GPS管理平台。通过此平台的建设，建立GIS地理信息功能、建立全行业的GPS接入和管理功能，以加强对营运及船舶的监控，有效预防交通运输事故，提高应急处理能力，并实现资源共享，为管理部门提供有效的车辆管理、监督、安全监控手段，为有关部门制定决策提供科学依据。通过预防为主、事前监督来降低行车事故发生率；通过信息共享，强化车辆管理手段和市场秩序，提高行业宏观调控和监管力度；利用新型数字化管理增强监管能力，促使运输行业管理再上新台阶。本规范就是为了实现以上目标而制定的GPS数据转发协议，要求各运营商实时将GPS基本信息按照密度要求转发给各地市GPS数据采集服务器。图一描述了目前各地市GPS使用情况以及本规范要求未来实现的拓扑图。第5页共36页图一1.2.术语及缩略语序号术语解释1GPSGLOBALPOSITIONINGSYSTEM。2江苏省运输管理综合信息服务平台省运管局建设的省市两级软件平台，系统的建设主要体现对外和对内两个层面，对外：加强数据资源、网络资源、应用界面等方面的深层次整合，加强与社会的互动，为社会公众提供更多的信息访问渠道，第6页共36页为公众提供更方便快捷的服务。3运营商是指提供GPS服务的厂家和公司。二技术要求2.1.上报数据要求2.1.1.车船GPS实时数据序号数据名称备注1运营商编号（ServerID）★例如：NJ09001表示某服务商编号，由长天智远公司分配，测试时可以填写本公司的拼音字母缩写，或联系长天智远公司相关人员，以方便各运营商间数据区分开。2地区编码★3车船类型★4车型代码★5车牌号码（船舶名称）★6车牌颜色★7报警类型8超速时长9经度★10纬度★11装载信息12速度★13方向14海拔高度15时间★说明数据上报方式：通过接口程序上报数据上报频率：15~60秒/条以上数据旁加★的，为必须上报的信息第7页共36页2.1.2.危险品车船载货信息序号数据名称备注1运营商编号（ServerID）★2地区编码★3车牌号码（船舶名称）★4车牌颜色★5挂车车牌号6危险品名称★7危险品分类编码★8应急处置方案9装载数量★10装载还是卸载★11装载(卸载)时间★12是否满载★13驾驶员姓名★14押运员姓名15驾驶员从业资格证号★16押运员从业资格证号★有押运员此项目就要上报17驾驶员联系电话18押运员联系电话19拖运单位★20始发地名称★21目的地名称★说明数据上报方式：通过接口程序上报数据上报频率：不得低于每天一次，如有信息更新及时上报以上数据旁加★的，为必须上报的信息2.1.3.客运车辆载客信息序号数据名称备注1运营商编号（ServerID）★2地区编码★3车牌号码★4车牌颜色★5驾驶员1姓名★6驾驶员1从业资格证号★7驾驶员1联系电话第8页共36页8驾驶员2姓名9驾驶员2从业资格证号10驾驶员2联系电话11乘务员姓名12乘务员从业资格证号13乘务员联系电话14经营区域★15始发地名称★16终到地名称★17始发站名称★18终到站名称★19发车时间★20预计到站时间★21载客数量★22里程数★说明数据上报方式：通过接口程序上报数据上报频率：不得低于每天一次，如有信息更新及时上报以上数据旁加★的，为必须上报的信息2.2.数据发送要求1.车船的GPS实时信息，上报的频率不得低于60秒/次。2.上报车般GPS实时信息时，各运营商的GPS平台需保证7x24小时连接到运管的综合服务平台，因网络故障造成的短时间中断除外。3.车船所装载的危险货物信息，有更新就上传，但每天至少上传一次。4.客运车辆载客信息，有更新就上传，但每天至少上传一次。5.为了保证数据传输的实时性与可靠性，各运营商GPS平台需要保证足够的带宽与运营的综合服务平台连接，建议带宽512K以上。2.3.网上填报考虑到有些运营商没有条件上报危险品车辆的载货信息和客运车辆的载客信息，系统提供了网上填报危险品车辆的载货信息和客运车辆的载客信息的功能，运输企业通过Internet网络，就可以上报危险品车辆的载货信息和客运车辆第9页共36页的载客信息，网上填报的具体要求见文档的第六部分。三车船GPS数据规约3.1.数据发送要求数据发送频率要求：满足15秒-60秒/条。数据传送连接方式：TCP方式，长连接方式（如果中途断掉请重新连接）。测试用服务器地址为：218.206.106.110端口：8001数据编码要求：数据要用UTF8格式进行编码。数据链路要求：1.一个数据提供者（一个IP地址）只允许与服务器有一个连接。如果有多个链接，只会与第一个链接，其他链接服务器将主动中断。2.数据提供者的链接，服务器将做IP地址的验证，运营商在发送数据前请申报发送的IP地址，IP地址请不要随意更换。3.数据提供者如果连续3分钟没有发数据，服务器将认为连接中断，将主动中断数据提供者的数据链路。如果想保持与服务器连接，请发送心跳数据包（见3.5）。3.2.GPS数据规约下表是一条GPS报文所包含的数据，必填项是不能为空的：序号名称标识必填说明1命令头*是一条报文开始标志2数据类型DataType是GPS数据填写03数据版本DataVersion是例如：1.0表示1.0版本，此协议版本为1.34运营商编号ServerID是0001表示某运营商编号，由长天智远公司分配，测试时可以填写本公司的拼音字母缩写，或联系长天智远公司相关人员，以方便各运营商间数据区分开。5地区编码AreaCode是地区编码(见表1)6车船类型VehicleType是车船类型(见表2)第10页共36页7车型代码VehicleModel是车型代码(见表3)，如果是船舶此项可空着8车牌号码VehicleNum是车牌(船)号码全称9车牌颜色PlateColor是1蓝色，2黄色，3黑色，4白色，9其他，(见表4)10时间RecordTime是YYMMDDHHmmss，年、月、日、时、分、秒都是两位数，不足两位前面补0，时间为24小时制，例如0805121413252008年05月12日14点13分25秒11经度Longitude是118.2312换算成10进制度格式12纬度Latitude是32.1325换算成10进度格式13装载情况Stowage否出租车：表示是否载客，0未载客，1已载客城市公交车：表示载客人数例：32表示载客为32人客车：表示载客人数货车：表示装载货物的吨数无法提供空着14报警类型Alarm是报警类型(见表5)15超速时长OverSpeedTime否052表示超速度52秒，最大999秒16速度Speed否23.3表示23.3公里/小时，无法提供空着17方向角Direction否78.2表示方向角为78.2度，无法提供空着18海拔高度Altitude否10.3表示海拔10.3米，无法提供空着19结束符#是一条报文结束标志3.3.GPS数据报文格式数据间以逗号“,”分隔，数据要用UTF8格式进行编码，以下是报名格式：*DataType,DataVersion,ServerID,AreaCode,VehicleType,VehicleModel,VehicleNum,PlateColor,RecordTime,Longitude,Latitude,Stowage,Alarm,OverSpeedTime,Speed,Direction,Altitude#DataType：填写0DataVersion：填写1.3ServerID：某服务商编号，由长天智远公司分配，测试时可以填写本公司的拼音字母缩写，或联系长天智远公司相关人员，以方便各运营商间数据区分开VehicleNum：车牌(船)号码全称，如：苏A123456PlateColor：见表4Alarm：见表5RecordTime：日期格式，YYMMDDHHmmss，年、月、日、时、分、秒都是两位第11页共36页数共12位，不足两位前面补0，时间为24小时制，例如0905121413252009年05月12日14点13分25秒3.4.数据范例可以单条记录发送：*0,1.3,NJ09001,NJ,10,A1,车船号码,2,090512141325,118.212,32.24253,0,0,,60.4,0,0#以上例子中“超速时长”不是必填项，所以可以空着。也可以多条记录拼在一起发送给服务器。*0,1.3,NJ09001,NJ,10,A1,车船号码,2,090512141325,118.212,32.24253,0,0,,60.4,0,0#*0,1.3,NJ09001,NJ,10,A1,车船号码,2,090512141325,118.212,32.24253,0,0,,60.4,0,0#*0,1.3,NJ09001,NJ,10,A1,车船号码,2,090512141325,118.212,32.24253,0,0,,60.4,0,0#*0,1.3,NJ09001,NJ,10,A1,车船号码,2,090512141325,118.212,32.24253,0,0,,60.4,0,0#以上例子是四条GPS数据拼在一起发送。3.5.心跳数据包运营商在没有车辆GPS数据时，如果不想让通讯链路被服务器断掉，运营商可以每三分钟发一次心跳数据包，以保证通讯链路的畅通。心跳数据包格式：*99,OK#四危险品车辆载货信息（补充规约）4.1.数据发送要求数据发送频率要求：不得低一每天一次，如有信息更新及时上报。数据传送连接方式：TCP方式。第12页共36页测试用服务器地址为：218.206.106.110端口：8002数据编码要求：数据要用UTF8格式进行编码。登录请求流程：1.数据提供者，首先发送登录请求信息。2.数据提供者，接收服务器的返回信息。3.数据提供者，如果收到登录成功确认，之后就可以发送危险品车船的载货信息了。4.数据提供者，如果收到登录失败（服务器发送登录失败信息后，会断开与客户端的连接），请断开重新连接，从流程第1步开始。5.数据提供者，如果收不到服务器的返回信息，过几秒钟重新发送登录请求信息。6.