1、 中鼎 GPS 北斗 车辆 监管 系统 版本号： 160508 地址 :中国成都 -中国科学院成都分院新棕北大厦 8 层 邮编 610041 电话： + 86-028- 85198020 传真： + 86-028-85198020 网址： w w w . z h o n g d i n . c o m E - m a i l ： m a i l z h o n g d i n . c o m 工作 QQ： 987957878 563244355 中鼎 车载 GPS 北斗监管 系统 开发接口文档 （ 20160508 版） 中鼎 GPS 北斗 车辆 监管 系统 版本号： 160508 地址 :中
2、国成都 -中国科学院成都分院新棕北大厦 8 层 邮编 610041 电话： + 86-028- 85198020 传真： + 86-028-85198020 网址： w w w . z h o n g d i n . c o m E - m a i l ： m a i l z h o n g d i n . c o m 工作 QQ： 987957878 563244355 开放接口 概述 ZHONHDIN 平台致力开放平台建设，提供的接口包含 : ZHONHDIN 平台 GServer 实时接口 - 可以连接 GServer 服务器程序 ,获取监控车辆数据 ,下发实时命令等等 ; ZHONHD
3、IN开放平台动态数据接口 - 可以返回车辆当前位置数据、轨迹回放数据等车辆动态信息 ;ZHONHDIN 开 放平台静态数据接口 - 提供增加客户、帐号、分组、车辆等修改静 态数据的接口； ZHONHDIN 平台数据库字典 - 开放对 ZHONHDIN 平台后台数据库所有数据表的定义及说明； ZHONHDIN 平台其他接口 - 其他一些面向行业应用的接口。如果我们提供 的接口不能满足你的需要，可以联系技术支持反应，我们将开放更多接口。 一、 ZHONHDIN 平台 GServer 实时接口 (JSON) ZHONHDIN 平台 GServer 实时接口 (JSON) GServer 实时接口 (
4、JSON)说明： 本规范规定了直接接入 ZHONHDIN 平台 GServer 应用服务器的接口定义，采用 TCP 通讯方式，实现了用户登录、权限验证、各种数据传输等功能。 本规范主要用来实现第三方软件和 GServer 服务器实时互通，采用 TCP 传输方式，端口为 1502，数据格式使用json 格式。 数据分为 数据头 (header)和 数据体 (body)两个部分。 数据头 (header)部分格式为： “header“: “cmd“:“1000“ 格式主要包含一个命令字 (cmd)属性，程序根据命令字来区分数据体的内容。数据体 (body)部分包含的数 据会根据数据头中的命令字 (
5、cmd)而异。 第三方平台数据转入 ZHONHDIN 平台步骤： 获取一个 ZHONHDIN 平台帐号 以 TCP 方式登录 ZHONHDIN 平台 1502 端口，参考用户登录命令 1000 等待 ZHONHDIN 平台登录返回成功，如果返回结果不是 success 服务器将掐断 TCP 连接 收到成功后，第三方平台需要间隔 30 秒发送心跳消息，参看客户端心跳 1002 中鼎 GPS 北斗 车辆 监管 系统 版本号： 160508 地址 :中国成都 -中国科学院成都分院新棕北大厦 8 层 邮编 610041 电话： + 86-028- 85198020 传真： + 86-028-85198
6、020 网址： w w w . z h o n g d i n . c o m E - m a i l ： m a i l z h o n g d i n . c o m 工作 QQ： 987957878 563244355 连接成功后，第三方平台可以按照 车辆定位数据 1007 格式上传车辆数据 第三方平台退出连接可以发送 用户退出 1001 命令，然后断开 TCP 连接 自己开发客户端接入 ZHONHDIN 平台 GServer 服务器步骤： 获取一个 ZHONHDIN 平台帐号 以 TCP 方式登录 ZHONHDIN 平台 1502 端口，参考用户登录命令 1000 等待 ZHONHDI
7、N 平台登录返回成功，如果返回结果不是 success 服务器将掐断 TCP 连接 收到成功后，第三方平台需要间隔 30 秒发送心跳消息，参看客户端心跳 1002 请求下发用户下客户和分组数据 1008 请求下发每个分组下的车辆数据 1010 服务器向客户端转发车辆的实时定位数据 1007 客户端向车载终端下发车机命令 1003 客户端退出连接，发送退出命令 1001，然后断开 TCP 连接 1.用户从客户端登录 GServer服务器 数据发送方向： client server 命令字： 1000 参数 参数 类型 说明 name String 用户名称 pass String 用户密码 ve
8、r String 客户端版本，如 4.6936 type String 客户端类型 json_common mode String 备用，填空 格式： “header“: “cmd“:“1000“ , “body“: “name“:“ZHONHDIN“, “pass“:“000000“, “ver“:“, “type“:“, 中鼎 GPS 北斗 车辆 监管 系统 版本号： 160508 地址 :中国成都 -中国科学院成都分院新棕北大厦 8 层 邮编 610041 电话： + 86-028- 85198020 传真： + 86-028-85198020 网址： w w w . z h o n g
9、 d i n . c o m E - m a i l ： m a i l z h o n g d i n . c o m 工作 QQ： 987957878 563244355 “mode“:“ 2.服务器对客户端发送命令返回的通用应答 数据发送方向： server client 命令字： 8000 参数： 参数 类型 说明 cmd String 服务器接收到的命令字 result String 结果 success 成功 failed 失败 格式： “header“: “cmd“:“8000“ , “body“: “cmd“:“1000“, “result“:“success“ 3.用户从客户
10、端退出 /注销登录 数据发送方向： client server 命令字： 1001 参数： 参数 类型 说明 data String 空 格式： “header“: 中鼎 GPS 北斗 车辆 监管 系统 版本号： 160508 地址 :中国成都 -中国科学院成都分院新棕北大厦 8 层 邮编 610041 电话： + 86-028- 85198020 传真： + 86-028-85198020 网址： w w w . z h o n g d i n . c o m E - m a i l ： m a i l z h o n g d i n . c o m 工作 QQ： 987957878 563
11、244355 “cmd“:“1001“ , “body“: “data“:“ 4.客户端向服务器发送心跳消息 数据发送方向： client server 命令字： 1002 客户端登录成功后，需要按照 30 秒 间隔向服务器发送心跳消息，如果 3 分钟 没有收到客户端发送的心跳消息，服务器端将主动断开客户端的连接 参数： 参数 类型 说明 result String 空 格式： “header“: “cmd“:“1002“ , “body“: “result“:“ 5.服务器向客户端发送通知消息 数据发送方向： client server 命令字： 1003 参数： 参数 类型 说明 msg
12、String 消息内容 格式： 中鼎 GPS 北斗 车辆 监管 系统 版本号： 160508 地址 :中国成都 -中国科学院成都分院新棕北大厦 8 层 邮编 610041 电话： + 86-028- 85198020 传真： + 86-028-85198020 网址： w w w . z h o n g d i n . c o m E - m a i l ： m a i l z h o n g d i n . c o m 工作 QQ： 987957878 563244355 “header“: “cmd“:“1003“ , “body“: “msg“:“ 6.客户端向车载终端发送车机命令 数据
13、发送方向： client server 命令字： 1003 参数： 参数 类型 说明 msg String 命令格式 命令格式为： 7000 180 10 参考 cmd.xml 文件 格式： “header“: “cmd“:“1003“ , “body“: 中鼎 GPS 北斗 车辆 监管 系统 版本号： 160508 地址 :中国成都 -中国科学院成都分院新棕北大厦 8 层 邮编 610041 电话： + 86-028- 85198020 传真： + 86-028-85198020 网址： w w w . z h o n g d i n . c o m E - m a i l ： m a i
14、l z h o n g d i n . c o m 工作 QQ： 987957878 563244355 “msg“:“ 7.服务器向客户端转发车辆实时定位数据 数据发送方向： server client 命令字： 1007 参数： 参数 类型 说明 code String 车牌号码 id String 车辆 ID lat String 纬度 lng String 经度 veo String 速度 dir String 方向 gpstime String 格式为： 2011-11-01 12:38:39 av String 表示是否为有效定位， 0 无效定位， 1 有效定位 alarm Str
15、ing 是否报警， 0 无报警， 1 报警 oil String 当前油量 dis String 当前总里程 wstate String 整数类型状态 cstate String 状态描述，可以为空 posinfo String 位置描述，可以为空 p1 String 模拟量 1 p2 String 模拟量 2 格式： “header“: “cmd“:“1007“ , “body“: “code“:“, “id“:“, 中鼎 GPS 北斗 车辆 监管 系统 版本号： 160508 地址 :中国成都 -中国科学院成都分院新棕北大厦 8 层 邮编 610041 电话： + 86-028- 8519
16、8020 传真： + 86-028-85198020 网址： w w w . z h o n g d i n . c o m E - m a i l ： m a i l z h o n g d i n . c o m 工作 QQ： 987957878 563244355 “lat“:“, “lng“:“, “veo“:“, “dir“:“, “gpstime“:“, “av“:“, “alarm“:“, “oil“:“, “dis“:“, “wstate“:“, “cstate“:“, “posinfo“:“ “p1“:“ “p2“:“ 8.客户端请求服务器下发用户权限下客户及分组数据 数据发
17、送方向： client server 命令字： 1008 参数： 参数 类型 说明 client String true 下发客户关系数据， false 不下发 格式： “header“: “cmd“:“1008“ , “body“: “client“:“true“ 中鼎 GPS 北斗 车辆 监管 系统 版本号： 160508 地址 :中国成都 -中国科学院成都分院新棕北大厦 8 层 邮编 610041 电话： + 86-028- 85198020 传真： + 86-028-85198020 网址： w w w . z h o n g d i n . c o m E - m a i l ： m
18、 a i l z h o n g d i n . c o m 工作 QQ： 987957878 563244355 9.服务器向客户端下发用户的客户、分组数据 数据发送方向 ： client server 命令字： 1009 参数： 参数 类型 说明 groupid String 车辆分组的 ID relation String 用户的客户 customer String 分组的客户 goupname String 分组名称 格式： “header“: “cmd“:“1009“ , “body“: “groupid“:“, “relation“:“, “customer“:“, “goupna
19、me“:“ 10.客户端请求服务器下发用户权限下分组的车辆数据 数据发送方向： client server 命令字： 1010 参数： 参数 类型 说明 groupid String 车辆分组 ID 格式： “header“: “cmd“:“1010“ , 中鼎 GPS 北斗 车辆 监管 系统 版本号： 160508 地址 :中国成都 -中国科学院成都分院新棕北大厦 8 层 邮编 610041 电话： + 86-028- 85198020 传真： + 86-028-85198020 网址： w w w . z h o n g d i n . c o m E - m a i l ： m a i
20、l z h o n g d i n . c o m 工作 QQ： 987957878 563244355 “body“: “groupid“:“1“ 11.服务器向客户端下发用户权限下指定分组的车辆静态数据 数据发送方向： server client 命令字： 1011 参数： 参数 类型 说明 id String 车辆 ID code String 车牌号码 sim String SIM 卡号码 terminalid String 终端设备 ID groupname String 车辆所属分组名称 vhctype String 车辆类型 mobiletype String 终端设备类型 格式： “header“: “cmd“:“1011“ , “body“: “id“:“, “code“:“, “sim“:“, “terminalid“:“, “groupname“:“, “vhctype“:“, “mobiletype“:“
