汽車(chē)信息娛樂(lè)系統(tǒng)通信協(xié)議規(guī)范_第1頁(yè)
汽車(chē)信息娛樂(lè)系統(tǒng)通信協(xié)議規(guī)范_第2頁(yè)
汽車(chē)信息娛樂(lè)系統(tǒng)通信協(xié)議規(guī)范_第3頁(yè)
汽車(chē)信息娛樂(lè)系統(tǒng)通信協(xié)議規(guī)范_第4頁(yè)
汽車(chē)信息娛樂(lè)系統(tǒng)通信協(xié)議規(guī)范_第5頁(yè)
已閱讀5頁(yè),還剩100頁(yè)未讀, 繼續(xù)免費(fèi)閱讀

下載本文檔

版權(quán)說(shuō)明:本文檔由用戶(hù)提供并上傳,收益歸屬內(nèi)容提供方,若內(nèi)容存在侵權(quán),請(qǐng)進(jìn)行舉報(bào)或認(rèn)領(lǐng)

文檔簡(jiǎn)介

1、95/105項(xiàng)目名稱(chēng): 北京汽車(chē)信息娛樂(lè)系統(tǒng)通信協(xié)議規(guī)范-TSP平臺(tái)與DVDVer1.1北京汽車(chē)股份有限公司2011年07月目 錄 TOC o 1-9 t 標(biāo)題 9;9;標(biāo)題 8;8;標(biāo)題 7;7;標(biāo)題 6;6;標(biāo)題 5;5;標(biāo)題 4;4;標(biāo)題 3;3;標(biāo)題 2;2;標(biāo)題 1;1;標(biāo)題 1;1;標(biāo)題 1;1;標(biāo)題 1;1;Heading A;1;樣式 標(biāo)題 1 + 宋體;1;Heading A;1;Heading A;1;樣式 標(biāo)題 1 + 宋體;1;Heading A;1;樣式 標(biāo)題 1 + 宋體;1;標(biāo)題 2;2;標(biāo)題 2;2;標(biāo)題 2;2;Heading B;2;Heading B;2;

2、Heading B;2;Heading B;2;標(biāo)題 3;3;標(biāo)題 3;3;標(biāo)題 3;3;樣式1;3;樣式1;3;樣式1;3;樣式1;3;標(biāo)題 4;4;標(biāo)題 4;4;標(biāo)題 4;4;樣式 標(biāo)題 4 + Arial 五號(hào);4;樣式 標(biāo)題 4 + Arial 五號(hào);4;標(biāo)題 5;5;標(biāo)題 5;5;標(biāo)題 5;5;樣式 標(biāo)題 5 + Arial;5;標(biāo)題 5 + Arial + 宋體 五號(hào) 加粗;5;樣式 標(biāo)題 5 + Arial;5;標(biāo)題 5 + Arial + 宋體 五號(hào) 加粗;5;標(biāo)題 6;6;標(biāo)題 6;6;標(biāo)題 6;6;樣式 樣式 標(biāo)題 5 + Arial + 宋體 五號(hào) 非加粗 紅色;6;樣式

3、2;6;標(biāo)題6;6;樣式4;6;樣式 樣式 標(biāo)題 5 + Arial + 宋體 五號(hào) 非加粗 紅色;6;樣式2;6;標(biāo)題6;6;樣式4;6;標(biāo)題 7;7;標(biāo)題 7;7;標(biāo)題 7;7;標(biāo)題 8;8;標(biāo)題 8;8;標(biāo)題 8;8;標(biāo)題 9;9;標(biāo)題 9;9;標(biāo)題 9;9 h HYPERLINK l _Toc320537988 1文檔簡(jiǎn)介 PAGEREF _Toc320537988 h 1 HYPERLINK l _Toc320537989 1.1協(xié)議講明 PAGEREF _Toc320537989 h 1 HYPERLINK l _Toc320537990 1.2數(shù)據(jù)類(lèi)型 PAGEREF _Toc3

4、20537990 h 1 HYPERLINK l _Toc320537991 1.3編碼講明 PAGEREF _Toc320537991 h 1 HYPERLINK l _Toc320537992 1.4注釋講明 PAGEREF _Toc320537992 h 1 HYPERLINK l _Toc320537993 1.5符號(hào)講明 PAGEREF _Toc320537993 h 1 HYPERLINK l _Toc320537994 1.6加密 PAGEREF _Toc320537994 h 1 HYPERLINK l _Toc320537995 1.7度量單位 PAGEREF _Toc320

5、537995 h 1 HYPERLINK l _Toc320537996 2協(xié)議框架 PAGEREF _Toc320537996 h 2 HYPERLINK l _Toc320537997 2.1協(xié)議概述 PAGEREF _Toc320537997 h 2 HYPERLINK l _Toc320537998 2.2協(xié)議講明 PAGEREF _Toc320537998 h 2 HYPERLINK l _Toc320537999 2.2.1協(xié)議請(qǐng)求頭 PAGEREF _Toc320537999 h 2 HYPERLINK l _Toc320538000 2.2.2應(yīng)答請(qǐng)求頭 PAGEREF _To

6、c320538000 h 3 HYPERLINK l _Toc320538001 3DVD接口協(xié)議講明 PAGEREF _Toc320538001 h 4 HYPERLINK l _Toc320538002 3.1消息服務(wù) PAGEREF _Toc320538002 h 4 HYPERLINK l _Toc320538003 3.1.1消息分類(lèi)獵取 PAGEREF _Toc320538003 h 4 HYPERLINK l _Toc320538004 應(yīng)答結(jié)果 PAGEREF _Toc320538004 h 4 HYPERLINK l _Toc320538005 .1數(shù)據(jù)結(jié)構(gòu) PAGEREF

