管理規(guī)范 公司物流車輛管理在線系統(tǒng)標準開發(fā)規(guī)范

1、公司物流車輛管理在線系統(tǒng)標準開發(fā)規(guī)范文件編號202X QK011/ BT-ZTA-QK011文件狀態(tài)草稿J正式發(fā)布正在修改當前版本擬制日期審核日期目錄 TOC o 1-5 h z HYPERLINK l bookmark0 o Current Document 第一章引言5 HYPERLINK l bookmark2 o Current Document 編寫說明以及范圍5 HYPERLINK l bookmark4 o Current Document 承載方式5 HYPERLINK l bookmark6 o Current Document 第二章接口說明6 HYPERLINK l bo

2、okmark8 o Current Document 參數(shù)說明6 HYPERLINK l bookmark14 o Current Document 結(jié)果內(nèi)容說明6 HYPERLINK l bookmark16 o Current Document 錯誤代碼含義7注意事項8 HYPERLINK l bookmark26 o Current Document 第三章接口訪問安全控制說明9 HYPERLINK l bookmark28 o Current Document 訪問控制9 HYPERLINK l bookmark30 o Current Document 接口請求時間有效性9 HYPE

3、RLINK l bookmark32 o Current Document 接口調(diào)用頻率控制9 HYPERLINK l bookmark34 o Current Document 數(shù)據(jù)安全控制9 HYPERLINK l bookmark36 o Current Document 簽名 sign9 HYPERLINK l bookmark56 o Current Document 第四章詳細接口說明12 HYPERLINK l bookmark58 o Current Document 獲取免登云平臺的密鑰12 HYPERLINK l bookmark60 o Current Document

4、接 口 描述12 HYPERLINK l bookmark64 o Current Document 接口地址12 HYPERLINK l bookmark70 o Current Document 應用級參數(shù)說明（無）12 HYPERLINK l bookmark72 o Current Document 詳細返回結(jié)果說明12 HYPERLINK l bookmark78 o Current Document 云平臺免登14 HYPERLINK l bookmark80 o Current Document 接 口 描述14 HYPERLINK l bookmark84 o Current

5、Document 接口地址:15 HYPERLINK l bookmark90 o Current Document 獲取車輛的最新位置信息15 HYPERLINK l bookmark92 o Current Document 接 口 描述15 HYPERLINK l bookmark96 o Current Document 接口地址15 HYPERLINK l bookmark100 o Current Document 應用級參數(shù)說明16 HYPERLINK l bookmark102 o Current Document 詳細返回結(jié)果說明17 HYPERLINK l bookmark

6、112 o Current Document 以地圖模式獲取車輛的最新位置信息22 HYPERLINK l bookmark114 o Current Document 接 口 描述22 HYPERLINK l bookmark118 o Current Document 接口地址22 HYPERLINK l bookmark124 o Current Document 4.43.應用級參數(shù)說明23 HYPERLINK l bookmark126 o Current Document 返回結(jié)果示例23 HYPERLINK l bookmark128 o Current Document 獲取車

7、輛的軌跡信息23 HYPERLINK l bookmark130 o Current Document 接 口 描述23 HYPERLINK l bookmark134 o Current Document 接口地址24 HYPERLINK l bookmark138 o Current Document 應用級參數(shù)說明24 HYPERLINK l bookmark140 o Current Document 詳細返回結(jié)果說明25 HYPERLINK l bookmark152 o Current Document 以地圖模式獲取車輛的軌跡29 HYPERLINK l bookmark170

8、o Current Document 接 口 描述29 HYPERLINK l bookmark158 o Current Document 接口地址30 HYPERLINK l bookmark162 o Current Document 應用級參數(shù)說明30 HYPERLINK l bookmark164 o Current Document 返回結(jié)果說明（部分返回值）31 HYPERLINK l bookmark166 o Current Document 返回結(jié)果示例31 HYPERLINK l bookmark168 o Current Document 查詢圓形區(qū)域內(nèi)車輛的最新位置信

9、息31 HYPERLINK l bookmark186 o Current Document 接口描述31 HYPERLINK l bookmark190 o Current Document 接口地址32 HYPERLINK l bookmark196 o Current Document 應用級參數(shù)說明32 HYPERLINK l bookmark198 o Current Document 詳細返回結(jié)果說明33 HYPERLINK l bookmark184 o Current Document 查詢車輛的行駛里程37 HYPERLINK l bookmark208 o Current

