宁波GPS监管平台 数据接入协议
一、 协议概述
1. 底层通讯协议概述
标准协议以TCP/IP作为低层通讯承载。宁波平台提供服务器平台功能，在TCP上进行监听，端口号可配置；其他地市系统平台以工作站方式（下称客户端平台）访问服务器平台，客户端平台与服务器平台通过标准协议进行信息交互时，采用长连接方式。所谓长连接，指在一个TCP 连接上可以连续发送多个数据包，在TCP 连接保持期间，如果没有数据包发送，需要双方发链路检测包以维持此连接。
图1-1 GPS协议栈
2. 业务消息种类概述
目前客户端平台需要实现的消息主要有： 1) 客户端平台登录 2) 车辆位置汇报 3) 车辆基本信息 4) 连接检测消息 5) 车辆基本信息注销 6) 照片信息上传消息
7) 视频信息上传消息（系统暂不支持）
3. 消息格式规约概述
按照指令数据类型的不同，消息分成二进制消息和文本消息两种。
1
除照片以及视频消息上传外，其他消息组成为文本消息，在发送消息时需将字符串指令按UTF-8编码将字符串转换成byte数组，在该byte数组前附加两个字节(big endian)描述后续字节数。在实现具体的消息的时候，每个消息内部的各个字段信息需要以“，”进行分割；字段内部如果还存在具体信息，需要以\进行分割，每个字段的基本单元需要信息进行urlencode编码。
图片、视频等二进制数据以二进制消息的方式传输。客户端平台通过Socket方式连接到二进制通讯端口，采用字节的方式传输二进制数据。字节编码顺序为Big_endian
协议请见《协议约定》部分
二、 业务流程
1. 平台登录
客户端平台上行1号登录消息，服务器平台会下行1号登录验证反馈消息。
2. 车辆位置汇报
客户端平台上行3号位置汇报消息，如果服务器平台发现目前数据库中不存在该车辆的基本信息，下行4号请求车辆基本信息消息，此时客户端平台需要上行6号车辆的基本信息消息。
3. 车辆基本信息上报
如果服务器平台在客户端平台上报的车辆位置汇报中发现未入库的车辆，则会向客户端平台请求车辆基本信息，此时客户端平台需上行6号消息上传该车辆基本信息。
4. 车辆基本信息注销
如果车辆注销而发生信息变动，客户端平台可通过上行22号消息进行车辆信息的注销。
5. 连接测试（心跳）
客户端平台可定时发送上行7号消息检测与服务器之间的连接情况是否正常，若情况正常，服务器将回复下行5号消息回复连接测试。
6. 拍照信息上传
客户端平台可向服务器平台的二进制端口上传照片，实现二进制端口的上行1号消息。
7. 视频信息上传（系统暂未支持）
服务器平台下发视频信息查询指令，即下行12号消息，客户端平台接收到后向服务器
2
平台的二进制端口上传视频信息，实现二进制端口的上行2号消息
8. 注意事项
1) 请详细查看客户端平台车辆终端统一编码的格式和车辆运营类型的约定 2) 请保证转发程序的自动重新连接功能，如果连接出现异常则断开重连，需要重新发送登
录消息（上行1号消息）
三、 协议约定
1. 车型编号约定
车辆类型 省际客运班车 市际客运班车 旅游客运车辆 县际客运班车 危险货物运输车辆 重型载货汽车 半挂牵引车 教练车 公交车 出租汽车 其他 11 12 13 14 20 31 32 42 43 41 99 车辆类型编号 2. 地市编号约定
浙江省各设区市 宁波 编号 10 3. 终端唯一编号约定
位数 1 2 3 4 参数 1 10 代表浙江省 10代表宁波 0001客户端平台编码 描述 1代表GPRS；2代表CDMA；4代表SMS；9代表其他 所属省的两位数字编码(浙江省编码为10) 地市的两位数字编码（具体编码约定见上表） 四位数字表示客户端平台编码 3
5 54321 客户端平台内部终端编号，支持最长20位数字 例：“11010000154321”代表：GPRS浙江省宁波市0001（客户端平台）54321内部编号
四、 协议指令集
1. 客户端平台?服务器平台（上行）
1) 客户端平台登录消息：1号消息 位数 1 2 3 4 参数描述 消息号 1 登陆账号 yyyyMMddHHmmss 密码 md5加密 例如：1,0001,20090904090020, B8C37E33DEFDE51CF91E1E03E51657DA
2) 车辆位置汇报：3号消息 位数 1 2 3 4 5 6 7 8 9 参数描述 消息号 3 终端唯一编号 定位时间 （精确到秒）yyyyMMddHHmmss 经度（经纬度为带小数的双精度数字的度数数值） 纬度 速度 km/h（保留2位小数点） 高度单位：m 状态: 数字，具体含义再定，默认是0 空重车：0-空车；1-重车。出租车才有此要求，其他车辆用0即 例如：
3,11010000154321,20070308111720,119.256001,26.135256,80,10,0,0 3) 车辆基本信息：6号消息 触发条件：
? 收到节点发送到服务器平台的4号消息则返回该消息 ? 如果新增或修改车辆信息时要将车辆信息传到节点服务器
注：车辆信息必填字段为终端唯一编号、车牌号、车辆类型编号、工作单位（工作单位为车辆所属企业名称）， 位数 1 2 参数描述 消息号 6 车辆信息；多个车辆信息以“，”隔开；每个车辆信息包括：终端唯一编号$车牌号$ 车辆类型编号$车载终端电话$是否支持拍照$车主姓名4
