中鼎车载GPS北斗监管系统.doc

中鼎车载GPS北斗监管系统
开发接口文档
(20160508版)
开放接口概述
      ZHONHDIN平台致力开放平台建设,提供的接口包含: ZHONHDIN平台GServer实时接口- 可以连接GServer服务器程序,获取监控车辆数据,下发实时命令等等; ZHONHDIN开放平台动态数据接口- 可以返回车辆当前位置数据、轨迹回放数据等车辆动态信息;ZHONHDIN开放平台静态数据接口- 提供增加客户、帐号、分组、车辆等修改静态数据的接口;ZHONHDIN平台数据库字典- 开放对ZHONHDIN平台后台数据库所有数据表的定义及说明; ZHONHDIN平台其他接口- 其他一些面向行业应用的接口。如果我们提供的接口不能满足你的需要,可以联系技术支持反应,我们将开放更多接口。
一、ZHONHDIN平台GServer实时接口(JSON)
ZHONHDIN平台GServer实时接口(JSON)
GServer实时接口(JSON)说明:
本规范规定了直接接入ZHONHDIN平台GServer应用服务器的接口定义,采用TCP通讯方式,实现了用户登录、权限验证、各种数据传输等功能。
本规范主要用来实现第三方软件和GServer服务器实时互通,采用TCP传输方式,端口为1502,数据格式使用json格式。
数据分为数据头(header)和数据体(body)两个部分。
数据头(header)部分格式为:
"header":
{
"cmd":"1000"
}
格式主要包含一个命令字(cmd)属性,程序根据命令字来区分数据体的内容。数据体(body)部分包含的数据会根据数据头中的命令字(cmd)而异。
 
 
第三方平台数据转入ZHONHDIN平台步骤:
>> 获取一个ZHONHDIN平台帐号
>> 以TCP方式登录ZHONHDIN平台1502端口,参考用户登录命令1000
>> 等待ZHONHDIN平台登录返回成功,ess服务器将掐断TCP连接
>> 收到成功后,第三方平台需要间隔30秒发送心跳消息,参看客户端心跳 1002
>> 连接成功后,第三方平台可以按照车辆定位数据 1007 格式上传车辆数据
>> 第三方平台退出连接可以发送用户退出 1001命令,然后断开TCP连接
 
自己开发客户端接入ZHONHDIN平台GServer服务器步骤:
>> 获取一个ZHONHDIN平台帐号 
>> 以TCP方式登录ZHONHDIN平台1502端口,参考用户登录命令1000
>> 等待ZHONHDIN平台登录返回成功,ess服务器将掐断TCP连接 
>> 收到成功后,第三方平台需要间隔30秒发送心跳消息,参看客户端心跳 1002
>>请求下发用户下客户和分组数据 1008
>>请求下发每个分组下的车辆数据 1010
>> 服务器向客户端转发车辆的实时定位数据 1007
>>客户端向车载终端下发车机命令 1003
>> 客户端退出连接,发送退出命令 1001,然后断开TCP连接
 
 

数据发送方向:client —> server
命令字:1000
参数
参数
类型
说明
name
String
用户名称
pass
String
用户密码
ver
String
客户端版本,如
type
String
客户端类型 mon
mode
String
备用,填空
格式:
{
"header":
{
"cmd":"1000"
},
"body":
{
"name":"ZHONHDIN",
"pass":"000000",
"ver":"",
"type":"",
"mode":""
}
}
 
 
 

数据发送方向:server —> client
命令字:8000
参数:
参数
类型
说明
cmd
String
服务器接收到的命令字
result
String
ess 成功 failed失败
格式:
{
"header":
{
"cmd":"8000"
},
"body":
{
"cmd":"1000",
"result":"ess" 
}
}
 
 

数据发送方向:client —> server
命令字:1001
参数:
参数
类型
说明
data
String
空
格式:
{
"header":
{
"cmd":"1001"