10、Document 接口描述37 HYPERLINK l bookmark212 o Current Document 接口地址37 HYPERLINK l bookmark216 o Current Document 應用級參數(shù)說明38 HYPERLINK l bookmark218 o Current Document 詳細返回結(jié)果說明38 HYPERLINK l bookmark206 o Current Document 查詢車輛的進出區(qū)域明細信息41 HYPERLINK l bookmark226 o Current Document 接口描述41 HYPERLINK l bookma

11、rk230 o Current Document 接口地址41 HYPERLINK l bookmark236 o Current Document 應用級參數(shù)說明42 HYPERLINK l bookmark238 o Current Document 詳細返回結(jié)果說明42 HYPERLINK l bookmark224 o Current Document 查詢車輛的溫度信息45接 口 描述45 HYPERLINK l bookmark252 o Current Document 接 口地址45 HYPERLINK l bookmark300 o Current Document 應用級參

12、數(shù)說明46 HYPERLINK l bookmark302 o Current Document 詳細返回結(jié)果說明46 HYPERLINK l bookmark246 o Current Document 查詢車輛的加/偷油信息49接 口 描述49 HYPERLINK l bookmark274 o Current Document 接 口地址49 HYPERLINK l bookmark322 o Current Document 應用級參數(shù)說明50 HYPERLINK l bookmark324 o Current Document 詳細返回結(jié)果說明50 HYPERLINK l bookm

13、ark268 o Current Document 獲取車輛的照片信息，只支持單車查詢53 HYPERLINK l bookmark248 o Current Document 接口描述53 HYPERLINK l bookmark294 o Current Document 接 口地址53 HYPERLINK l bookmark176 o Current Document 應用級參數(shù)說明54 HYPERLINK l bookmark280 o Current Document 詳細返回結(jié)果說明54 HYPERLINK l bookmark288 o Current Document 查詢車

14、輛到達某個區(qū)域的預計時間和里程56 HYPERLINK l bookmark338 o Current Document 接 口 描述56 HYPERLINK l bookmark342 o Current Document 接 口地址56 HYPERLINK l bookmark400 o Current Document 應用級參數(shù)說明57 HYPERLINK l bookmark402 o Current Document 詳細返回結(jié)果說明57 HYPERLINK l bookmark310 o Current Document 根據(jù)時間間隔獲取車輛軌跡信息60 HYPERLINK l

15、bookmark390 o Current Document 接 口 描述60 HYPERLINK l bookmark394 o Current Document 接 口地址60應用級參數(shù)說明61 HYPERLINK l bookmark350 o Current Document 詳細返回結(jié)果說明61 HYPERLINK l bookmark336 o Current Document 查詢兩個地點間的預計時間和里程66接 口 描述66 HYPERLINK l bookmark370 o Current Document 接 口地址66應用級參數(shù)說明66 HYPERLINK l bookm

16、ark178 o Current Document 詳細返回結(jié)果說明67 HYPERLINK l bookmark364 o Current Document 獲取當前賬戶下的車輛信息69接 口 描述69 HYPERLINK l bookmark316 o Current Document 接 口地址69應用級參數(shù)說明70 HYPERLINK l bookmark388 o Current Document 根據(jù)地圖坐標轉(zhuǎn)化經(jīng)緯度72接口描述72 HYPERLINK l bookmark172 o Current Document 接 口地址72應用級參數(shù)說明73 HYPERLINK l bo

17、okmark258 o Current Document 詳細返回結(jié)果說明73第一章引言1工編寫說明以及范圍本文檔說明主要描述云平臺對外系統(tǒng)提供的應用接口以及WEB 頁面，便于客戶進行云系統(tǒng)的集成和對接。更方便于系統(tǒng)開發(fā)人員對 接口的使用。1.2.承載方式數(shù)據(jù)接口調(diào)用采用基于http的GET/POST調(diào)用方式。WEB接口采用直接訪問頁面的調(diào)用方式。第二章接口說明2.1.參數(shù)說明（系統(tǒng)級參數(shù)和應用級參數(shù)，系統(tǒng)級參數(shù)如下表，應用級參數(shù)根據(jù)具體接口不同）：參數(shù)名稱參數(shù)類型必選 項參數(shù)描述methodString是具體API接口名稱timestampString是時間戳，格式為yyyy-mm-dd H

18、H:mm:ss,例如：2013-05-06 13:52:03appkeyString是云平臺分配的公鑰signString是api接口輸入?yún)?shù)的簽名摘要formatString是返回數(shù)據(jù)格式xml或json不傳默認為json格式dataString是每一個接口的詳細參數(shù)22結(jié)果內(nèi)容說明參數(shù)名稱參數(shù)類型必選項參數(shù)描述CodeInt是調(diào)用接口返回結(jié)果1：成功非1：錯誤MessageString是接口調(diào)用不成功時返回的錯誤消息描述，DataString是接口返回結(jié)果,Code非1時為空，成功后返回 每個接口的詳細數(shù)據(jù)2.3.錯誤代碼含義錯誤碼含義解決方案1正確結(jié)果5參數(shù)都正確，沒有數(shù)據(jù)參數(shù)都正確，沒

