山海易繪EzMatics實時定位消息服務(wù)系統(tǒng)二次開發(fā)手冊

1、V 9 步 T102但好智單宇琳首身鬼蕩以中窣罪君蕓理m（咨口溜）4flp*4：=VZK霽潼專wmPM釗涉s 沖 WZQ歡窖擎E本手冊內(nèi)容改動及版本更新將不再另行通知。本手冊的范例中所使用的人名、公 司名以及數(shù)據(jù)，如果沒有特別指明，均屬虛構(gòu)。對于本手冊、及本手冊涉及的技術(shù)和 產(chǎn)品，北京山海經(jīng)緯信息技術(shù)有限公司擁有其專利、商標、著作權(quán)或其它知識產(chǎn)權(quán)， 除非得到北京山海經(jīng)緯信息技術(shù)有限公司的書面許可，本手冊不授予這些專利、商標、 著作權(quán)或其它知識產(chǎn)權(quán)的許可。版權(quán)所有C（ 2004-2010）北京山海經(jīng)緯信息技術(shù)有限公司保留所有權(quán)利。山海易繪是北京山海經(jīng)緯信息技術(shù)有限公司的注冊商標。其它標牌和產(chǎn)品名

2、稱是其各自公司的商標或注冊商標。山海易繪EzMatics產(chǎn)品的一切有關(guān)權(quán)利屬于北京山海經(jīng)緯信息技術(shù)有限公司所 有。本手冊中所涉及的軟件產(chǎn)品及其后續(xù)升級產(chǎn)品均由北京山海經(jīng)緯信息技術(shù)有限公 司制作并負責全權(quán)銷售。如果您對本產(chǎn)品有任何建議和疑問，請與以下地址聯(lián)系：北京山海經(jīng)緯信息技術(shù)有限公司產(chǎn)品服務(wù)部地 址：北京市海淀區(qū)蘇州街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 接口參數(shù) 5類型說明 81消息接

4、入流程用戶可采用“ TCP協(xié)議”（或“ UDP協(xié)議”）通信方式進行定位信號接入（如圖1-1 定位消息接入流程圖TCP所示）。注：1）在通信環(huán)境良好的情況下，建議采用UDP方式發(fā)送數(shù)據(jù)；2）TCP接入默認端口號為“ 6607 ”；3）UDP接入默認端口號為“ 9989 ”。TCP接入流程圖1-1定位消息接入流程圖TCP具體步驟說明：EzMatics后臺服務(wù)作為服務(wù)器端，其它接入端為客戶端；客戶端主動連接服務(wù)器，并建立SOCKET通信連接；客戶端向服務(wù)端發(fā)送登錄認證報文數(shù)據(jù)；服務(wù)器端在接收到登錄報文數(shù)據(jù)后，將進行認證處理。如果成功，則發(fā)送通過 認證消息，否則向客戶端發(fā)送認證失敗消息；客戶端在接收到

5、服務(wù)器端“認證成功”的消息后，即向服務(wù)器發(fā)送指定格式的 通信報文數(shù)據(jù)；服務(wù)器端在建立同客戶端的連接通信后，如果在一段時間內(nèi)仍未接收到客戶端 發(fā)送的定位報文數(shù)據(jù)，則會主動向該客戶端發(fā)送心跳檢測報文命令?？蛻舳嗽?接受到心跳指令后，需要應(yīng)答服務(wù)器的心跳命令。如果服務(wù)器端在發(fā)送心跳命 令后的一定時間內(nèi)（如1分鐘）,仍未接收到客戶端的心跳回饋命令，則會主動 斷開同客戶端的連接。客戶端在斷開同服務(wù)器的通信連接時，需要發(fā)送斷開連接命令，然后斷開連接。注：如果客戶端同服務(wù)器端的連接失敗，則需要客戶端發(fā)起重新連接請求。服務(wù)器不負責重新連接。UDP接入流程圖1-2定位消息接入流程圖UDP具體步驟說明：客戶端無需

6、認證等交互信息，直接向服務(wù)器指定的端的發(fā)送定位報文數(shù)據(jù)就可UDP分發(fā)流程圖1-3定位消息分發(fā)流程圖UDP具體步驟說明：消息服務(wù)能主動向指定的目標通過UDP協(xié)議發(fā)送定位消息數(shù)據(jù)。2接口定義說明2.1 接口類型接口類型：SOCKET協(xié)議。2.2接口參數(shù)以下協(xié)議對“ TCP ”和“UDP ”方式都通用。1）通信數(shù)據(jù)包定義數(shù)據(jù)頭數(shù)據(jù)體標志頭命令標志版本號包體大小數(shù)據(jù)內(nèi)容2Byte2Byte2byte4BytenByte其中 包體長度只包括“數(shù)據(jù)體長度”，不包括“包頭”和“包尾部分”。2）數(shù)據(jù)包頭定義格式參數(shù)描述大小類型值說明標志頭2Unsigned short0 xAAAA報文頭標志命令字2Unsig

