GPS数据采集接口协议V1.0.doc

GPS数据采集接口协议版本号：V1.1车务通GPS项目组2010年8月1 概述本协议是车辆GPS实时数据转发的接口协议介绍。本协议详细介绍了车辆GPS平台的接口标准及要求，通过阅读本协议，能够了解深圳车务通对GPS数据采集的范围、方式、以及具体实现的接口开发的方法。在开发本系统的接口前，请仔细阅读本协议。2 阅读对象本协议是为实现GPS数据转发的开发人员及相关负责人编写的。阅读者应该具备一定的软件开发基础，对系统有一定的了解，包括：l 项目经理l 软件开发工程师l 网络管理人员3 协议约定l 各承运商在申请数据对接时，需进行申报，申报的内容包括：承运商名称、设备厂商名称、对接时接入的IP，申报通过后，请使用该IP与车务通的系统进行对接，使用其它IP将拒绝连接。l 深圳市车务通开放固定的IP和端口号给第三方系统进行对接使用。l 接口数据的发送与接收，统一使用UTF-8格式进行编码。4 实时数据发送实时数据发送是指需接入方在收到车辆的GPS定位数据时，主动往彻悟通过物流平台转发该GPS定位数据。l 数据包开始标记：*l 数据包结束标记：#l 数据项分隔符：,（英文逗号）l 数据发送频率：每车的定位间隔不高于30秒l 数据连接方式：TCP（长连接，若发现断开连接，客户端自动重连）l 数据编码要求：UTF-84.1 实时数据结构定义l 数据项定义序号数据项名称备注1车牌号码车牌号码必须唯一2定位时间定位时间的格式为：年月日时分秒，年份为四位整数，其余都是两位整数，不够两位在前面补零，如：20100830082005表示2010年8月30日8时20分5秒3经度统一转换为度，如：110.682688，保留六位小数4纬度统一转换为度，如： 22.367845，保留六位小数5速度统一转换为公里/小时6方向以GPS状态7状态与车辆行驶相关的状态，可以为空8报警车辆的报警信息，可以为空l 实时数据包格式及顺序：*车牌号码,定位时间,经度,纬度,速度,方向,状态,报警#下面的示例是数据包未进行UTF-8编码前的数据包字符串：*渝A12345,20100830120630,110.682688,22.367845,100,70,ACC开,超速报警#5 指令下发指令下发是指民生物流对接入到其平台的设备一些控制指令，如：设置回传间隔等。指令下发的连接方式、编码、以及开始和结束符都和实时数据一样。5.2 指令列表指令代码指令名称备注2设置回传间隔参数是要设置的回传间隔，单位是秒5.3 指令数据示例*渝A12345,2,30#表示需要将车牌为渝A12345的回传间隔设置为30秒。6 心跳包为了保证由于长时间没有实时定位数据发到民生物流平台时TCP连接不被断掉，请接入方每隔2分钟往长安民生物流平台发送一个心跳包，以确认连接是否正常，心跳包的格式如下：*CMAL,GPS#长安民生物流GPS平台收到心跳包后，也以相同的格式进行返回。7 历史轨迹补偿历史轨迹补偿用于由于某种原因，在某个时间段内某个车的实时定位数据没有传送到长安民生物流平台，由被接入方提供一个WEBSERVICE接口供长安民生物流平台调用以获取车辆在某个时间段内的历史轨迹，接口的定义如下：l 接口名称：GetHistoryTrackl 调用参数序号参数名称参数类型备注1车牌号码String2开始时间String时间格式：yyyy-mm-dd hh24:mi:ss，如：2010-08-30 14:20:083结束时间String格式同开始时间l 返回值类型：Stringl 返回值格式说明（1） 每条轨迹包含的数据如下：序号数据项名称备注1定位时间定位时间的格式为：年月日时分秒，年份为四位整数，其余都是两位整数，不够两位在前面补零，如：20100830082005表示2010年8月30日8时20分5秒2经度统一转换为度，如：110.682688，保留六位小数3纬度统一转换为度，如： 22.367845，保留六位小数4速度统一转换为公里/小时5方向6状态与车辆行驶相关的状态，没有可以为空7报警没有可以为空各个数据项之间以英文逗号(,)分隔。（2） 各条轨迹之间以美元符号($)分隔。（3） 示例数据：20100830113020,110.2048203,22.4028402,120,70,ACC开,超速报警$20100830113100,1