7、_Toc320538005 h 4 HYPERLINK l _Toc320538006 .2應(yīng)答示例 PAGEREF _Toc320538006 h 5 HYPERLINK l _Toc320538007 3.1.2消息列表獵取 PAGEREF _Toc320538007 h 5 HYPERLINK l _Toc320538008 應(yīng)答結(jié)果 PAGEREF _Toc320538008 h 6 HYPERLINK l _Toc320538009 .1數(shù)據(jù)結(jié)構(gòu) PAGEREF _Toc320538009 h 6 HYPERLINK l _Toc320538010 .2應(yīng)答示例 PAGEREF _T

8、oc320538010 h 7 HYPERLINK l _Toc320538011 3.1.3消息詳情獵取 PAGEREF _Toc320538011 h 8 HYPERLINK l _Toc320538012 消息詳情獵取獵取 PAGEREF _Toc320538012 h 8 HYPERLINK l _Toc320538013 .1請(qǐng)求參數(shù) PAGEREF _Toc320538013 h 8 HYPERLINK l _Toc320538014 .2應(yīng)答結(jié)果 PAGEREF _Toc320538014 h 9 HYPERLINK l _Toc320538015 .2.1數(shù)據(jù)結(jié)構(gòu) PAGERE

9、F _Toc320538015 h 9 HYPERLINK l _Toc320538016 .2.2應(yīng)答示例 PAGEREF _Toc320538016 h 10 HYPERLINK l _Toc320538017 下載附件 PAGEREF _Toc320538017 h 14 HYPERLINK l _Toc320538018 .1請(qǐng)求參數(shù) PAGEREF _Toc320538018 h 14 HYPERLINK l _Toc320538019 .2應(yīng)答結(jié)果 PAGEREF _Toc320538019 h 15 HYPERLINK l _Toc320538020 .2.1數(shù)據(jù)結(jié)構(gòu) PAGER

10、EF _Toc320538020 h 15 HYPERLINK l _Toc320538021 .2.2應(yīng)答示例 PAGEREF _Toc320538021 h 15 HYPERLINK l _Toc320538022 3.2保養(yǎng)服務(wù) PAGEREF _Toc320538022 h 16 HYPERLINK l _Toc320538023 3.2.1保養(yǎng)記錄查詢(xún) PAGEREF _Toc320538023 h 16 HYPERLINK l _Toc320538024 請(qǐng)求參數(shù) PAGEREF _Toc320538024 h 16 HYPERLINK l _Toc320538025 應(yīng)答結(jié)果 P

11、AGEREF _Toc320538025 h 16 HYPERLINK l _Toc320538026 3.2.2查詢(xún)當(dāng)次保養(yǎng)狀態(tài) PAGEREF _Toc320538026 h 18 HYPERLINK l _Toc320538027 請(qǐng)求參數(shù) PAGEREF _Toc320538027 h 18 HYPERLINK l _Toc320538028 應(yīng)答結(jié)果 PAGEREF _Toc320538028 h 18 HYPERLINK l _Toc320538029 3.2.3取消當(dāng)次保養(yǎng)提醒 PAGEREF _Toc320538029 h 19 HYPERLINK l _Toc32053803

12、0 請(qǐng)求參數(shù) PAGEREF _Toc320538030 h 19 HYPERLINK l _Toc320538031 應(yīng)答結(jié)果 PAGEREF _Toc320538031 h 19 HYPERLINK l _Toc320538032 3.3一鍵導(dǎo)航 PAGEREF _Toc320538032 h 20 HYPERLINK l _Toc320538033 3.3.1獵取設(shè)定位置 PAGEREF _Toc320538033 h 20 HYPERLINK l _Toc320538034 請(qǐng)求參數(shù) PAGEREF _Toc320538034 h 20 HYPERLINK l _Toc32053803

13、5 應(yīng)答結(jié)果 PAGEREF _Toc320538035 h 21 HYPERLINK l _Toc320538036 3.4網(wǎng)絡(luò)檢索 PAGEREF _Toc320538036 h 24 HYPERLINK l _Toc320538037 3.4.1關(guān)鍵字檢索 PAGEREF _Toc320538037 h 24 HYPERLINK l _Toc320538038 請(qǐng)求參數(shù) PAGEREF _Toc320538038 h 24 HYPERLINK l _Toc320538039 應(yīng)答結(jié)果 PAGEREF _Toc320538039 h 25 HYPERLINK l _Toc320538040

14、 3.4.2POI分類(lèi)檢索 PAGEREF _Toc320538040 h 27 HYPERLINK l _Toc320538041 請(qǐng)求參數(shù) PAGEREF _Toc320538041 h 27 HYPERLINK l _Toc320538042 應(yīng)答結(jié)果 PAGEREF _Toc320538042 h 28 HYPERLINK l _Toc320538043 3.4.3交叉路檢索 PAGEREF _Toc320538043 h 30 HYPERLINK l _Toc320538044 請(qǐng)求參數(shù) PAGEREF _Toc320538044 h 30 HYPERLINK l _Toc32053

15、8045 應(yīng)答結(jié)果 PAGEREF _Toc320538045 h 31 HYPERLINK l _Toc320538046 3.4.4周邊POI檢索 PAGEREF _Toc320538046 h 32 HYPERLINK l _Toc320538047 請(qǐng)求參數(shù) PAGEREF _Toc320538047 h 32 HYPERLINK l _Toc320538048 應(yīng)答結(jié)果 PAGEREF _Toc320538048 h 33 HYPERLINK l _Toc320538049 3.5新聞 PAGEREF _Toc320538049 h 35 HYPERLINK l _Toc320538