19、有數(shù)據(jù)11用戶沒有訪問api的權 限確保已經(jīng)通過平臺得到相應接口的訪問權限21用戶請求未傳入method （請求的api名稱）參數(shù)檢查api方法中的method參數(shù)有無填寫， method為要調(diào)用的api名稱。22用戶請求的method找不 到相應的api與之對應檢查api方法中的method參數(shù)有無填寫， method為要調(diào)用的api名稱。24用戶請求未傳入sign（請求簽名）參數(shù)根據(jù)說明生成簽名詳細介紹，訪問接口時傳入25用戶請求傳入的sign參 數(shù)驗證錯誤。服務端用 傳入的參數(shù)按照約定方 法簽名得到的值與傳入 的sign參數(shù)不一樣根據(jù)說明生成簽名詳細介紹，訪問接口時傳入28用戶請求未傳入

20、appkey （應用標記key）參數(shù)確保輸入授權成功后給的公鑰29用戶請求傳入的appkey 找不到對應的應用確保輸入授權成功后給的公鑰30用戶請求未傳入 timestamp （時間戳）參 數(shù)檢查訪問接口參數(shù)中是否包含timestamp參 數(shù)，如存在timestamp參數(shù)則該參數(shù)是否為 yyyy-mm-dd HH:mm:ss 格式31用戶請求傳入的參數(shù)格式必須是yyyy-mm-dd HH:mm:ss,不能timestamp參數(shù)不是合 法的格式以其他格式傳入32時間戳不在規(guī)定范圍內(nèi)檢查訪問接口參數(shù)中是否包含timestamp參 數(shù)，如存在timestamp參數(shù)則該參數(shù)是否為 yyyy-mm-dd

21、HH: ii: ss 格式，如存在 timestamp 參數(shù)且格式正確，則檢驗timestamp對應時間 是否在當前時間（北京時間）前后6分鐘（360 秒）內(nèi)。例如：當前時間為2014-11-08 17:51:00 ,接口 參數(shù)中 timestamp 為 2014-11-08 17:30:00,時間戳參數(shù)與當前時 間差值為21分鐘，大于規(guī)定的6分鐘40少必傳參數(shù)XXX （XXX為 參數(shù)名字）根據(jù)詳細文檔說明，在配置api請求時，給data 當中添加相應的屬性參數(shù)，并保證格式正確41傳入的參數(shù)XXX （XXX為 參數(shù)名字）格式錯誤根據(jù)詳細文檔說明，在配置api請求時，給data 當中添加相應的屬

22、性參數(shù)，并保證格式正確42詳細錯誤具體的錯誤52服務端執(zhí)行異常聯(lián)系相關技術人員503http請求獲得內(nèi)容為此 響應，表示當前ip并發(fā) 請求數(shù)過高造成服務器 ddos防攻擊控制報錯?？刂普{(diào)用接口 api的頻率，如不能通過控制頻 率解決聯(lián)系相關工作人員24注意事項a接口的參數(shù)名稱都要小寫，參數(shù)值除了特定的都小寫b數(shù)據(jù)編碼格式：UTF-8c. 一些特殊的接口方法返回結(jié)果以Web頁面呈現(xiàn)第三章接口訪問安全控制說明訪問控制API接口訪問必須經(jīng)過公司授權后才可以使用，授權成功后會得 到授權碼（公鑰和密鑰，分別是：appkey, appsecret），在每次訪問 API接口時必須指定公鑰。否則訪問就會被拒絕

23、。接口請求時間有效性外部系統(tǒng)調(diào)用API接口時，每次都要傳參數(shù)timestamp, API服 務端允許客戶端請求時間誤差為6分鐘。接口調(diào)用頻率控制同一接口調(diào)用頻率必須在1毫秒以上。數(shù)據(jù)安全控制調(diào)用API接口時需要對請求參數(shù)進行簽名驗證，服務器也會對該 請求參數(shù)進行驗證是否合法。防止數(shù)據(jù)被傳遞過程當中發(fā)生數(shù)據(jù)篡改。 具體簽名算法見下列。簽名 sign具體算法為：根據(jù)傳入?yún)?shù)名稱（簽名sign除外）將所有請求 參數(shù)按照首字母先后順序排序，md5 （密鑰+除密鑰外排好序的參數(shù)串+密鑰）后轉(zhuǎn)換為大寫字母。調(diào)用示例：外部系統(tǒng)獲得的公鑰和密鑰分別為：appkey = abe10b89-8185-483a-b