7、ned short0 xBBBB登錄系統(tǒng)命令字0 xBBCC登錄應(yīng)答命令字0 xCCCC定位數(shù)據(jù)命令字0 xEEEE心跳檢測命令字0 xFFFF斷開連接命令字0 xDDDD報警或自定義消息版本號2Unsigned short0 x2200第一個字節(jié)固定為：0 x22表示協(xié)議版本；第二個字節(jié)0 x00表 示協(xié)議加密情況暫 未用包體大小4int可變網(wǎng)絡(luò)字節(jié)序3）登錄包體定義【該接口只用于TCP接入方式】命令字(CommandID)0 xBBBB協(xié)議包長度（字節(jié)）50包體（BODY）字段名稱字節(jié)大小類型備注認證編碼50char實際長度不足50字節(jié)時，右補二進 制04）登錄應(yīng)答包體【該接口只用于TCP

8、接入方式】命令字(CommandID)0 xBBCC協(xié)議包長度（字節(jié)）52包體（BODY）字段名稱字節(jié)大小類型備注認證結(jié)果2Unsigned short0 x0001 : 登錄成功0 x0000 :登錄失敗描述50CHAR登錄描述信息5）心跳檢測包體【該接口只用于TCP接入方式】命令字(CommandID)0 xEEEE協(xié)議包長度（字節(jié)）0包體（BODY）字段名稱字節(jié)大小類型備注6）斷開連接包體【該接口只用于TCP接入方式】命令字(CommandID)0 xFFFF協(xié)議包長度（字節(jié)）0包體（BODY）字段名稱字節(jié)大小類型備注7）定位消息包體【該接口 TCP和UDP通用】命令字(CommandI

9、D)0 xCCCC協(xié)議包長度（字節(jié)）51 + N包體（BODY）字段名稱字節(jié)大小類型備注終端編號20char實際長度不足20字節(jié)時，右補二進制0經(jīng)度8double例:119.12313緯度8double例:34.232443速度2unsigned short單位：米/秒該值采用了網(wǎng)絡(luò)字節(jié)序方向2unsigned short以正北方向為0角度，順時針方向偏轉(zhuǎn)該值采用了網(wǎng)絡(luò)字節(jié)序高程2unsigned short單位：米該值采用了網(wǎng)絡(luò)字節(jié)序精度2unsigned short0 xFFFF:無效定位。無此項值設(shè)置為：0 x0000填充，否則按正常精度值填充。單位：米。該值采用了網(wǎng)絡(luò)字節(jié)序時間年2Un

10、signed short該值采用了網(wǎng)絡(luò)字節(jié)序月1byte日1byte時1byte分1byte秒1byte備用字段n 1024char該項非必須，如果沒有該字段內(nèi)容，則包體長度不計算該部分UDP轉(zhuǎn)發(fā)報文同接入的定位報文格式一致。包體（BODY）字段名稱字節(jié)大小類型備注標志頭2Unsigned short固定為0 xAAAA命令字2Unsigned short固定為：0 xCCCC版本標志2Unsigned short固定為：0 x2200包體大小4int51+N （N標志備注字段大?。┰撝挡捎昧司W(wǎng)絡(luò)字節(jié)序終端編號20char實際長度不足20字節(jié)時，右補二進制0經(jīng)度8double例:119.123

11、13緯度8double例:34.232443速度2unsigned short單位：米/秒，無此項按:0 x0000填充該值采用了網(wǎng)絡(luò)字節(jié)序方向2unsigned short以正北方向為0角度，順時針方向偏轉(zhuǎn)，無此項按:0 x0000填充該值采用了網(wǎng)絡(luò)字節(jié)序高程2unsigned short單位：米，無此項按:0 x0000填充該值采用了網(wǎng)絡(luò)字節(jié)序精度2unsigned short0 xFFFF:無效定位。無此項值設(shè)置為：0 x0000填充，否則按正常精度值填充。單位：米。該值采用了網(wǎng)絡(luò)字節(jié)序時間年2Unsigned short該值采用了網(wǎng)絡(luò)字節(jié)序月1byte日1byte時1byte分1byte秒1byte備用字段N 1024char該項非必須，如果沒有該字段內(nèi)容