16、050 3.5.1新聞分類(lèi)查詢(xún) PAGEREF _Toc320538050 h 35 HYPERLINK l _Toc320538051 請(qǐng)求參數(shù) PAGEREF _Toc320538051 h 35 HYPERLINK l _Toc320538052 應(yīng)答結(jié)果 PAGEREF _Toc320538052 h 35 HYPERLINK l _Toc320538053 3.5.2新聞?dòng)嗛?PAGEREF _Toc320538053 h 36 HYPERLINK l _Toc320538054 請(qǐng)求參數(shù) PAGEREF _Toc320538054 h 36 HYPERLINK l _Toc3205

17、38055 應(yīng)答結(jié)果 PAGEREF _Toc320538055 h 37 HYPERLINK l _Toc320538056 3.5.3新聞取消訂閱 PAGEREF _Toc320538056 h 37 HYPERLINK l _Toc320538057 請(qǐng)求參數(shù) PAGEREF _Toc320538057 h 37 HYPERLINK l _Toc320538058 應(yīng)答結(jié)果 PAGEREF _Toc320538058 h 38 HYPERLINK l _Toc320538059 3.5.4新聞獵取 PAGEREF _Toc320538059 h 38 HYPERLINK l _Toc32

18、0538060 請(qǐng)求參數(shù) PAGEREF _Toc320538060 h 39 HYPERLINK l _Toc320538061 應(yīng)答結(jié)果 PAGEREF _Toc320538061 h 39 HYPERLINK l _Toc320538062 3.6天氣預(yù)報(bào) PAGEREF _Toc320538062 h 41 HYPERLINK l _Toc320538063 3.6.1行政區(qū)劃元數(shù)據(jù)檢索 PAGEREF _Toc320538063 h 41 HYPERLINK l _Toc320538064 請(qǐng)求參數(shù) PAGEREF _Toc320538064 h 41 HYPERLINK l _To

19、c320538065 應(yīng)答結(jié)果 PAGEREF _Toc320538065 h 41 HYPERLINK l _Toc320538066 3.6.2天氣查詢(xún) PAGEREF _Toc320538066 h 42 HYPERLINK l _Toc320538067 請(qǐng)求參數(shù) PAGEREF _Toc320538067 h 42 HYPERLINK l _Toc320538068 應(yīng)答結(jié)果 PAGEREF _Toc320538068 h 43 HYPERLINK l _Toc320538069 3.7車(chē)隊(duì)組隊(duì) PAGEREF _Toc320538069 h 45 HYPERLINK l _Toc3

20、20538070 3.7.1車(chē)隊(duì)列表查詢(xún) PAGEREF _Toc320538070 h 45 HYPERLINK l _Toc320538071 請(qǐng)求參數(shù) PAGEREF _Toc320538071 h 45 HYPERLINK l _Toc320538072 應(yīng)答結(jié)果 PAGEREF _Toc320538072 h 46 HYPERLINK l _Toc320538073 數(shù)據(jù)結(jié)構(gòu) PAGEREF _Toc320538073 h 46 HYPERLINK l _Toc320538074 應(yīng)答示例 PAGEREF _Toc320538074 h 47 HYPERLINK l _Toc3205

21、38075 3.7.2車(chē)隊(duì)隊(duì)員檢索 PAGEREF _Toc320538075 h 48 HYPERLINK l _Toc320538076 請(qǐng)求參數(shù) PAGEREF _Toc320538076 h 48 HYPERLINK l _Toc320538077 應(yīng)答結(jié)果 PAGEREF _Toc320538077 h 49 HYPERLINK l _Toc320538078 數(shù)據(jù)結(jié)構(gòu) PAGEREF _Toc320538078 h 49 HYPERLINK l _Toc320538079 應(yīng)答示例 PAGEREF _Toc320538079 h 49 HYPERLINK l _Toc3205380

22、80 3.7.3位置上報(bào) PAGEREF _Toc320538080 h 51 HYPERLINK l _Toc320538081 請(qǐng)求參數(shù) PAGEREF _Toc320538081 h 51 HYPERLINK l _Toc320538082 應(yīng)答結(jié)果 PAGEREF _Toc320538082 h 51 HYPERLINK l _Toc320538083 數(shù)據(jù)結(jié)構(gòu) PAGEREF _Toc320538083 h 51 HYPERLINK l _Toc320538084 應(yīng)答示例 PAGEREF _Toc320538084 h 52 HYPERLINK l _Toc320538085 3.

23、7.4加入/退出車(chē)隊(duì)申請(qǐng) PAGEREF _Toc320538085 h 53 HYPERLINK l _Toc320538086 請(qǐng)求參數(shù) PAGEREF _Toc320538086 h 53 HYPERLINK l _Toc320538087 應(yīng)答結(jié)果 PAGEREF _Toc320538087 h 54 HYPERLINK l _Toc320538088 3.8消息檢測(cè) PAGEREF _Toc320538088 h 54 HYPERLINK l _Toc320538089 3.8.1消息檢測(cè)請(qǐng)求 PAGEREF _Toc320538089 h 54 HYPERLINK l _Toc32

24、0538090 3.8.2消息應(yīng)答結(jié)果 PAGEREF _Toc320538090 h 55 HYPERLINK l _Toc320538091 4附錄 PAGEREF _Toc320538091 h 56 HYPERLINK l _Toc320538092 4.1服務(wù)類(lèi)型講明 PAGEREF _Toc320538092 h 56 HYPERLINK l _Toc320538093 4.2返回碼 PAGEREF _Toc320538093 h 56 HYPERLINK l _Toc320538094 4.3消息分類(lèi) PAGEREF _Toc320538094 h 57前 言本規(guī)范由北京汽車(chē)股份