24、28f-894f7957f78dappsecret = 184CD4DF-C5D2-4F55-8539-ED45D4E91FBB（注意：調(diào)用時需將獲取的公鑰和密鑰原樣傳入，不得改變大小 寫、不得去掉“）獲取車輛最新位置信息接口的參數(shù)如下：method=GetVehcilelnfoappkey= abe10b89-8185-483a-b28f-894f7957f78d timestamp=2014-11 -8 11:47:42format = jsonvehicle =陜 A0000sessi onid =計算結(jié)果如下md5(*184CD4DF-C5D2-4F55-8539-ED45D4E91

25、FBBappkeyabel 0 b89-8185-483a-b28f-894f7957f78dformatjsonmethodGetVehcilelnfosessionidtimestamp2014-11 -811:47:42vehicle陜A0000184CD4DF-C5D2-4F55-8539-ED45D4E91FBB)計算結(jié)果為：F974B39EA75655663A4C1E552335864B備注：記得加密結(jié)果轉(zhuǎn)換為大寫字母格式后即為所需簽名。各個方法由于參數(shù)不一致所以簽名也不一樣。第四章詳細接口說明獲取免登云平臺的密鑰接口描述獲取免登云平臺的密鑰。接口地址 HYPERLINK /pub

26、lic/v3/lnface/Call /public/v3/lnface/Call?method=GetLogi nStr& appkey=abe10b89-8185-483a-b28f-894f7957f78d×tamp=2014-12-26 10:27:26& format=json&sign二生成的簽名系統(tǒng)級參數(shù)詳見21參數(shù)說明應用級參數(shù)說明（無）4.1.4.詳細返回結(jié)果說明序號屬性描述屬性說明示例1LoginKey免登的憑證unc80sDeNsclMQ9s00hmuRa cYm+2Vr0nP94bSlJqhwjQYg LRMBhpC2RZdrbj29s0 xHQu/ ZgC3

27、JU=返回結(jié)果示例：(1) xml 格式:1unc80sDeNsclMQ9sOOhmuRacYm+2Vr0nP94bS1JqhwjQYgLRMBhpC2RZdrbj29s0 xHQu/ZgC3JU=(2) JSON 格式:result:,code,:,T,” messaged”：data:nLoginKey:Munc80sDeNsc60szdbdf1 + mN7dnvgxFEh85xp4H/T2hEVyctqC636z8R WU1 /ZgfEfBXP34bcyAU E=H4.2.云平臺免登4.2.1.接口描述先調(diào)用4.1接口獲取到免登憑證，然后再用憑證免登到云平臺4.2.2.接口地址: HYP

28、ERLINK /Home/LoginWithToken2sid%e4%ba%8c%e5%85%8d /Home/LoginWithToken2sid二免 登憑證&url二跳轉(zhuǎn)的平臺頁面如下：免登到子用戶管理 HYPERLINK http:/logi http:/logi n.e6gps.corn/Horne/Logi nWithlbke n? sid=un c80sDe Nsc60szdbdf1+mN7dnvgxFEh85xp4HVT2hEVyctqC636z8RWU1V ZgfEfBXP34bcyAUE=&url 二 HYPERLINK /Setting/E6Use /Setting/E6U

29、se r/SelE6User獲取車輛的最新位置信息接口描述獲取用戶車輛的最新位置信息接口地址 HYPERLINK /public/v3/lnface/Call /public/v3/lnface/Call?method=GetVehcilel nfo& appkey=abe10b89-8185-483a-b28f-894f7957f78d×tamp=2014-11 -8 11:47:42&format=json&vehicle=-1&sessi on id=,n&isoffsetl on lat=O&sign=生成的簽名系統(tǒng)級參數(shù)詳見21參數(shù)說明4.3.3.應用級參數(shù)說明參數(shù)名稱參數(shù)

30、類型必選參數(shù)描述vehicleString是需要查詢的車牌，支持多車查詢，車牌之間 用英文逗號分割，-1表示全部車輛sessionidString是增量更新ID,首次查詢時sessionid, 表示獲取全部數(shù)據(jù)；再次查詢時，將上次 查詢返回結(jié)果中的message的值賦給 sessionidisoffsetlonlatstring否是否返回偏移經(jīng)緯度（GCJ-02經(jīng)緯度）1需要0.不需要4.3.4.詳細返回結(jié)果說明序號屬性描述屬性說明示例1Vehicle車牌蘇 AF55952GPSTime定位時間2014-10-16 08:48:543Speed速度144Odometer里程287817. 70

