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

江苏省运输管理综合信息服务平台GPS数据采集接口协议V1.3江苏省交通厅运管局2009.12版本修改记录日期版本说明修改内容作者2009-10-231.3.0初始版本韩松2009-12-101.3.1正式版本1、 调整了8.2 表2中车辆类型2、 增加了公交车营运线路数据的补充规约，见第六部分韩松2010-1-51.3.2正式版本1、 更新了一些文字描述错误2、 更正了客运车辆载客数据规约中的数据范例韩松阅读指南【手册目标】本规范是车船GPS基本信息转发的接口协议介绍。本规范详细介绍了车辆、船舶GPS的接口标准及要求，通过阅读本规范，能够了解市运管处对GPS数据采集的范围、方式、以及具体实现的接口开发的方法。【阅读对象】本手册是为实现GPS数据转发的开发人员及相关负责人编写的。阅读者应该具备一定的开发基础知识，对系统有一定的了解。在开发系统接口前，请仔细阅读本手册的各章节。【内容简介】本手册包含如下内容：第一部分：概述。概要GPS信息采集的基本情况，以及一些常用的术语、缩略语。第二部分：技术要求，描述了对接数据的要求和技术要求。第三、四、五、六部分：数据规约。详尽的介绍了数据传递接口的格式，对接口中数据的含义进行了描述。第七部分：描述了危险品车辆的载货信息和客运车辆的载客信息网上填报的要求。第八部分：数据的编码对照表。一 概述1.1. 简要描述近年来，随着社会经济与交通运输业的飞速发展，交通安全和交通运输信息化越来越成为运输行业主管部门关注的两个重要问题。运输主管部门作为交通运输的管理单位，有责任和必要采取措施加强安全防范。其中一个有效的途径就是充分利用信息化手段，在安全问题发生之前尽可能地发现，并将其消除于端倪。交通信息化担负着协助管理、提供决策分析的重要使命。省运输管理局从行业管理平台的要求出发，考虑到运输业现有系统建设状况、交通行业信息化建设状况、行业资源的利用状况等各类情况，决定建设一个综合的GPS管理平台。通过此平台的建设，建立GIS地理信息功能、建立全行业的GPS接入和管理功能，以加强对营运及船舶的监控，有效预防交通运输事故，提高应急处理能力，并实现资源共享，为管理部门提供有效的车辆管理、监督、安全监控手段，为有关部门制定决策提供科学依据。通过预防为主、事前监督来降低行车事故发生率；通过信息共享，强化车辆管理手段和市场秩序，提高行业宏观调控和监管力度；利用新型数字化管理增强监管能力，促使运输行业管理再上新台阶。 本规范就是为了实现以上目标而制定的GPS数据转发协议，要求各运营商实时将GPS基本信息按照密度要求转发给各地市GPS数据采集服务器。图一描述了目前各地市GPS使用情况以及本规范要求未来实现的拓扑图。图一1.2. 术语及缩略语序号术语解释1GPSGLOBAL POSITIONING SYSTEM。2江苏省运输管理综合信息服务平台省运管局建设的省市两级软件平台，系统的建设主要体现对外和对内两个层面，对外：加强数据资源、网络资源、应用界面等方面的深层次整合，加强与社会的互动，为社会公众提供更多的信息访问渠道，为公众提供更方便快捷的服务。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时间 说明数据上报方式：通过接口程序上报数据上报频率：1560秒/条以上数据旁加的，为必须上报的信息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驾驶员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网络，就可以上报危险品车辆的载货信息和客运车辆的载客信息，网上填报的具体要求见文档的第六部分。三 车船GPS数据规约3.1. 数据发送要求l 数据发送频率要求：满足15秒-60秒/条。l 数据传送连接方式：TCP方式，长连接方式（如果中途断掉请重新连接）。测试用服务器地址为：218.206.106.110端口：8001l 数据编码要求：数据要用UTF8格式进行编码。l 数据链路要求：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)7车型代码VehicleModel是车型代码(见表3)，如果是船舶此项可空着8车牌号码VehicleNum是车牌(船)号码全称9车牌颜色PlateColor是1蓝色，2黄色，3黑色，4白色，9其他，(见表4)10时间RecordTime是YYMMDDHHmmss，年、月、日、时、分、秒都是两位数，不足两位前面补0，时间为24小时制，例如080512141325 2008年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 #l DataType：填写0l DataVersion：填写1.3l ServerID：某服务商编号，由长天智远公司分配，测试时可以填写本公司的拼音字母缩写，或联系长天智远公司相关人员，以方便各运营商间数据区分开l VehicleNum：车牌(船)号码全称，如：苏A123456 l PlateColor：见表4l Alarm：见表5l RecordTime：日期格式，YYMMDDHHmmss，年、月、日、时、分、秒都是两位数共12位，不足两位前面补0，时间为24小时制，例如090512141325 2009年05月12日14点13分25秒3.4. 数据范例l 可以单条记录发送：*0,1.3,NJ09001,NJ,10,A1,车船号码,2,090512141325,118.212,32.24253,0,0, ,60.4,0,0 #以上例子中“超速时长”不是必填项，所以可以空着。l 也可以多条记录拼在一起发送给服务器。*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. 数据发送要求l 数据发送频率要求：不得低一每天一次，如有信息更新及时上报。l 数据传送连接方式：TCP方式。测试用服务器地址为：218.206.106.110端口：8002l 数据编码要求：数据要用UTF8格式进行编码。l 登录请求流程：1. 数据提供者，首先发送登录请求信息。2. 数据提供者，接收服务器的返回信息。3. 数据提供者，如果收到登录成功确认，之后就可以发送危险品车船的载货信息了。4. 数据提供者，如果收到登录失败（服务器发送登录失败信息后，会断开与客户端的连接），请断开重新连接，从流程第1步开始。5. 数据提供者，如果收不到服务器的返回信息，过几秒钟重新发送登录请求信息。6. 登录后，数据提供者如需保持连接发送数据，应每1分钟发送一个心跳数据包来进行链路保持。连续3分钟没有接收到心跳数据包，服务器将认为连接中断，将主动中断数据提供者的数据链路。数据提供者如连续3分钟未收到服务器的回应数据包，则认为与服务器连接中断，可主动断开数据链路。l 数据发送流程：1. 如果服务器返回登录成功确认信息，数据提供者就可以发送危险品车船的载货数据了。2. 每发送一次数据，服务器都会返回接收的信息。可以根据返回的信息来确认数据是否发送成功。4.2. 登录系统4.2.1. 登录请求信息数据列表序号名称命名必填说明1命令头*是一条报文开始标志2命令编号CmdNum是登录请求为013服务商编码ServerID是4结束符#是一条报文结束标志命令格式：*01,ServerID#4.2.2. 登录成功返回信息登录请求如果成功，服务器会返回如下信息：数据格式：*01#4.2.3. 登录失败返回信息登录请求如果失败，服务器会返回如下信息：数据格式：*02,错误代码#服务器发送完信息后，会强行断开与客户端的连接。错误代码说明01数据格式错误02非法服务商编码错误03服务商已停用04其它错误4.3. 链路测试数据规约4.3.1. 链路测试请求序号名称命名必填说明1命令头*是一条报文开始标志2命令编号CmdNum是链路测试请求为993服务商编码ServerID是4结束符#是一条报文结束标志命令格式：*99,ServerID#4.3.2. 链路测试返回信息返回数据格式：*99,OK#4.4. 车船危险货物数据规约各上报的危险品数据中，必须包含但不限于以下要素：序号名称标识必填说明1命令头*是一条报文开始标志2数据类型DataType是车辆危险品数据填写13数据版本DataVersion是例如：1.0表示1.0版本，此协议版本为1.04运营商编号ServerID是例如：NJ09001表示某运营商编号，由长天智远公司分配，测试时可以填写本公司的拼音字母缩写，或联系长天智远公司相关人员，以方便各运营商间数据区分开。5地区编码AreaCode是见数据编码说明6车牌(船)号码VehicleNum是车牌(船)号码全称，请注意要用UTF8进行编码7车牌颜色PlateColor是(见表4)8挂车车牌号TrailerNum否有挂车填写，没有空着9危险品名称DGName是请注意要用UTF8进行编码10危险品分类编码DGClassCode是(见表6)11应急处置方案DisposalProject否请注意要用UTF8进行编码12装载数量LoadAmount是不能为空，没有值请填写013装载还是卸载LoadUnload是0：卸载，1：装载14装载(卸载)时间DateTime是YYMMDDHHmmss，年、月、日、时、分、秒都是两位数共12位，不足两位前面补0，时间为24小时制，例如090512141325 2009年05月12日14点13分25秒15是否满载LoadFull是0：否，1：是16驾驶员姓名Driver是请注意要用UTF8进行编码17驾驶员从业资格证号DriverQualCert是18驾驶员联系电话DriverTel否19押运员姓名Guard否请注意要用UTF8进行编码20押运员从业资格证号GuardQualCert是如果有押运员，此信息一定要报21押运员联系电话GuardTel否22拖运单位HaulageCompany是请注意要用UTF8进行编码23始发地名称Origin是请注意要用UTF8进行编码24目的地名称Destination是请注意要用UTF8进行编码25结束符#是一条报文结束标志4.4.1. 车船危险品数据报文格式数据间以逗号“,”分隔，数据要用UTF8格式进行编码，以下是报名格式：*DataType,DataVersion,ServerID,AreaCode,VehicleNum,PlateColor,TrailerNum,DGName,DGClassCode,DisposalProject,LoadAmount,LoadUnload,DateTime,LodFull,Driver,DriverQualCert,DriverTel,Guard,GuardQualCert,GuardTel,HaulageCompany,Origin,Destination#l 报文中的“,”为分隔符。l DataType：填写1l DataVersion：填写1.0l ServerID：某服务商编号，由长天智远公司分配，测试时可以填写本公司的拼音字母缩写，或联系长天智远公司相关人员，以方便各运营商间数据区分开l VehicleNum：车牌(船)号码全称，如：苏A123456, 请注意要用UTF8进行编码l PlateColor：见表4l DGName：危险品名称。请注意要用UTF8进行编码l DGClassCode：危险品分类编码，见表6。l DisposalProject：应急处置方案。l Driver：驾驶员姓名。l Guard：押运员姓名。l HaulageCompany：拖运单位。l Origin：始发地名称。l Destination：目的地名称。l DateTime：装载(卸载)时间，日期格式，YYMMDDHHmmss，年、月、日、时、分、秒都是两位数共12位，不足两位前面补0，时间为24小时制，例如090512141325 2009年05月12日14点13分25秒4.4.2. 数据范例l 可以单条记录发送：*1,1.0,NJ09001,NJ,苏A12345,2,苏A37273挂,危险品名称,11,处置方案,10.5,1,090512141325,1,驾驶员姓名,从业资格证号,驾驶员电话,押运员姓名,从业资格证号,押运员电话,拖运单位,始发地名称,目的地名称#l 也可以多条记录拼在一起发送：*1,1.0,NJ09001,NJ,苏A12345,2,苏A37273挂,危险品名称,11,处置方案,10.5,1,090512141325,1,驾驶员姓名,从业资格证号,驾驶员电话,押运员姓名,从业资格证号,押运员电话,拖运单位,始发地名称,目的地名称#*1,1.0,NJ09001,NJ,苏A12345,2,苏A37273挂,危险品名称,11,处置方案,10.5,1,090512141325,1,驾驶员姓名,从业资格证号,驾驶员电话,押运员姓名,从业资格证号,押运员电话,拖运单位,始发地名称,目的地名称#上面是两条数据一起发送。4.4.3. 数据接收成功返回信息危险品数据如果接收成功，服务器会返回如下信息：数据格式：*03,接收数据条数#4.4.4. 数据接收失败返回信息危险品数据如果接收失败，服务器会返回如下信息：数据格式：*04,错误代码,附加信息#错误代码说明01数据格式错误，附加信息中会有错误格式的命名列表。02非法服务商编码错误03服务商已停用04其它错误例：*04,01, AreaCode|DateTime#以上说明数据格式错误，其中地区编码（AreaCode）与装载(卸载)时间（DateTime）格式有错误。4.5. WebService接口规约4.5.1. 接口定义Public string SendVehicleDangerousGoods(string serverID, string data);4.5.2. 数据格式接口中参数data是要发送的数据，数据格式如下： 1.0NJ苏A1234561苏A8888挂危险品名称11应急处置方法2512009-09-10 13:23:460张三123456789034324324324李四2345345454351234567890XXXX公司南京上海1.0NJ苏A1234561苏A8888挂危险品名称11应急处置方法2512009-09-10 13:23:460张三123456789034324324324李四2345345454351234567890XXXX公司南京上海. . . 返回值格式：01数据格式错误5 错误代码说明00没有错误01数据格式错误，附加信息中会有错误格式的命名列表。02非法服务商编码错误03服务商已停用04其它错误五 客运车辆载客数据规约（补充规约）5.1. 数据发送要求l 数据发送频率要求：不得低一每天一次，如有信息更新及时上报。l 数据传送连接方式：TCP方式。测试用服务器地址为：218.206.106.110端口：8002l 数据编码要求：数据要用UTF8格式进行编码。l 登录请求流程：1. 数据提供者，首先发送登录请求信息。2. 数据提供者，接收服务器的返回信息。3. 数据提供者，如果收到登录成功确认，之后就可以发送客运车辆载客信息了。4. 数据提供者，如果收到登录失败（服务器发送登录失败信息后，会断开与客户端的连接），请断开重新连接，从流程第1步开始。5. 数据提供者，如果收不到服务器的返回信息，过几秒钟重新发送登录请求信息。6. 登录后，数据提供者如需保持连接发送数据，应每1分钟发送一个心跳数据包来进行链路保持。连续3分钟没有接收到心跳数据包，服务器将认为连接中断，将主动中断数据提供者的数据链路。数据提供者如连续3分钟未收到服务器的回应数据包，则认为与服务器连接中断，可主动断开数据链路。l 数据发送流程：3. 如果服务器返回登录成功确认信息，数据提供者就可以发送客运车辆载客数据了。4. 每发送一次数据，服务器都会返回接收的信息。可以根据返回的信息来确认数据是否发送成功。5.2. 登录系统5.2.1. 登录请求信息数据列表序号名称命名必填说明1命令头*是一条报文开始标志2命令编号CmdNum是登录请求为013服务商编码ServerID是4结束符#是一条报文结束标志命令格式：*01,ServerID#5.2.2. 登录成功确认信息登录请求如果成功，服务器会返回如下信息：数据格式：*01#5.2.3. 登录失败信息登录请求如果失败，服务器会返回如下信息：数据格式：*02,错误代码#服务器发送完信息后，会强行断开与客户端的连接。错误代码说明01数据格式错误02非法服务商编码错误03服务商已停用04其它错误5.3. 链路测试数据规约5.3.1. 链路测试请求序号名称命名必填说明1命令头*是一条报文开始标志2命令编号CmdNum是链路测试请求为993服务商编码ServerID是4结束符#是一条报文结束标志命令格式：*99,ServerID#5.3.2. 链路测试返回信息返回数据格式：*99,OK#5.4. 客运车辆载客数据规约各上报的客运车辆载客数据中，必须包含但不限于以下要素：序号名称标识必填说明1命令头*是一条报文开始标志2数据类型DataType是客运车辆载客数据填写23数据版本DataVersion是例如：1.0表示1.0版本，此协议版本为1.04运营商编号ServerID是例如：NJ09001表示某运营商编号，由长天智远公司分配，测试时可以填写本公司的拼音字母缩写，或联系长天智远公司相关人员，以方便各运营商间数据区分开。5地区编码AreaCode是见数据编码说明6车牌号码VehicleNum是车牌(船)号码全称，请注意要用UTF8进行编码7车牌颜色PlateColor是(见表4)8驾驶员1姓名Driver1是请注意要用UTF8进行编码9驾驶员1从业资格证号Driver1QualCert是10驾驶员1联系电话Driver1Tel否11驾驶员2姓名Driver2是请注意要用UTF8进行编码12驾驶员2从业资格证号Driver2QualCert是13驾驶员2联系电话Driver2Tel否14乘务员姓名Trainman否请注意要用UTF8进行编码15乘务员从业资格证号TrainmanQualCert是如果有乘务员，此信息一定要报16乘务员联系电话TrainmanTel否17经营区域BusinessArea是(见表7)18始发地名称Origin是请注意要用UTF8进行编码19终到地名称Destination是请注意要用UTF8进行编码20始发站名称OrigStation请注意要用UTF8进行编码21终到站名称DestStation请注意要用UTF8进行编码22发车时间StartTime是YYMMDDHHmmss，年、月、日、时、分、秒都是两位数共12位，不足两位前面补0，时间为24小时制，例如090512141325 2009年05月12日14点13分25秒23预计到站时间EndTime是YYMMDDHHmmss，年、月、日、时、分、秒都是两位数共12位，不足两位前面补0，时间为24小时制，例如090512141325 2009年05月12日14点13分25秒24载客数量LoadAmount是25里程数Mileage否单位：公里26结束符#是一条报文结束标志5.4.1. 客运车辆载客数据报文格式数据间以逗号“,”分隔，数据要用UTF8格式进行编码，以下是报名格式：*DataType,DataVersion,ServerID,AreaCode,VehicleNum,PlateColor,Driver1,Driver1QualCert,Driver1Tel, Driver2, Driver2QualCert , Driver2Tel , Trainman , TrainmanQualCert , TrainmanTel, BusinessArea, Origin, Destination, OrigStation, DestStation, StartTime, EndTime, LoadAmount, Mileage#l 报文中的“,”为分隔符。l DataType：填写2l DataVersion：填写1.0l ServerID：某服务商编号，由长天智远公司分配，测试时可以填写本公司的拼音字母缩写，或联系长天智远公司相关人员，以方便各运营商间数据区分开l VehicleNum：车牌(船)号码全称，如：苏A123456, 请注意要用UTF8进行编码l PlateColor：见表4l StartTime：发车时间，日期格式，YYMMDDHHmmss，年、月、日、时、分、秒都是两位数共12位，不足两位前面补0，时间为24小时制，例如090512141325 2009年05月12日14点13分25秒l EndTime：预计到达时间，格式见发车时间5.4.2. 数据范例l 可以单条记录发送：*2,1.0,NJ0002,NJ,苏A883456,2,李四,CY00004,1234235234,乘务员,3,南京,连云港,中央门,新浦,090512141325,090515200000,24,#l 也可以多条记录拼在一起发送：*2,1.0,NJ0002,NJ,苏A883456,2,李四,CY00004,1234235234,乘务员,3,南京,连云港,中央门,新浦,090512141325,090515200000,24,# *2,1.0,NJ0002,NJ,苏A123456,2,王五,CY00005,123423234,赵六,CY00006,乘务员,3,南京,连云港,中央门,新浦,090512141325,090515200000,24,#上面是两条数据一起发送。5.4.3. 数据接收成功确认信息危险品数据如果接收成功，服务器会返回如下信息：数据格式：*03,接收数据