25、有限公司提出并歸口。本規(guī)范起草單位:北京汽車(chē)股份有限公司本規(guī)范解釋單位:北京汽車(chē)股份有限公司文檔簡(jiǎn)介協(xié)議講明本文中內(nèi)容對(duì)北京汽車(chē)信息娛樂(lè)系統(tǒng)平臺(tái)(TSP平臺(tái))與DVD之間的HTTP通訊協(xié)議進(jìn)行定義和講明。數(shù)據(jù)類(lèi)型本文中標(biāo)記 C顯示Character型。C 后面連接的數(shù)字顯示Character數(shù)。如:C4 表示 Character型,4 Character。編碼講明DVD與TSP平臺(tái)間請(qǐng)求、應(yīng)答協(xié)議編碼方式默認(rèn)采納GBK。注釋講明本文采納如下注釋關(guān)鍵詞:注意提醒讀者關(guān)注此處。符號(hào)講明 必填項(xiàng)。(空)非必填項(xiàng)。加密本協(xié)議中涉及到的DID需要進(jìn)行加密,加密算法由DVD供應(yīng)商和TSP平臺(tái)進(jìn)行共同商定。

26、度量單位本協(xié)議中涉及到的度量單位信息,如無(wú)專(zhuān)門(mén)講明,均按照下列處理:編號(hào)名稱(chēng)長(zhǎng)度單位講明1經(jīng)度C101/1000秒10進(jìn)制2緯度C101/1000秒10進(jìn)制3方向C3度10進(jìn)制, 與正北方向夾角:0 3604速度C50.1公里每小時(shí)10進(jìn)制協(xié)議框架協(xié)議概述本通訊協(xié)議的承載協(xié)議為HTTP/1.1(參見(jiàn)RFC2626)。服務(wù)采納HTTP網(wǎng)絡(luò)傳輸協(xié)議,客戶(hù)端以GET的形式發(fā)送請(qǐng)求數(shù)據(jù)到服務(wù)器端。本公開(kāi)協(xié)議由一個(gè)安全協(xié)議規(guī)范和業(yè)務(wù)協(xié)議規(guī)范構(gòu)成,安全對(duì)協(xié)議的結(jié)構(gòu)和操縱標(biāo)識(shí)進(jìn)行約定,業(yè)務(wù)協(xié)議對(duì)具體的業(yè)務(wù)功能進(jìn)行規(guī)范。安全和業(yè)務(wù)協(xié)議有各自的版本號(hào)。協(xié)議講明協(xié)議請(qǐng)求頭序號(hào)參數(shù)講明長(zhǎng)度示例必填1Device-i

27、d終端設(shè)備DVD的信息C16Device-id= SD2010072600001 2Device-vin用于標(biāo)識(shí)車(chē)輛的唯一碼C17Protocol-version協(xié)議的版本號(hào)。發(fā)起方請(qǐng)求時(shí),必須標(biāo)明使用的版本號(hào),要緊用于版本升級(jí)。版本號(hào)的組成:xxxx 版本號(hào)(主版本號(hào).次版本號(hào))C40100Encoding用于標(biāo)識(shí)請(qǐng)求編碼方式,支持UTF-8或者GBK,默認(rèn)是GBK。C5Test-flag該字段用于終端是否為測(cè)試請(qǐng)求TSP處理業(yè)務(wù),0為非測(cè)試,1為測(cè)試,默認(rèn)為0C16BID廠商業(yè)務(wù)標(biāo)識(shí)類(lèi)型, 標(biāo)識(shí)接入的廠商業(yè)務(wù)C3參見(jiàn)“廠商業(yè)務(wù)標(biāo)識(shí)類(lèi)型表”7SID終端請(qǐng)求服務(wù)的請(qǐng)求碼。請(qǐng)求碼系統(tǒng)統(tǒng)一定義。C

28、4詳細(xì)參見(jiàn)附錄4.1廠商業(yè)務(wù)標(biāo)識(shí)類(lèi)型(BID)如下:標(biāo)識(shí)含義100C60F101C70G DVD 102C70G CD103C80K104C50E應(yīng)答請(qǐng)求頭序號(hào)參數(shù)講明長(zhǎng)度示例必填1Result_code應(yīng)答狀態(tài)C4Result_code: 02002SID終端請(qǐng)求服務(wù)的請(qǐng)求碼C4參見(jiàn)附錄4.1應(yīng)答狀態(tài)參見(jiàn)附錄4.2中定義DVD接口協(xié)議講明DVD和TSP平臺(tái)之間的,請(qǐng)求的URL統(tǒng)一為:/baicTSP/SafeDVDServlet。請(qǐng)求方式為/baicTSP/SafeDVDServlet?param.消息服務(wù)消息分類(lèi)獵取車(chē)載終端使用該接口獵取消息分類(lèi)信息。示例:GET /baicTSP/Saf

29、eDVDServlet HTTP/1.1Host: ip:portDevice-vin:20110705-BJ10234Device-id: SD2010072600001Protocol-version: 1.0Encoding: gbkTest-flag: 0BID: 100SID: 2002應(yīng)答結(jié)果數(shù)據(jù)結(jié)構(gòu)序號(hào)元素名稱(chēng)英文名稱(chēng)相關(guān)解釋長(zhǎng)度示例必填1符合條件總記錄數(shù)sumnumber所有的記錄C32消息mesgtypes消息分類(lèi)體3分類(lèi)IDmesgtype_id消息ID最長(zhǎng)C114分類(lèi)標(biāo)題mesgtype_title消息標(biāo)題最長(zhǎng)C645分類(lèi)類(lèi)型mesgtype_type大分類(lèi):0小分類(lèi):為