31、05Lat緯度（WGS-84坐標系）31.2096676Lon經(jīng)度（WGS-84坐標系）121.5354697Direction車頭方向1988Status狀態(tài)ACC開,3D定位，天線正常， 冷機開，門關，門關49PlaceName車輛位置直轄市上海市閔行區(qū)10Provice省直轄市11City市上海市12District區(qū)閔行區(qū)13RoadName路名信息景聯(lián)路南82米（普通路）14T1溫度i(c)515T2溫度2(C)1516T3溫度3 (C)1317T4溫度4（C）218Lat02偏移緯度（GCJ-02緯度）33. 32654519Lon02偏移經(jīng)度（GCJ-02經(jīng)度）113.33215

32、420AreaName地標名稱黃埔江公寓返回結(jié)果示例：(1) xml格式161ab13c4-6f81-4804-8258-79ad49bd6ce4豫 AB16182014-06-06 17:18:38O15589.30034.746082113.7651370 v/Directi onACC關,1D定位，天線斷開,ACC關,1D定位，天線 斷開 20597334.748082113.767137 黃埔江公寓 v/AreaName(2) json格式result:“codeYT,”message”:“61 ab13c4-6f81 -4804-8258-79ad49bd6ce4”，data:“Ve

33、hicle”： ”豫AB1618,nGPSTimen: n2014-06-06 仃48:38”，“Speed”： 0,Odometer: 15589.3, nLatH: 34.746082,” Lon”： 113.765137,“Direction”: 0,“Status”: “ACC關,1D定位，天線斷開,ACC關定位,天線斷開”，PlaceNameH:,H,“Provice”:匸“City”： m,”District”: m,RoadName: ”，“VehiclelD”： 205973,“T 兀 Hll，T29911“T3”： UllHLatO2H: 34.746082,MLon02M:

34、 113.765137,HAreaNameM: ”黃埔江公寓”以地圖模式獲取車輛的最新位置信息接口描述以地圖模式獲取用戶車輛最新位置信息接口地址 HYPERLINK /public/v3/MapServices/Orientatio /public/v3/MapServices/Orientatio n.aspx?appkey=abel0b89-8185-483a-b28f-894f7957f78d×tamp=2014-12-02 16:15:22&vehicle二123456&sign二生成的簽名系統(tǒng)級參數(shù)詳見2.1參數(shù)說明4.4.3.應用級參數(shù)說明參數(shù)名稱參數(shù)類型必選 項參數(shù)描述

35、vehicleString是需要查詢的車牌，支持多車查詢，車牌之間 用英文逗號分割，-1表示全部車輛4.4.4.返回結(jié)果示例I市酢車她胃信息浙 A9D639:1900-01-01 00 00 00里程:0000km:OknVhuB:廣東省佛山市鯽區(qū)血踣:S112?R65*(iftB)曬際KS!8:棒線貝*(2014-10-16 08 48 16)報車觸畑:范中坤(10T ) 1S&25611663垛段:11394561:22 53976獲取車輛的軌跡信息4.5.1.接口描述獲取用戶車輛的軌跡信息4.5.2.接口地址 HYPERLINK /public/v3/StatisticsReport/C

36、all /public/v3/StatisticsReport/Call?method二GetTrackDetail& appkey=abe10b89-8185-483a-b28f-894f7957f78d×tamp=2014-12-02 09:37:05& format=json& vehicle=123456&btime=2013-03-22 21:11:54.000&etime=2013-03-26 21:11:54.000&isoffsetl on lat=1 &sign=生成的簽名系統(tǒng)級參數(shù)詳見21參數(shù)說明4.5.3.應用級參數(shù)說明參數(shù)名稱參數(shù)類型必選 項參數(shù)描述vehic

37、leString是需要查詢的車牌，支持一臺車查詢btimestring是開始時間etimestring是結(jié)束時間isoffsetlonlatstring否是否返回偏移經(jīng)緯度（GCJ-02經(jīng)緯度）1.需要0.不需要4.5.4.詳細返回結(jié)果說明序號屬性描述屬性說明示例1Vehicle車牌1234562GPSTimeGPS時間2013-03-22 21:11:543Lat緯度（WGS-84坐標系）33.3265454Lon經(jīng)度（WGS-84坐標系）113.3321545Direction車頭方向（0-360 ）86OdometerGPS里程0. 0007Speed速度08PlaceName車輛位置廣

