广州市道路客运车辆监管平台数据接口规范.docx
《广州市道路客运车辆监管平台数据接口规范.docx》由会员分享,可在线阅读,更多相关《广州市道路客运车辆监管平台数据接口规范.docx(29页珍藏版)》请在冰豆网上搜索。
广州市道路客运车辆监管平台数据接口规范
广州市交通运输管理局
XXXX-XX-XX实施
XXXX-XX-XX发布
广州市道路客运车辆监管平台
数据接口规范
(征求意见稿)
(本稿完成日期:
2007年11月)
DB**/**—2007
DB
广州市地方标准
ICS**.***.**
**
备案号:
*****-2007
1前言
本标准规定了广州市道路客运车辆监管平台数据接口的要求,包含网络结构、接口方式、安全性、接口协议。
本标准适用于广州市基于全球定位系统(以下简称GPS)和无线移动通信技术的道路客运车辆监管平台数据接口的设计与开发。
本标准由广州市交通运输管理局提出并归口。
1范围
本规范规定了XXXXXX要求。
本规范适用于道路客运车辆监管平台数据接口的设计和开发。
2规范性引用文件
下列文件中的条款通过本标准的引用而成为本标准的条款。
凡是注日期的引用文件,其随后所有的修改单(不包括勘误的内容)或修订版均不适用于本标准,然而,鼓励根据本标准达成协议的各方研究是否可使用这些文件的最新版本。
凡是不注日期的引用文件,其最新版本适用于本标准。
GB/T8566信息技术软件生存周期过程
GB/T8567计算机软件产品开发文件编制指南
GB/T12504计算机软件质量保证计划规范
GB/T19392—2003汽车GPS导航系统通用规范
3术语、定义和缩略语
3.1术语和定义
术语参见国家安监局标准(AQ3003—2005和AQ3004—2005)。
中心center
定义道路客运车辆监管平台为中心
企业系统corporationsystem
道路客运企业GPS监控系统
透明数据通道transparencedatachannel
透明数据通道用于处理终端直接接入中心,但企业仍然使用旧有系统的情况,实现企业对旧有系统的暂时兼容。
GPS定位频度GPSpositionfrequency
GPS数据多长时间间隔上传一次到中心
心跳信号heartbeatsignal
服务器节点间保持着间歇的通信信号,叫做心跳信号。
WGS84标准WGS84standard
WGS-84坐标系是美国国防部研制确定的大地坐标系,是一种协议地球坐标系,采用的是地心坐标系。
指令command
控制车载终端设备工作的报文
字节byte
8位二进制数据
位/比特位bit
一个位/比特位拥有一个值,0或1。
地理栅栏geo-fence
以车辆熄火位置为中心,以一定的距离为半径,设定一个限定区域。
消息message
汽车运输安全监控系统实体间传输的分组数据。
应答/回复reply
监控系统用于应答指令、通告或报告的报文。
表明指令的执行结果,声明通告或报告的接收情况。
如果指令执行失败,应当在回复中说明失败的原因。
状态status
反映车载终端在某一时刻或一小段时间内所处环境。
包括了如地理位置,输入端口状态等。
车载终端设备将状态报告发送至通信控制处理中心。
3.2缩略语
传输控制协议TransferControlProtocol
TCP
虚拟个人网络VirtualPrivateNetwork
VPN
4网络结构
如上图所示,车载终端通过无线网络与运营商平台相连接,运营商平台必须通过道路客运车辆监管平台数据接口进行数据上传和数据下发。
5接口方式
平台将开放标准TCP协议的服务端口,企业自建系统通过访问服务端口获取或上传数据。
企业系统每次连接中心接口时,都应按以下步骤进行连接操作:
●进行身份认证;
●按配置预设进行数据订阅或上传注册;
●在数据订阅或上传注册得到中心应答许可后,才能从中心获取D类型数据或向中心上传U类型数据;
●收到中心取消通知时,应立刻停止向中心上传数据;
●R和A类型数据在身份认证后即可按应用要求进行传输。
在数据传输过程中,需要通过连接检测请求和应答保证连接状态:
●企业系统每隔1分钟向已连接的企业系统发送连接检测请求;
●中心收到后将立刻应答;
●企业系统超过1分钟未收到应答,或出现TCP连接异常,应重新与中心建立TCP连接,并重新执行身份认证、订阅、注册等操作。
6安全性
采用VPN+帐号认证方式保证数据安全性;企业通过VPN方式连接中心服务器,经过帐号认证后,只能获取权限范围内的数据。
7接口协议
消息统一采用GB2312字符串;
消息格式如下:
开始符
功能关键字
分隔符
数据长度
分隔符
数据
结束符
其中数据格式如下:
数据字段1
数据分隔符
数据字段2
数据分隔符
……
数据字段n
开始符:
“~”;
结束符:
“#”;
分隔符:
“&”;
数据分隔符:
“|”;
转义字符:
“\”;
注意:
以上特殊字符在数据中出现时,必须在前面加转义字符!
功能关键字:
关键字
应用方向
说明
AUTHR
企业系统->中心
企业系统请求身份认证
AUTHA
中心->企业系统
中心返回身份认证结果
KEEPR
企业系统->中心
企业系统向中心发送心跳信号检测连接状态
KEEPA
中心->企业系统
中心向企业系统进行应答表示连接正常
SUBSR
企业系统->中心
企业系统向中心进行订阅操作请求或进行数据上传注册
SUBSA
中心->企业系统
中心返回订阅操作结果或数据上传注册结果
SUBSD
中心->企业系统
中心向企业系统下发某项订阅或数据上传注册的变更通知
TRSPU
企业系统->中心
企业系统进行透明数据上传注册后,上传需通过中心透明数据通道向终端发送的数据(终端接入点在中心)
TRSPD
中心->企业系统
企业系统进行透明数据订阅后,中心通过透明通道向企业系统下发终端上传的数据(终端接入点在中心)
OFLNU
企业系统->中心
企业系统进行GPS数据上传注册后,当车辆的车载终端联机或下线时,企业系统主动向中心上传车辆联机和下线信息,直至中心取消订阅(终端接入点在企业系统)
GPSDU
企业系统->中心
企业系统进行GPS数据上传注册后,企业系统主动向中心上传GPS信息,直至中心取消订阅(终端接入点在企业系统)
GPSFR
中心->企业系统
中心向企业系统下发GPS定位频度设置请求(终端接入点在企业系统),设置终端上传GPS的频率。
GPSFA
中心->企业系统
企业系统向中心返回GPS定位频度设置应答(终端接入点在企业系统),给出设置结果。
DETCR
中心->企业系统
中心向企业系统下发终端自检请求,企业系统应让相应终端进行自检,并将自检结果向中心应答(终端接入点在企业系统)。
DETCA
企业系统->中心
企业系统向中心应答指定终端的自检情况,企业系统收到中心下发的终端自检请求后,应使指定终端自检,并向中心应答终端自检结果(终端接入点在企业系统)。
ALAMU
企业系统->中心
企业系统进行车辆报警信息上传注册后,企业系统在产生终端断电、紧急情况时,主动向中心上传报警信息,直至中心取消注册(终端接入点在企业系统)。
AREAR
中心->企业系统
中心向企业系统下发区域监控设置请求(终端接入点在企业系统)。
AREAA
企业系统->中心
企业系统返回区域监控设置应答(终端接入点在企业系统)。
AREAU
企业系统->中心
企业系统进行区域监控报警信息上传注册后,企业系统在车辆违反区域监控限制时,主动向中心上传报警信息,直至中心取消注册(终端接入点在企业系统)。
LINER
中心->企业系统
中心向企业系统下发线路监控设置请求(终端接入点在企业系统)。
LINEA
企业系统->中心
企业系统返回线路监控设置应答(终端接入点在企业系统)。
LINEU
企业系统->中心
企业系统进行线路监控报警信息上传注册后,企业系统在车辆违反线路监控限制时,主动向中心上传报警信息,直至中心取消注册(终端接入点在企业系统)。
FENCR
中心->企业系统
中心向企业系统下发地理栅栏设置请求(终端接入点在企业系统)。
FENCA
企业系统->中心
中心向企业系统下发地理栅栏设置请求(终端接入点在企业系统)。
FENCU
企业系统->中心
企业系统进行地理栅栏报警信息上传注册后,企业系统在车辆违反地理栅栏限制时,主动向中心上传报警信息,直至中心取消注册(终端接入点在企业系统)。
说明1:
关键字共5个字符,其中前4个英文字符标识信息功能类别,最后一个字符:
R代表Request(接收方应给发送方返回应答),A代表Answer(与Request配对),U代表Upload(企业向中心上传信息),D代表Download(中心向企业下发信息);U类型的信息要求企业系统首先进行上传注册请求,中心应答成功后由企业系统主动持续上传,直至中心取消注册或企业自行停止;D类型信息要求企业系统首先向中心订阅,中心应答成功后,将自动持续向企业系统下发,直至中心或企业取消订阅。
说明2:
GPS数据遵循WGS84标准。
说明3:
数据长度最大5个数字字符。
说明4:
请求序号中的10位数字每次递增1,可循环,保证至少一天内不会重复。
数据字段:
一条消息只附带一条完整的数据信息,不能附带多条数据,具体数据字段说明详见下面各功能信息说明。
7.1身份认证
7.1.1身份认证请求
对应功能关键字
AUTHR
数据字段1
字段名称
请求序号
说明
企业ID+10位数字
数据字段2
字段名称
企业ID
说明
平台定义的企业ID号,10位数字或字母(不足10位前补0),GB2312编码
数据字段3
字段名称
密码
说明
GB2312编码,只能是字母、数字,最大长度16个GB2312字符
7.1.2身份认证应答
对应功能关键字
AUTHA
数据字段1
字段名称
请求序号
说明
企业ID+10位数字
数据字段2
字段名称
企业ID
说明
平台定义的企业ID号,GB2312编码
数据字段3
字段名称
应答
说明
0为认证成功,非0为认证失败
7.2连接检测请求
对应功能关键字
KEEPR
数据字段1
字段名称
请求序号
说明
企业ID+10位数字
数据字段2
字段名称
企业ID
说明
平台定义的企业ID号,GB2312编码
7.3连接检测应答
对应功能关键字
KEEPA
数据字段1
字段名称
请求序号
说明
企业ID+10位数字
7.4数据订阅和上传注册
7.4.1数据订阅和上传注册请求
对应功能关键字
SUBSR
数据字段1
字段名称
请求序号
说明
企业ID+10位数字,字符串,GB2312编码
数据字段2
字段名称
企业ID
说明
平台定义的企业ID号,GB2312编码
数据字段3
字段名称
请求类型
说明
使用字符串,SR为订阅,SC为取消订阅,RR为上传注册,RC为取消注册,GB2312编码。
数据字段4
字段名称
数据类型
说明
字符串,填写将要请求的U或D类数据的功能关键字,例如透明数据通道中的“TRSPU”和“TRSPD”等,具体可参考功能关键字列表及说明,GB2312编码。
7.4.2数据订阅和上传注册应答
对应功能关键字
SUBSA
数据字段1
字段名称
请求序号
说明
企业ID+10位数字,字符串,GB2312编码
数据字段2
字段名称
企业ID
说明
平台定义的企业ID号,GB2312编码
数据字段3
字段名称
应答
说明
0为订阅或注册成功,非0为订阅或注册失败
7.4.3数据订阅和上传注册取消通知
对应功能关键字
SUBSD
数据字段1
字段名称
企业ID
说明
平台定义的企业ID号,GB2312编码
数据字段2
字段名称
通知类型
说明
使用字符串,SC为取消订阅,RC为取消注册,GB2312编码。
数据字段3
字段名称
数据类型
说明
字符串,填写将要请求的U或D类数据的功能关键字,例如透明数据通道中的“TRSPU”和“TRSPD”等,具体可参考功能关键字列表及说明,GB2312编码。
7.5透明数据通道
7.5.1终端上传的数据
对应功能关键字
TRSPU
数据字段1
字段名称
车牌号
说明
完整合法的车牌号,长度8字节,GB2312编码
数据字段2
字段名称
数据内容
说明
终端上传的二进制数据串,中心不进行编码解析,由企业系统自行处理。
7.5.2下发到终端的数据
对应功能关键字
TRSPD
数据字段1
字段名称
车牌号
说明
完整合法的车牌号,长度8字节,GB2312编码
数据字段2
字段名称
数据内容
说明
向终端下发的二进制数据串,中心不进行编码解析,直接向对应车牌号的终端发送。
7.6终端上下线信息上传
对应功能关键字
OFLNU
数据字段1
字段名称
车牌号
说明
完整合法的车牌号,长度8字节,GB2312编码
数据字段2
字段名称
上下线标志
说明
字符串,格式为x,固定长度1字节,0表示车辆下线,1表示车辆上线,GB2312编码。
数据字段3
字段名称
GPS时间
说明
字符串,格式为YYYYMMDDHHMMSS,GB2312编码。
数据字段4
字段名称
经度
说明
字符串,格式为xxx.xxxxx,固定长度9字节,GB2312编码。
数据字段5
字段名称
纬度
说明
字符串,格式为xx.xxxxx,固定长度8字节,GB2312编码。
数据字段6
字段名称
高度
说明
字符串,暂不使用,为0,GB2312编码。
数据字段7
字段名称
速度
说明
字符串,格式为xxx.xx,单位为公里/小时,不定长度,最大6字节,GB2312编码。
数据字段8
字段名称
方向
说明
字符串,格式xxx,固定长度3字节,GB2312编码。
数据字段9
字段名称
状态
说明
字符串,格式为x,固定长度1字节,0表示车辆熄火,1表示车辆点火,GB2312编码。
7.7GPS数据上传
对应功能关键字
GPSDU
数据字段1
字段名称
车牌号
说明
完整合法的车牌号,长度8字节,GB2312编码
数据字段2
字段名称
GPS时间
说明
字符串,格式为YYYYMMDDHHMMSS,GB2312编码。
数据字段3
字段名称
经度
说明
字符串,格式为xxx.xxxxx,固定长度9字节,GB2312编码。
数据字段4
字段名称
纬度
说明
字符串,格式为xx.xxxxx,固定长度8字节,GB2312编码。
数据字段5
字段名称
高度
说明
字符串,暂不使用,为0,GB2312编码。
数据字段6
字段名称
速度
说明
字符串,格式为xxx.xx,单位为公里/小时,不定长度,最大6字节,GB2312编码。
数据字段7
字段名称
方向
说明
字符串,格式xxx,固定长度3字节,GB2312编码。
数据字段8
字段名称
状态
说明
字符串,格式为x,固定长度1字节,0表示车辆熄火,1表示车辆点火,GB2312编码。
7.8GPS定位频度设置请求
对应功能关键字
GPSFR
数据字段1
字段名称
请求序号
说明
10位数字,字符串,GB2312编码
数据字段2
字段名称
车牌号
说明
完整合法的车牌号,长度8字节,GB2312编码
数据字段3
字段名称
GPS定位时间间隔
说明
字符串,1~9999(秒),不定长度。
7.9GPS定位频度设置应答
对应功能关键字
GPSFA
数据字段1
字段名称
请求序号
说明
10位数字,字符串,GB2312编码
数据字段2
字段名称
车牌号
说明
完整合法的车牌号,长度8字节,GB2312编码
数据字段3
字段名称
设置结果
说明
0成功,非0失败,1位数字,字符,GB2312编码。
数据字段4
字段名称
对应车辆目前GPS定位时间间隔
说明
字符串,1~9999(秒),不定长度。
7.10终端自检请求
对应功能关键字
DETCR
数据字段1
字段名称
请求序号
说明
10位数字,字符串,GB2312编码
数据字段2
字段名称
车牌号
说明
完整合法的车牌号,长度8字节,GB2312编码
7.11终端自检应答
对应功能关键字
DETCA
数据字段1
字段名称
请求序号
说明
10位数字,字符串,GB2312编码
数据字段2
字段名称
车牌号
说明
完整合法的车牌号,长度8字节,GB2312编码
数据字段3
字段名称
GSM信号强度
说明
整数字符,0~99,GB2312编码。
数据字段4
字段名称
GPS是否定位
说明
1位数字字符,1为定位,0为不定位,GB2312编码。
数据字段5
字段名称
电源情况
说明
1位数字字符,1为常规供电,0为备用电池供电,GB2312编码。
数据字段6
字段名称
汽车点火
说明
1位数字字符,1为点火开关打开,0为点火开关关闭,GB2312编码。
数据字段7
字段名称
外设接口状态
说明
数字字符串,最大15个字符,不定长度,有多少个外设接口,就传多长的字符串,每个字符标识对应接口的状态,0表示没有接入外设,1表示外设接入正常。
数据字段8
字段名称
应用程序状态
说明
1位数字字符,1为正常,0为不正常,GB2312编码。
7.12报警信息上传
对应功能关键字
ALAMU
数据字段1
字段名称
车牌号
说明
完整合法的车牌号,长度8字节,GB2312编码
数据字段2
字段名称
报警产生时间
说明
字符串,格式为YYYYMMDDHHMMSS,GB2312编码。
数据字段3
字段名称
报警类别
说明
3位数字字符,固定长度,前补0,001为断电报警,002为应急报警,GB2312编码。
数据字段4
字段名称
GPS时间
说明
字符串,格式为YYYYMMDDHHMMSS,GB2312编码。
数据字段5
字段名称
经度
说明
字符串,格式为xxx.xxxxx,固定长度9字节,GB2312编码。
数据字段6
字段名称
纬度
说明
字符串,格式为xx.xxxxx,固定长度8字节,GB2312编码。
数据字段7
字段名称
高度
说明
字符串,暂不使用,为0,GB2312编码。
数据字段8
字段名称
速度
说明
字符串,格式为xxx.xx,单位为公里/小时,不定长度,最大6字节,GB2312编码。
数据字段9
字段名称
方向
说明
字符串,格式xxx,固定长度3字节,GB2312编码。
数据字段10
字段名称
状态
说明
字符串,格式为x,固定长度1字节,0表示车辆熄火,1表示车辆点火,GB2312编码。
7.13区域监控设置请求
对应功能关键字
AREAR
数据字段1
字段名称
请求序号
说明
10位数字,字符串,GB2312编码
数据字段2
字段名称
车牌号
说明
完整合法的车牌号,长度8字节,GB2312编码
数据字段3
字段名称
区域监控类型
说明
数字字符,1为禁入监控,2为禁出监控。
数据字段4
字段名称
区域编号
说明
字符串,1~9999,不定长度,最大4位整数。
数据字段5
字段名称
有效日期范围
说明
表示该区域在此时间范围内生效,字符串,格式为YYYYMMDD-YYYYMMDD,结束日期必须大于等于开始时间,可以为空,表示任意日期都生效,GB2312编码。
数据字段6
字段名称
有效时间范围
说明
表示该区域每天生效的时间段,字符串,格式为HHMMSS-HHMMSS,结束时间必须大于开始时间,可以为空,表示一天24小时都生效,GB2312编码。
数据字段7
字段名称
区域
说明
监控区域的顶点集合,字符串,采用“经度1,纬度1;经度2,纬度2;…经度n,纬度n”的格式,n最大为99,经纬度参考3.4的说明,使用wgs84标准,不定长度。
该请求将设置指定类型下和指定编号的监控区域。
7.14区域监控设置应答
对应功能关键字
AREAA
数据字段1
字段名称
请求序号
说明
10位数字,字符串,GB2312编码
数据字段2
字段名称
车牌号
说明
完整合法的车牌号,长度8字节,GB2312编码
数据字段3
字段名称
设置结果
说明
0成功,非0失败,1位数字,字符,GB2312编码。
7.15区域监控报警上传
对应功能关键字
AREAU
数据字段1
字段名称
车牌号
说明
完整合法的车牌号,长度8字节,GB2312编码
数据字段2
字段名称
报警产生时间
说明
字符串,格式为YYYYMMDDHHMMSS,GB2312编码。
数据字段3
字段名称
区域监控类型
说明
数字字符,1为禁入监控,2为禁出监控。
数据字段4
字段名称
GPS时间
说明
字符串,格式为YYYYMMDDHHMMSS,GB2312编码。
数据字段5
字段名称
经度
说明
字符串,格式为xxx.xxxxx,固定长度9字节,GB2312编码。
数据字段6
字段名称
纬度
说明
字符串,格式为xx.xxxxx,固定长度8字节,GB2312编码。
数据字段7
字段名称
高度
说明
字符串,暂不使用,为0,GB2312编码。
数据字段8
字段名称
速度
说明
字符串,格式为xxx.xx,单位为公里/小时,不定长度,最大6字节,GB2312编码。
数据字段9
字段名称
方向
说明
字符串,格式xxx,固定长度3字节,GB2312编码。
数据字段10
字段名称
状态
说明
字符串,格式为x,固定长度1字节,0表示车辆熄火,1表示车辆点火,GB2312编码。
7.16线路监控设置请求
对应功能关键字
LINER
数据字段1
字段名称
请求序号
说明
10位数字,字符串,GB2312编码
数据字段2
字段名称
车牌号
说明
完整合法的车牌号,长度8字节,GB2312编码
数据字段3
字段名称
线路编号
说明
字符串,1~9999,不定长度,最大4位整数。
数据字段4
字段名称
有效日期范围
说明
表示该线路在此时间范围内生效,字符串,格式为YYYYMMDD-YYYYMMDD,结束日期必须大于等于开始时间,可以为空,表示任意日期都生效,GB2312编码。
数据字段5
字段名称
有效时间范围
说明
表示该线路每天生效的时间段,字符串,格式为HHMMSS-HHMMSS,结束时间必须大于开始时间,可以为空,表示一天24小时都生效,GB2312编码。
数据字段6
字段名称
区域
说明
监控线路的端点集合,按顺序排列,字符串,采用