30、該小分類(lèi)的父類(lèi)型ID最長(zhǎng)C4應(yīng)答示例HTTP/1.1 200 OKContent-Length: 72Date: Mon, 14 Mar 2011 07:50:37 GMTResult_code: 0200SID: 2002sumnumber: 2,mesgtypes:mesgtype_id: 10,mesgtype_title: 終端,mesgtype_type: 0,/表示大分類(lèi),mesgtype_id: 1001,mesgtype _title: 廣告,mesgtype_type: 10/非“0”即為小分類(lèi),值為父類(lèi)型的“mesgtype_id”消息列表獵取車(chē)載終端使用該接口獵取消息列表

31、信息。序號(hào)元素名稱(chēng)英文名稱(chēng)相關(guān)解釋長(zhǎng)度示例必填1消息大類(lèi)不mesgType參見(jiàn)附錄4.3C22消息詳細(xì)類(lèi)不typeDetail參見(jiàn)附錄4.3C43結(jié)果開(kāi)始位置pos取得檢索結(jié)果集的開(kāi)始位置最長(zhǎng)C44結(jié)果集的件數(shù)cnt取得檢索結(jié)果集的件數(shù)最長(zhǎng)C4示例:GET /baicTSP/SafeDVDServlet?mesgType=10&typeDetail=1001&pos=0&cnt=10 HTTP/1.1Host: ip:portDevice-vin:20110705-BJ10234Device-id: SD2010072600001Protocol-version: 1.0Encoding: g

32、bkTest-flag: 0BID: 100SID: 2003應(yīng)答結(jié)果數(shù)據(jù)結(jié)構(gòu)序號(hào)元素名稱(chēng)英文名稱(chēng)相關(guān)解釋長(zhǎng)度示例必填1符合條件總記錄數(shù)sumnumber所有的記錄C32消息messages消息體3消息IDmessage_id消息ID最長(zhǎng)C114消息標(biāo)題message_title消息標(biāo)題最長(zhǎng)C645消息大類(lèi)型message_type消息大類(lèi)型C46消息詳細(xì)類(lèi)型message_type_detail消息詳細(xì)類(lèi)型C47消息來(lái)源message_from消息來(lái)源最長(zhǎng)C328消息公布時(shí)刻publish_time格式:yyyy-mm-dd hh:mm:ssC19應(yīng)答示例HTTP/1.1 200 OKCon

33、tent-Length: 72Date: Mon, 14 Mar 2011 07:50:37 GMTResult_code: 0200SID: 2003sumnumber: 2,messages:message_id:message_title: 終端版本需要升級(jí),message_type: 11,message_type_detial:1101message_from: 系統(tǒng),publish_time:2010-03-25 14:39:01,message_id:message_title: 送您洗車(chē)大禮包,message_type: 14

34、,message_type_detial:1402message_from: 系統(tǒng),publish_time:2010-03-25 14:39:01消息詳情獵取終端使用該接口獵取消息詳情,支持同時(shí)獵取多條消息詳情。消息詳情獵取獵取請(qǐng)求參數(shù)序號(hào)元素名稱(chēng)英文名稱(chēng)相關(guān)解釋長(zhǎng)度示例必填1消息的IDmsgId假如想要獵取即時(shí)消息的ID,同時(shí)想要同時(shí)獵取多條消息的ID,則使用”,”分割最長(zhǎng)C11msgId=1001, 10022獵取方式obtainType1:BASE64方式,一次性獵取全部消息。2:URL方式,先獵取文字部分,在逐個(gè)獵取附件。C1obtainType=1obtainType=2示例:GE

35、T /baicTSP/SafeDVDServlet?msgId=1001,1002&obtainType=1 HTTP/1.1Host: ip:portDevice-vin:20110705-BJ10234Device-id: SD2010072600001 Protocol-version: 1.0Encoding: gbkTest-flag: 0BID: 100SID: 2004應(yīng)答結(jié)果數(shù)據(jù)結(jié)構(gòu)序號(hào)元素名稱(chēng)英文名稱(chēng)相關(guān)解釋長(zhǎng)度示例必填1符合條件總記錄數(shù)sumnumber符合條件總記錄數(shù)最長(zhǎng)C32消息messages消息體3消息IDmessage_id消息ID最長(zhǎng)C114消息標(biāo)題messag

36、e_title消息標(biāo)題最長(zhǎng)C1005消息來(lái)源message_from消息來(lái)源最長(zhǎng)C206消息公布時(shí)刻publish_time格式:yyyy-mm-dd hh:mm:ssC197消息大類(lèi)型message_type消息大類(lèi)型C48消息詳細(xì)類(lèi)型message_type_detial消息詳細(xì)類(lèi)型C49消息體message_body消息體最長(zhǎng)C20010獵取方式obtainType1:BASE64方式,一次性獵取全部消息。2:URL方式,先獵取文字部分,在逐個(gè)獵取附件。11附件體message_ multimedia _body附件體12附件編號(hào)message_ multimedia_id附件編號(hào)C11

37、3附件類(lèi)型message_ multimedia_type1:圖片;2:聲音C114附件大小message_ multimedia_length附件大小C815附件message_ multimedia附件應(yīng)答示例講明1:用BASE64方式獵取全部消息HTTP/1.1 200 OKContent-Length: 72Date: Mon, 14 Mar 2011 07:50:37 GMTResult_code: 0200SID: 2004sumnumber: 2,messages:message_id: 1001,message_title: 送您洗車(chē)大禮包,message_from: 系統(tǒng),p