38、東省深圳市南山區(qū)科技 南一路（普通）9RoadName路名信息高新南四道10Tempi1路溫度（C）011Temp22路溫度（9）012Temp33路溫度CC）013Temp44路溫度（C）014Lat02偏移緯度（GCJ-02緯度）33. 32654515Lon02偏移經(jīng)度（GCJ-02經(jīng)度）113.332154返回結(jié)果示例:(1) XML 格式:11234562013-03-22 21:11:54113.937801 22.53920680.000O廣東省深圳市南山區(qū)高新南四道（普通） 高新南四道 v/RoadName0000113.937801 22.539206(2) Json 格式：

39、result:“code”:”，” message”:”，data: ”Vehicle”:”123456”，,GPSTime,:,2013-03-22 21:11:54n,HLonH:113.937801,HLaf:22.539206,” Direction”,0dometer:0.000,“Speed”:。， PlaceName:*廣東省深圳市南山區(qū)科技南一路（普通幾,RoadName,:H 高新南四道”,HTemp1M:0,HTemp2n:0,” Temp3”:0,“Temp4”:0,MLon02n:113.937801,Lat02,:22.53920646以地圖模式獲取車輛的軌跡4.61

40、接口描述以地圖模式獲取用戶車輛的軌跡4.6.2.接口地址 HYPERLINK /public/v3/MapServices/PlayTrack.aspx /public/v3/MapServices/PlayTrack.aspx?appkey=abe10b89-8185-483a-b28f-894f7957f78d×tamp=2014-12-02 17:06:18& vehicle=123456&btime=2013-03-22 21:11:54&etime=2013-03-26 21:11:54&sign=生成的簽名系統(tǒng)級參數(shù)詳見21參數(shù)說明4.6.3.應用級參數(shù)說明參數(shù)名稱參數(shù)類

41、型必選項參數(shù)描述vehicleString是需要查詢的車牌，只支持一臺車btimeString是開始時間etimeString是結(jié)束時間返回結(jié)果說明（部分返回值）仁操作超時2：請勿禁用Cookie3：只能播放十天以內(nèi)的數(shù)據(jù) -4：缺少參數(shù)返回結(jié)果示例8N0115K1M3-262111MA 31cm Q二母Ml5-tB SyflW47查詢圓形區(qū)域內(nèi)車輛的最新位置信息4.7.1.接口描述查詢圓形區(qū)域內(nèi)用戶車輛的最新位置信息4.7.2.接口地址 HYPERLINK /public/v3/lnface/Call /public/v3/lnface/Call?method=GetVehcilelnfoW

42、ithPoint& appkey=abe10b89-8185-483a-b28f-894f7957f78d×tamp=2014-11-25 16:09:05& format=json& lon=113.94561& lat=22.53976&distance=500 &sign=生成的簽名系統(tǒng)級參數(shù)詳見21參數(shù)說明4.7.3.應用級參數(shù)說明參數(shù)名稱參數(shù)類型必選項參數(shù)描述Iondecimal是圓形中心點經(jīng)度（WGS-84坐標系）latdecimal是圓形中心點緯度（WGS-84坐標系）distanceint是圓形的半徑（米）4.7.4.詳細返回結(jié)果說明序號屬性描述屬性說明示例1Vehi

43、cle車牌1234562GPSTimeGPS時間2015-1-4 10:45:413Speed速度04Odometer開始地點0. 0005Lat緯度（WGS-84坐標系）22. 539766Lon經(jīng)度（WGS-84坐標系）113. 945617Direction車頭方向（0-360 ）08Status狀態(tài)9PlaceName車輛位置廣東省佛山市順德區(qū)10Provice省廣東省11City市佛山市12District區(qū)順德區(qū)13RoadName路名信息S112東65米（普通路）返回結(jié)果示例:(1) xml格式11234561900-01-01 00:00:0000.00022.53976113

44、.94561 0 v/Directi onvPlaceName廣東省佛山市順德區(qū)v/PlaceNamevProvice 廣東省 佛山市v/City順德區(qū) S112 東 65 米(普通路)(2) json格式result:,code,:,r,message:,data:,Vehicle,:,123456H,GPSTime,:,1900-01-01 00:00:00,“Speed”:。，0dometer:0.000,Lat,:22.53976,Lonn:113.94561,“Direction”:。，“Status”:：,PlaceName,:H廣東省佛山市順德區(qū)”,“Provice”:” 廣東省

45、”，“City”:” 佛山市”，“District”:” 順德區(qū)”，,RoadName,:,S112 東 65 米（普通路）”48查詢車輛的行駛里程接口描述查詢用戶車輛行駛里程接口地址 HYPERLINK http:/api http:/api. e6gps com/public/v3/StatisticsReport/Call?method二GetVehicleOdometer&appkey=abel0b89-8185-483a-b28f-894f7957f78d×tamp=2014-12-02 2010:13:11&format二json&vehicles二123456&btim

