DOC《中鼎车载GPS北斗监管系统》

中鼎车载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平台登录返回成功,如果返回结果不是success服务器将掐断TCP连接 >

>

收到成功后,第三方平台需要间隔30秒发送心跳消息,参看客户端心跳

1002 >

>

连接成功后,第三方平台可以按照 车辆定位数据

1007 格式上传车辆数据 >

>

第三方平台退出连接可以发送 用户退出 1001命令,然后断开TCP连接 ? 自己开发客户端接入ZHONHDIN平台GServer服务器步骤: >

>

获取一个ZHONHDIN平台帐号? >

>

以TCP方式登录ZHONHDIN平台1502端口,参考用户登录命令1000 >

>

等待ZHONHDIN平台登录返回成功,如果返回结果不是success服务器将掐断TCP连接? >

>

收到成功后,第三方平台需要间隔30秒发送心跳消息,参看客户端心跳

1002 >

>

请求下发用户下客户和分组数据

1008 >

>

请求下发每个分组下的车辆数据

1010 >

>

服务器向客户端转发车辆的实时定位数据

1007 >

>

客户端向车载终端下发车机命令

1003 >

>

客户端退出连接,发送退出命令 1001,然后断开TCP连接 ? ? 1.用户从客户端登录GServer服务器 数据发送方向:client ―>

server 命令字:1000 参数 参数 类型 说明 name String 用户名称 pass String 用户密码 ver String 客户端版本,如4.6936 type String 客户端类型 json_common mode String 备用,填空 格式: { header : { cmd :

1000 }, body : { name : ZHONHDIN , pass :

000000 , ver : , type : , mode : } } ? ? ? 2.服务器对客户端发送命令返回的通用应答 数据发送方向:server ―>

client 命令字:8000 参数: 参数 类型 说明 cmd String 服务器接收到的命令字 result String 结果success 成功 failed失败 格式: { header : { cmd :