38、ublish_time:”2010-03-25 14:39:01”message_type: 14,message_type_detial:”1402,message_body:從即日起至10月1日,到中街4S店洗車(chē)享受半價(jià)優(yōu)惠,快快行動(dòng)吧,obtainType:1,message_ multimedia _body: message_ multimedia_id:1,message_ multimedia_type:1, message_ multimedia_length:120, message_ multimedia:asdfadfasdfasdfasdf” ,message_ mul

39、timedia_id:2,message_ multimedia_type:2, message_ multimedia_length:150, message_ multimedia:asdfadfasdfasdfasdf” ,message_id: 1002,message_title: 分享信息,message_from: 好友,publish_time:”2010-03-25 14:39:01”message_type: 13,message_type_detial:”1303”message_body:東大門(mén)口有活動(dòng),obtainType:1,message

40、_ multimedia _body: message_ multimedia_id:2,message_ multimedia_type:2, message_ multimedia_length:180, message_ multimedia:asdfadfasdfasdfasdf” 講明2:以URL方式獵取文字信息,再用BASE64方式逐個(gè)獵取附件。HTTP/1.1 200 OKContent-Length: 72Date: Mon, 14 Mar 2011 07:50:37 GMTResult_code: 0200SID: 2004sumnumber: 2,getnumber: 2,

41、messages:message_id: 1001,message_title: 送您洗車(chē)大禮包,message_from: 系統(tǒng),publish_time:”2010-03-25 14:39:01”message_type: 14,message_type_detial:”1402,message_body:從即日起至10月1日,到中街4S店洗車(chē)享受半價(jià)優(yōu)惠,快快行動(dòng)吧,obtainType:2,message_ multimedia _body: message_ multimedia_id:1,message_ multimedia_type:, message_ multimedia_

42、length:, message_ multimedia: message_ multimedia _body: message_ multimedia_id:2,message_ multimedia_type:, message_ multimedia_length:, message_ multimedia: ,message_id: 1002,message_title: 分享信息,message_from: 好友,publish_time:”2010-03-25 14:39:01”message_type: 13,message_type_detial:”1

43、303message_body:東大門(mén)口有活動(dòng),obtainType:1,message_ multimedia _body: message_ multimedia_id:2,message_ multimedia_type:, message_ multimedia_length:, message_ multimedia: 講明3 :無(wú)附件信息的消息。HTTP/1.1 200 OKContent-Length: 72Date: Mon, 14 Mar 2011 07:50:37 GMTResult_code: 0200SID: 2004sumnumber: 1,getnumber: 1,

44、messages:message_id: 1001,message_title: 送您洗車(chē)大禮包,message_from: 系統(tǒng),publish_time:2010-03-25 14:39:01,message_type: 14,message_type_detial:”1402,message_body:從即日起至10月1日,到中街4S店洗車(chē)享受半價(jià)優(yōu)惠,快快行動(dòng)吧,obtainType:2,message_ multimedia _body: 下載附件請(qǐng)求參數(shù)序號(hào)元素名稱(chēng)英文名稱(chēng)相關(guān)解釋長(zhǎng)度示例必填1消息IDmessageId消息ID最長(zhǎng)C112附件編號(hào)message_ multimed

45、ia_id附件編號(hào)C11示例:GET /baicTSP/SafeDVDServlet?messageId=1001&message_ multimedia_id=1 HTTP/1.1Host: ip:portDevice-vin:20110705-BJ10234Device-id: SD2010072600001 Protocol-version: 1.0Encoding: gbkTest-flag: 0BID: 100SID: 2005應(yīng)答結(jié)果數(shù)據(jù)結(jié)構(gòu)序號(hào)元素名稱(chēng)英文名稱(chēng)相關(guān)解釋長(zhǎng)度示例必填1消息IDmessage_id消息ID最長(zhǎng)C112附件體message_ multimedia _bo

46、dy附件體3附件編號(hào)message_ multimedia_id附件編號(hào)C114附件類(lèi)型message_ multimedia_type1:圖片;2:聲音C15附件大小message_ multimedia_length附件大小C86附件message_ multimedia附件應(yīng)答示例HTTP/1.1 200 OKContent-Length: 72Date: Mon, 14 Mar 2011 07:50:37 GMTResult_code: 0200SID: 2005message_id:message_ multimedia _body: message_ mu

47、ltimedia_id:1,message_ multimedia_type:1, message_ multimedia_length:120, message_ multimedia:asdfadfasdfasdfasdf” 保養(yǎng)服務(wù)保養(yǎng)記錄查詢(xún)請(qǐng)求參數(shù)序號(hào)元素名稱(chēng)英文名稱(chēng)相關(guān)解釋長(zhǎng)度示例必填1結(jié)果開(kāi)始位置pos取得檢索結(jié)果集的開(kāi)始位置最長(zhǎng)C42結(jié)果集的件數(shù)cnt取得檢索結(jié)果集的件數(shù)最長(zhǎng)C4示例:GET /baicTSP/SafeDVDServlet?pos=0&cnt=10 HTTP/1.1Host: ip:portDevice-vin:20110705-BJ10234Device-id

48、: SD2010072600001Protocol-version: 1.0Encoding: gbkTest-flag: 0BID: 100SID: 7001應(yīng)答結(jié)果序號(hào)元素名稱(chēng)英文名稱(chēng)相關(guān)解釋長(zhǎng)度示例必填1符合條件總記錄數(shù)sumnumber總記錄數(shù)最長(zhǎng)C42記錄體maintainRecords3主鍵標(biāo)識(shí)id主鍵標(biāo)識(shí)最長(zhǎng)C114保養(yǎng)日期maintain_date保養(yǎng)日期C205保養(yǎng)公里數(shù)maintain_km保養(yǎng)公里數(shù)最長(zhǎng)C57保養(yǎng)4s店dealer_name保養(yǎng)4s店最長(zhǎng)C648保養(yǎng)費(fèi)用check_cost保養(yǎng)費(fèi)用最長(zhǎng)C89保養(yǎng)狀態(tài)check_status保養(yǎng)狀態(tài)最長(zhǎng)C810保養(yǎng)內(nèi)容che