46、e=2014-01-19&etime二2014-11-23&sign二生成的簽名系統(tǒng)級參數(shù)詳見21參數(shù)說明4.8.3.應用級參數(shù)說明參數(shù)名稱參數(shù)類型必選 項參數(shù)描述vehiclesString是需要查詢的車牌,支持多車查詢，車牌之間 用英文逗號分割，-1表示全部車輛btimeString是開始時間etimeString是結(jié)束時間4.8.4.詳細返回結(jié)果說明序號屬性描述屬性說明示例1Vehicle車牌1234562StartTime開始時間2014-08-263StartOdometer開始時里程數(shù)據(jù)0. 0004StartPlaceName開始地點深圳市南山區(qū)5EndTime結(jié)束時間2014-

47、10-216EndOdometer結(jié)束時里程數(shù)據(jù)0. 0007EndPlaceName結(jié)束地點8DiffOdometer此段時間內(nèi)的里程數(shù)據(jù)0. 000返回結(jié)果示例:(1) xml格式11234562014-08-260.000,2014-10-210.000,0.000(2) json 格式result:“code 吟 T,“message”:：data:” Vehicle”:T23456”，,StartTime,:,2014-08-26n,Sta rtOd omete r*:0.000,StartPlaceName,:,H,EndTime,:,2014-10-21H,EndOdometer

48、O.OOO,EndPlaceName,:,JDiff0dometer:0.0004.9.查詢車輛的進出區(qū)域明細信息接口描述查詢用戶車輛的進出區(qū)域明細信息接口地址 HYPERLINK /public/v3/StatisticsReport/Call /public/v3/StatisticsReport/Call?method=GetVechileslnOutArealnfo& appkey=abe10b89-8185-483a-b28f-894f7957f78d×tamp=2014-12-02 11:49:28& format=json&vehicles=123456& btime=

49、2014-10-10 12:58:45&etime=2014-11-20 07:35:39&sign=生成的簽名系統(tǒng)級參數(shù)詳見21參數(shù)說明4.9.3.應用級參數(shù)說明參數(shù)名稱參數(shù)類型必選 項參數(shù)描述vehiclesString是需要查詢的車牌,支持多車查詢，車牌之間 用英文逗號分割，-1表示全部車輛btimeString是開始時間etimeString是結(jié)束時間4.9.4.詳細返回結(jié)果說明序號屬性描述屬性說明示例1Vehicle車牌1234562GPSTime定位時間2014-11-19 20:26:343Lat緯度（WGS-84坐標系）30. 1011664Lon經(jīng)度（WGS-84坐標系）12

50、0. 6421975CustomArea區(qū)域名稱6PassType進出狀態(tài)（進：1,出：2）1返回結(jié)果示例:(1) xml格式11234562014-11-19 20:26:34120.64219730.1011661 (2) json格式result:“codeTT,” message”:匸data:,Vehicle,:,123456,JHGPSTimeH:H2014-11-19 20:26:34”,HLonH:120.642197,”Lat”:30.10 笛 66,CustomArea:,”PassType”:14.10查詢車輛的溫度信息接口描述查詢用戶車輛的溫度信息接口地址 HYPERL

51、INK /public/v3/StatisticsReport/Call /public/v3/StatisticsReport/Call?method=GetVehicleTemperaturelnfo& appkey=abe10b89-8185-483a-b28f-894f7957f78d×tamp=2014-12-02 10:52:11& format=js on& vehicle=123456& btime=2014-11-07& etime=2014-11-8&sign二生成的簽名系統(tǒng)級參數(shù)詳見2.1參數(shù)說明4.10.3.應用級參數(shù)說明參數(shù)名稱參數(shù)類型必選項參數(shù)描述vehi

52、cleString是需要查詢的車牌，只支持一臺車btimeString是開始時間etimeString是結(jié)束時間4.10.4.詳細返回結(jié)果說明序號屬性描述屬性說明示例1GPSTime定位時間2014-11-27 07:56:532Lon經(jīng)度（WGS-84坐標系）113.6612853Lat緯度（WGS-84坐標系）34.6597334Temperature溫度1CC）-29. 505Temperature2溫度2(C)-999. 006Temperature3溫度3 (C)-999. 007Temperature4溫度4（C）-999. 008ColdStatus冷機狀態(tài)1返回結(jié)果示例:(1)

