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