49、ck_content11保養(yǎng)項(xiàng)content_key保養(yǎng)項(xiàng)最長(zhǎng)C2012保養(yǎng)操作content_value保養(yǎng)操作最長(zhǎng)C2013保養(yǎng)費(fèi)用content_cost保養(yǎng)費(fèi)用最長(zhǎng)C8示例:HTTP/1.1 200 OKContent-Length: 72Date: Mon, 14 Mar 2011 07:50:37 GMTResult_code: 0200SID: 7001sumnumber:2,maintainRecords: id:1001,maintain_date:20110505, maintain_km:120, dealer_name:北京4s店” check_cost:4000”ch

50、eck_status:已完成”,check_content:content_key:發(fā)動(dòng)機(jī),content_value:換機(jī)油content_cost:230.99,content_key:輪胎,content _value:補(bǔ)齊content_cost:0查詢(xún)當(dāng)次保養(yǎng)狀態(tài)請(qǐng)求參數(shù)示例:GET /baicTSP/SafeDVDServlet?type=1 HTTP/1.1Host: ip:portContent-Length: 91Device-vin:20110705-BJ10234Device-id: SD2010072600001Protocol-version: 1.0Encoding

51、: gbkTest-flag: 0BID: 100SID: 7002注意:請(qǐng)求URL中type是查詢(xún)的類(lèi)型,包含保養(yǎng)提醒、車(chē)輛信息、4S店服務(wù)、廣告等,暫定只有查詢(xún)當(dāng)次保養(yǎng)狀態(tài),即type=1。應(yīng)答結(jié)果序號(hào)元素名稱(chēng)英文名稱(chēng)相關(guān)解釋長(zhǎng)度示例必填1保養(yǎng)狀態(tài)結(jié)果result保養(yǎng)狀態(tài)結(jié)果0:保養(yǎng)狀態(tài)已取消1:保養(yǎng)狀態(tài)未取消最長(zhǎng)C1HTTP/1.1 200 OKContent-Length: 72Date: Mon, 14 Mar 2011 07:50:37 GMTResult_code: 0200SID: 7002result:1 /0:保養(yǎng)狀態(tài)已取消 1:保養(yǎng)狀態(tài)未取消取消當(dāng)次保養(yǎng)提醒請(qǐng)求參數(shù)示例:

52、GET /baicTSP/SafeDVDServlet?type=1 HTTP/1.1Host: ip:portDevice-vin:20110705-BJ10234Device-id: SD2010072600001Protocol-version: 1.0Encoding: gbkTest-flag: 0BID: 100SID: 7003注意:請(qǐng)求URL中type是取消的類(lèi)型,包含保養(yǎng)提醒、車(chē)輛信息、4S店服務(wù)、廣告等,暫定只有取消當(dāng)次保養(yǎng)提醒,即type=1。應(yīng)答結(jié)果示例(取消成功):HTTP/1.1 200 OKContent-Length: 72Date: Mon, 14 Mar 2

53、011 07:50:37 GMTResult_code: 0200SID: 7003示例(取消逝敗):HTTP/1.1 200 OKContent-Length: 72Date: Mon, 14 Mar 2011 07:50:37 GMTResult_code:0401SID: 7003一鍵導(dǎo)航獵取設(shè)定位置一鍵導(dǎo)航是把用戶(hù)要求的位置,發(fā)送給TSP平臺(tái),DVD從TSP平臺(tái)下載位置信息。請(qǐng)求參數(shù)序號(hào)元素名稱(chēng)英文名稱(chēng)相關(guān)解釋長(zhǎng)度示例必填1包含歷史記錄has_history是否包含歷史記錄,默認(rèn)為0最長(zhǎng)C1has_history=0,has_history=1注:has_history為0 確實(shí)是不包

54、含歷史記錄,假如沒(méi)有最新的導(dǎo)航記錄,返回?zé)o導(dǎo)航記錄;has_history為1確實(shí)是包含歷史記錄,假如沒(méi)有最新的導(dǎo)航記錄,返回最后一次的導(dǎo)航記錄。示例:GET /baicTSP/SafeDVDServlet?has_history=0 HTTP/1.1Host: ip:portDevice-vin:20110705-BJ10234Device-id: SD2010072600001 Protocol-version: 1.0Encoding: gbkTest-flag: 0BID: 100SID: 3001應(yīng)答結(jié)果序號(hào)元素名稱(chēng)英文名稱(chēng)相關(guān)解釋長(zhǎng)度示例必填1結(jié)果Result2導(dǎo)航條件navico

55、ndition0: 推舉優(yōu)先;1:高速優(yōu)先;2:距離優(yōu)先;3:時(shí)刻優(yōu)先;4:采納導(dǎo)航本地的設(shè)置。默認(rèn)值為4C13目的地destination目的地4位置名pname位置名最長(zhǎng)C505經(jīng)度lon經(jīng)度C106緯度lat 緯度C107電話tel電話C158地址address地址最長(zhǎng)C1289途經(jīng)地vias最多3個(gè)途徑地10途經(jīng)地序號(hào)viaid途徑地的順序號(hào)C111途經(jīng)地信息poiinfo途徑地信息12位置名pname位置名最長(zhǎng)C6413經(jīng)度lon經(jīng)度C1014緯度lat 緯度C1015電話tel電話最長(zhǎng)C1516地址address地址最長(zhǎng)C100示例(單一目的地成功):HTTP/1.1 200 OK