53、 xml格式12014-11-27 07:56:53113.66128534.659733-29.50-999.00-999.00-999.001 (2) json格式result:“codeTT,” message”:”，data:”GPSTime”:”2014笛07 09:37:3廣,HLon,:116.497215,”Lat”:39.083183,Temperaturen:3.50,Temperature2:3.50,”Temperature3”:999.00,Temperature4:-999.00,HColdStatusH:14.11.查詢車輛的加/偷油信息4.111接口描述查詢某用

54、戶車輛時間段內(nèi)油量信息4.11.2. 接口地址 HYPERLINK /public/v3/StatisticsReport/Call /public/v3/StatisticsReport/Call?method=GetVechileOilExpe ndlnfo& appkey=abe10b89-8185-483a-b28f-894f7957f78d×tamp=2014-12-02 11:23:28& format=js on& vehicles 二粵 BN0115& btime=2014-10-29 19:42:11& etime=2014-11-25 14:08:14 &sign

55、=生成的簽名系統(tǒng)級參數(shù)詳見21參數(shù)說明4口3應用級參數(shù)說明參數(shù)名稱參數(shù)類型必選 項參數(shù)描述vehiclesString是需要查詢的車牌，支持多車查詢，車牌之間 用英文逗號分割，-1表示全部車輛btimeString是開始時間etimeString是結(jié)束時間4.11.4.詳細返回結(jié)果說明序號屬性描述屬性說明示例1Vehicle車牌粵 BNO1152GPSTime定位時間2014-10-29 20:40:103Lat緯度（WGS-84坐標系）23.2570504Lon經(jīng)度（WGS-84坐標系）113.2297125TYPE傳輸類型（TCP或UDP）16Odometer里程34171.00070訂油

56、量91. 1128PlaceName地點返回結(jié)果示例:(1) xml格式1vVehicle粵 BN01152014-10-29 20:40:1023.257050113.229712vTY PE134171.00091.112(2) json格式result:,code,:HT,” message”:：data:“Vehicle”:”粵 BN0115H,GPSTimeOI4-10-29 20:40:10”,” Lat”:23257050,“Lon”:笛 3.229712,”TY PEn:1”0domete”:34171.000, ”O(jiān):91 笛 2,PlaceName,:m,4.12獲取車輛的

57、照片信息f只支持單車查詢412：L接口描述查詢用戶車輛的照片信息，只支持單車查詢4.12.2. 接口地址 HYPERLINK /public/v3/StatisticsReport/Call /public/v3/StatisticsReport/Call?method=GetGPSPicture& appkey=abe10b89-8185-483a-b28f-894f7957f78d×tamp=2014-12-02 11:57:28& format=json& vehicle=粵 BN0115& btime=2014-07-31 16:46:08& etime=2014-07-31

58、 23:47:29 &sign=生成的簽名系統(tǒng)級參數(shù)詳見21參數(shù)說明4123應用級參數(shù)說明參數(shù)名稱參數(shù)類型必選 項參數(shù)描述vehicleString是需要查詢的車牌，只支持一臺車btimeString是開始時間etimeString是結(jié)束時間4.12.4.詳細返回結(jié)果說明序號屬性描述屬性說明示例1Vehicle車牌粵 BN01152PictureTime獲取圖片時間2014-07-31 23:45:233PictureData圖片System. Byte返回結(jié)果示例:(1) xml格式1粵 BN01152014-07-31 23:45:23 System.Byte(2) json格式resul

59、t:,code,:,r,“message”:：data:“Vehicle”:” 粵 BNO 笛 5”，TictureTimeOI 4-07-31 23:45:23”， PictureData:System.Byten4.13.查詢車輛到達某個區(qū)域的預計時間和里程413：L接口描述查詢車輛到達某個區(qū)域的預計時間和里程4.13.2. 接口地址 HYPERLINK /public/v3/Other/Call /public/v3/Other/Call?method 二 GetDrivel nfo& appkey= abe10b89-8185-483a-b28f-894f7957f78d×t

60、amp= 2015-05-25 17:05:50& format=js on&linetype=2&vehicleno=陜 A54321&areacode= 20004&sign二生成的簽名系統(tǒng)級參數(shù)詳見21參數(shù)說明4.13.3.應用級參數(shù)說明參數(shù)名稱參數(shù)類型必選 項參數(shù)描述linetypeint是導航類型。0:最快路線1:最短路線2: 避開髙速3:般vehiclenoString是需要查詢的車牌，只支持一臺車areacodeString是區(qū)域自編號4.13.4.詳細返回結(jié)果說明序號屬性描述屬性說明示例1VehicleNo車牌號陜 A543212GPSTime車輛最新定位時間2015-05-2