山海易绘EzMatics实时定位消息服务系统二次开发手册

1、V 9 步 T102但好智单宇琳首身鬼荡以中窣罪君芸理m（咨口溜）4flp*4：=VZK霁潼专wmPM钊涉s 冲 WZQ欢窖擎E本手册内容改动及版本更新将不再另行通知。本手册的范例中所使用的人名、公 司名以及数据，如果没有特别指明，均属虚构。对于本手册、及本手册涉及的技术和 产品，北京山海经纬信息技术有限公司拥有其专利、商标、著作权或其它知识产权， 除非得到北京山海经纬信息技术有限公司的书面许可，本手册不授予这些专利、商标、 著作权或其它知识产权的许可。版权所有C（ 2004-2010）北京山海经纬信息技术有限公司保留所有权利。山海易绘是北京山海经纬信息技术有限公司的注册商标。其它标牌和产品名

2、称是其各自公司的商标或注册商标。山海易绘EzMatics产品的一切有关权利属于北京山海经纬信息技术有限公司所 有。本手册中所涉及的软件产品及其后续升级产品均由北京山海经纬信息技术有限公 司制作并负责全权销售。如果您对本产品有任何建议和疑问，请与以下地址联系：北京山海经纬信息技术有限公司产品服务部地 址：北京市海淀区苏州街29号维亚大厦801室邮编：100080传 真：（010）82612775电 话：（010）826164398261631682616319E-mail : HYPERLINK mailto:support support TOC o 1-5 h z HYPERLINK l b

3、ookmark19 o Current Document 消息接入流程 1 HYPERLINK l bookmark25 o Current Document TCP接入流程 2 HYPERLINK l bookmark36 o Current Document UDP接入流程 3 HYPERLINK l bookmark44 o Current Document 接口定义说明 5 HYPERLINK l bookmark47 o Current Document 接口类型 5 HYPERLINK l bookmark50 o Current Document 接口参数 5类型说明 81消息接

4、入流程用户可采用“ TCP协议”（或“ UDP协议”）通信方式进行定位信号接入（如图1-1 定位消息接入流程图TCP所示）。注：1）在通信环境良好的情况下，建议采用UDP方式发送数据；2）TCP接入默认端口号为“ 6607 ”；3）UDP接入默认端口号为“ 9989 ”。TCP接入流程图1-1定位消息接入流程图TCP具体步骤说明：EzMatics后台服务作为服务器端，其它接入端为客户端；客户端主动连接服务器，并建立SOCKET通信连接；客户端向服务端发送登录认证报文数据；服务器端在接收到登录报文数据后，将进行认证处理。如果成功，则发送通过 认证消息，否则向客户端发送认证失败消息；客户端在接收到

5、服务器端“认证成功”的消息后，即向服务器发送指定格式的 通信报文数据；服务器端在建立同客户端的连接通信后，如果在一段时间内仍未接收到客户端 发送的定位报文数据，则会主动向该客户端发送心跳检测报文命令。客户端在 接受到心跳指令后，需要应答服务器的心跳命令。如果服务器端在发送心跳命 令后的一定时间内（如1分钟）,仍未接收到客户端的心跳回馈命令，则会主动 断开同客户端的连接。客户端在断开同服务器的通信连接时，需要发送断开连接命令，然后断开连接。注：如果客户端同服务器端的连接失败，则需要客户端发起重新连接请求。服务器不负责重新连接。UDP接入流程图1-2定位消息接入流程图UDP具体步骤说明：客户端无需

6、认证等交互信息，直接向服务器指定的端的发送定位报文数据就可UDP分发流程图1-3定位消息分发流程图UDP具体步骤说明：消息服务能主动向指定的目标通过UDP协议发送定位消息数据。2接口定义说明2.1 接口类型接口类型：SOCKET协议。2.2接口参数以下协议对“ TCP ”和“UDP ”方式都通用。1）通信数据包定义数据头数据体标志头命令标志版本号包体大小数据内容2Byte2Byte2byte4BytenByte其中 包体长度只包括“数据体长度”，不包括“包头”和“包尾部分”。2）数据包头定义格式参数描述大小类型值说明标志头2Unsigned short0 xAAAA报文头标志命令字2Unsig

7、ned short0 xBBBB登录系统命令字0 xBBCC登录应答命令字0 xCCCC定位数据命令字0 xEEEE心跳检测命令字0 xFFFF断开连接命令字0 xDDDD报警或自定义消息版本号2Unsigned short0 x2200第一个字节固定为：0 x22表示协议版本；第二个字节0 x00表 示协议加密情况暂 未用包体大小4int可变网络字节序3）登录包体定义【该接口只用于TCP接入方式】命令字(CommandID)0 xBBBB协议包长度（字节）50包体（BODY）字段名称字节大小类型备注认证编码50char实际长度不足50字节时，右补二进 制04）登录应答包体【该接口只用于TCP

8、接入方式】命令字(CommandID)0 xBBCC协议包长度（字节）52包体（BODY）字段名称字节大小类型备注认证结果2Unsigned short0 x0001 : 登录成功0 x0000 :登录失败描述50CHAR登录描述信息5）心跳检测包体【该接口只用于TCP接入方式】命令字(CommandID)0 xEEEE协议包长度（字节）0包体（BODY）字段名称字节大小类型备注6）断开连接包体【该接口只用于TCP接入方式】命令字(CommandID)0 xFFFF协议包长度（字节）0包体（BODY）字段名称字节大小类型备注7）定位消息包体【该接口 TCP和UDP通用】命令字(CommandI

9、D)0 xCCCC协议包长度（字节）51 + N包体（BODY）字段名称字节大小类型备注终端编号20char实际长度不足20字节时，右补二进制0经度8double例:119.12313纬度8double例:34.232443速度2unsigned short单位：米/秒该值采用了网络字节序方向2unsigned short以正北方向为0角度，顺时针方向偏转该值采用了网络字节序高程2unsigned short单位：米该值采用了网络字节序精度2unsigned short0 xFFFF:无效定位。无此项值设置为：0 x0000填充，否则按正常精度值填充。单位：米。该值采用了网络字节序时间年2Un

10、signed short该值采用了网络字节序月1byte日1byte时1byte分1byte秒1byte备用字段n 1024char该项非必须，如果没有该字段内容，则包体长度不计算该部分UDP转发报文同接入的定位报文格式一致。包体（BODY）字段名称字节大小类型备注标志头2Unsigned short固定为0 xAAAA命令字2Unsigned short固定为：0 xCCCC版本标志2Unsigned short固定为：0 x2200包体大小4int51+N （N标志备注字段大小）该值采用了网络字节序终端编号20char实际长度不足20字节时，右补二进制0经度8double例:119.123

11、13纬度8double例:34.232443速度2unsigned short单位：米/秒，无此项按:0 x0000填充该值采用了网络字节序方向2unsigned short以正北方向为0角度，顺时针方向偏转，无此项按:0 x0000填充该值采用了网络字节序高程2unsigned short单位：米，无此项按:0 x0000填充该值采用了网络字节序精度2unsigned short0 xFFFF:无效定位。无此项值设置为：0 x0000填充，否则按正常精度值填充。单位：米。该值采用了网络字节序时间年2Unsigned short该值采用了网络字节序月1byte日1byte时1byte分1byte秒1byte备用字段N 1024char该项非必须，如果没有该字段内容