56、Content-Length: 72Date: Mon, 14 Mar 2011 07:50:37 GMTResult_code: 0200SID: 3001Result:navicondition:1, destination : pname:萬(wàn)豪酒店,lon:222222222,lat:1111111111,tel:65478915,address:北京市朝陽(yáng)區(qū)勁松南路145號(hào),vias: viaid:1,poiinfo:pname:萬(wàn)豪酒店,“l(fā)on”: 222222222,“l(fā)at:1111111111,“tel:65478915,address:北京市朝陽(yáng)區(qū)勁松南路145號(hào),viai

57、d:2,poiinfo:lon :222222222,lat :1111111111,tel:65478915,address:北京市朝陽(yáng)區(qū)勁松南路145號(hào)示例(多目的地成功):HTTP/1.1 200 OKContent-Length: 72Date: Mon, 14 Mar 2011 07:50:37 GMTResult_code: 0200SID: 3001Result: “destination : pname:萬(wàn)豪酒店,lon:222222222,lat:1111111111,tel:65478915,address:北京市朝陽(yáng)區(qū)勁松南路145號(hào),pname:大廈1,lon:2222

58、22222,lat:1111111111,tel:65478915,address:北京市朝陽(yáng)區(qū)勁松南路145號(hào)示例(失敗):HTTP/1.1 200 OKContent-Length: 72Date: Mon, 14 Mar 2011 07:50:37 GMTResult_code: 0403SID: 3001網(wǎng)絡(luò)檢索關(guān)鍵字檢索請(qǐng)求參數(shù)序號(hào)元素名稱(chēng)英文名稱(chēng)相關(guān)解釋長(zhǎng)度示例必填1省名稱(chēng)prov_name省級(jí)行政區(qū)域的中文名稱(chēng)最長(zhǎng)C40prov_name=遼寧省2市名稱(chēng)city_name市級(jí)行政區(qū)域的中文名稱(chēng)最長(zhǎng)C40city_name=沈陽(yáng)市高德GIS必須且只要都市代碼高德GIS必須且只要都市

59、代碼3縣名稱(chēng)county_name縣、區(qū)級(jí)行政區(qū)域的中文名稱(chēng)最長(zhǎng)C40county_name =沈河區(qū)4關(guān)鍵字keyword檢索關(guān)鍵字最長(zhǎng)C100keyword=萬(wàn)豪酒店關(guān)鍵字與首字母二選一關(guān)鍵字與首字母二選一5首字母first_letters關(guān)鍵字拼音首字母最長(zhǎng)C50first_letters=whjd6排序字段sort_cri排序字段:設(shè)定是否使用分類(lèi)排序字段。最長(zhǎng)C20sort_cri=keyowrd7結(jié)果集的開(kāi)始位置pos取得結(jié)果集的開(kāi)始位置最長(zhǎng)C4pos=208結(jié)果集件數(shù)cnt取得結(jié)果集的件數(shù)最長(zhǎng)C4cnt=30 【注】pos 值為正整數(shù),cnt值為正整數(shù)。請(qǐng)求參數(shù)中的省市信息都為國(guó)

60、標(biāo)碼。關(guān)鍵字和首字母字段,不能同時(shí)為空排序字段,默認(rèn)值為 keyword ,示例:GET /baicTSP/SafeDVDServlet?prov_name=遼寧省&city_name=沈陽(yáng)市& county_name=沈河區(qū)&keyword=萬(wàn)豪酒店&sort_cri=keyword&pos=20&cnt=30 HTTP/1.1或GET /baicTSP/SafeDVDServlet? prov_name=遼寧省&city_name=沈陽(yáng)市& county_name=沈河區(qū)& first_letters=whjd&sort_cri=keyword&pos=20&cnt=30 HTTP/1.1

溫馨提示

  • 1. 本站所有資源如無(wú)特殊說(shuō)明,都需要本地電腦安裝OFFICE2007和PDF閱讀器。圖紙軟件為CAD,CAXA,PROE,UG,SolidWorks等.壓縮文件請(qǐng)下載最新的WinRAR軟件解壓。
  • 2. 本站的文檔不包含任何第三方提供的附件圖紙等,如果需要附件,請(qǐng)聯(lián)系上傳者。文件的所有權(quán)益歸上傳用戶(hù)所有。
  • 3. 本站RAR壓縮包中若帶圖紙,網(wǎng)頁(yè)內(nèi)容里面會(huì)有圖紙預(yù)覽,若沒(méi)有圖紙預(yù)覽就沒(méi)有圖紙。
  • 4. 未經(jīng)權(quán)益所有人同意不得將文件中的內(nèi)容挪作商業(yè)或盈利用途。
  • 5. 人人文庫(kù)網(wǎng)僅提供信息存儲(chǔ)空間,僅對(duì)用戶(hù)上傳內(nèi)容的表現(xiàn)方式做保護(hù)處理,對(duì)用戶(hù)上傳分享的文檔內(nèi)容本身不做任何修改或編輯,并不能對(duì)任何下載內(nèi)容負(fù)責(zé)。
  • 6. 下載文件中如有侵權(quán)或不適當(dāng)內(nèi)容,請(qǐng)與我們聯(lián)系,我們立即糾正。
  • 7. 本站不保證下載資源的準(zhǔn)確性、安全性和完整性, 同時(shí)也不承擔(dān)用戶(hù)因使用這些下載資源對(duì)自己和他人造成任何形式的傷害或損失。

最新文檔

評(píng)論

0/150

提交評(píng)論