廣州市機(jī)動(dòng)車(chē)駕駛員計(jì)時(shí)培訓(xùn)系統(tǒng)技術(shù)規(guī)范和廣州市學(xué)駕平臺(tái)

1、PAGE 廣州市機(jī)動(dòng)車(chē)駕駛員計(jì)時(shí)培訓(xùn)系統(tǒng)技術(shù)規(guī)范和廣州市學(xué)駕平臺(tái)監(jiān)管要求 PAGE I目錄 TOC t 前言、引言標(biāo)題,1,參考文獻(xiàn)、索引標(biāo)題,1,章標(biāo)題,1,參考文獻(xiàn),1,附錄標(biāo)識(shí),1 前言 PAGEREF _Toc500754856 h I1 范圍 PAGEREF _Toc500754857 h 12 規(guī)范性引用文件 PAGEREF _Toc500754858 h 13 術(shù)語(yǔ)、定義和縮略語(yǔ) PAGEREF _Toc500754859 h 14 平臺(tái)接口技術(shù)要求 PAGEREF _Toc500754860 h 25 平臺(tái)性能要求 PAGEREF _Toc500754861 h 3附錄A （規(guī)

2、范性附錄） 數(shù)據(jù)交換HTTP接口協(xié)議 PAGEREF _Toc500754862 h 5前言本規(guī)范是根據(jù)交通運(yùn)輸部2013年第49號(hào)公告機(jī)動(dòng)車(chē)駕駛員計(jì)時(shí)培訓(xùn)系統(tǒng)平臺(tái)技術(shù)規(guī)范、機(jī)動(dòng)車(chē)駕駛員計(jì)時(shí)培訓(xùn)系統(tǒng)計(jì)時(shí)終端技術(shù)規(guī)范以及廣州市駕培行業(yè)的實(shí)際監(jiān)管要求進(jìn)行制定。注：本規(guī)范會(huì)根據(jù)管理部門(mén)要求不定時(shí)更新，請(qǐng)及時(shí)查看。本規(guī)范起草單位：廣州軍軟科技有限公司 PAGE 50機(jī)動(dòng)車(chē)駕駛員計(jì)時(shí)培訓(xùn)系統(tǒng)和廣州市學(xué)駕服務(wù)平臺(tái)監(jiān)管系統(tǒng)技術(shù)規(guī)范范圍本規(guī)范規(guī)定了廣州市駕駛員培訓(xùn)機(jī)構(gòu)自主建設(shè)的機(jī)動(dòng)車(chē)駕駛員培訓(xùn)計(jì)時(shí)平臺(tái)與管理部門(mén)建設(shè)的廣州市學(xué)駕平臺(tái)監(jiān)管服務(wù)系統(tǒng)的功能要求、平臺(tái)接口技術(shù)要求、平臺(tái)安全與運(yùn)行環(huán)境要求、數(shù)據(jù)交換HTT

3、P接口協(xié)議和實(shí)時(shí)傳輸TCP接口協(xié)議要求。本規(guī)范適用于駕駛員培訓(xùn)機(jī)構(gòu)建設(shè)、管理和運(yùn)維計(jì)時(shí)培訓(xùn)管理系統(tǒng)以及管理部門(mén)建設(shè)、管理和運(yùn)維駕駛培訓(xùn)監(jiān)管服務(wù)平臺(tái)，是機(jī)動(dòng)車(chē)駕駛員培訓(xùn)機(jī)構(gòu)開(kāi)展計(jì)時(shí)培訓(xùn)及道路運(yùn)輸管理機(jī)構(gòu)實(shí)施計(jì)時(shí)培訓(xùn)管理和服務(wù)的基礎(chǔ)。規(guī)范性引用文件下列文件對(duì)于本文件的應(yīng)用是必不可少的。凡是注日期的引用文件，僅所注日期的版本適用于本文件。凡是不注日期的引用文件，其最新版本（包括所有的修改單）適用于本文件。GB/T2260 中華人民共和國(guó)行政區(qū)劃代碼GB/T30340 機(jī)動(dòng)車(chē)駕駛員培訓(xùn)機(jī)構(gòu)資格條件JT/T 415-2006 道路運(yùn)輸電子政務(wù)平臺(tái)編目編碼規(guī)則JT/T 697.1-2013 交通信息基礎(chǔ)數(shù)

4、據(jù)元-第1部分:總則JT/T 808 道路運(yùn)輸車(chē)輛衛(wèi)星定位系統(tǒng)終端通訊協(xié)議及數(shù)據(jù)格式中華人民共和國(guó)道路運(yùn)輸條例GB/T 30340-2013中華人民共和國(guó)國(guó)家標(biāo)準(zhǔn)（機(jī)動(dòng)車(chē)駕駛培訓(xùn)機(jī)構(gòu)資格條件）GB/T 30340-2013中華人民共和國(guó)國(guó)家標(biāo)準(zhǔn)（機(jī)動(dòng)車(chē)駕駛培訓(xùn)教練場(chǎng)技術(shù)要求）JT/T325-2006中華人民共和國(guó)交通行業(yè)標(biāo)準(zhǔn) 機(jī)動(dòng)車(chē)駕駛員培訓(xùn)管理規(guī)定（交通部2016年第51號(hào)）關(guān)于印發(fā)機(jī)動(dòng)車(chē)駕駛培訓(xùn)教學(xué)與考試大綱的通知（交運(yùn)發(fā)2016年第128號(hào)）JT/T 414-2006 道路運(yùn)政管理信息系統(tǒng)-信息結(jié)構(gòu)體系JT/T 415-2006 道路運(yùn)政管理信息系統(tǒng)-編目編碼規(guī)則關(guān)于做好機(jī)動(dòng)車(chē)駕駛?cè)伺嘤?xùn)

5、考試制度改革工作的通知（公交管201650號(hào)）關(guān)于推進(jìn)機(jī)動(dòng)車(chē)駕駛?cè)伺嘤?xùn)考試制度改革意見(jiàn)的通知（國(guó)辦發(fā)201588號(hào)）關(guān)于強(qiáng)制推廣應(yīng)用帶有衛(wèi)星定位功能的汽車(chē)行駛記錄儀的通知（粵安監(jiān)200969號(hào)）廣東省地方標(biāo)準(zhǔn)DB44/T 5782009 衛(wèi)星定位汽車(chē)行駛記錄儀通用技術(shù)規(guī)范術(shù)語(yǔ)、定義和縮略語(yǔ)術(shù)語(yǔ)和定義廣州市學(xué)駕服務(wù)監(jiān)管平臺(tái) 部署在駕駛培訓(xùn)管理部門(mén)，對(duì)駕駛培訓(xùn)機(jī)構(gòu)計(jì)時(shí)培訓(xùn)全過(guò)程進(jìn)行監(jiān)督和管理，并提供相關(guān)信息服務(wù)，能夠?qū)崿F(xiàn)與其他信息系統(tǒng)數(shù)據(jù)共享與交換的平臺(tái)，簡(jiǎn)稱(chēng)監(jiān)管服務(wù)平臺(tái)。駕駛員培訓(xùn)機(jī)構(gòu)計(jì)時(shí)培訓(xùn)管理平臺(tái) 部署在機(jī)動(dòng)車(chē)駕駛員培訓(xùn)機(jī)構(gòu)或者相關(guān)服務(wù)企，對(duì)學(xué)員計(jì)時(shí)培訓(xùn)全過(guò)程進(jìn)行管理和服務(wù)，并為相關(guān)管理部門(mén)

6、提供信息的平臺(tái)，以下簡(jiǎn)稱(chēng)計(jì)時(shí)平臺(tái)。駕駛員培訓(xùn)計(jì)時(shí)終端 部署在機(jī)動(dòng)車(chē)駕駛員培訓(xùn)機(jī)構(gòu)，用于采集和記錄車(chē)輛的位置、速度和運(yùn)行狀態(tài)，學(xué)員的培訓(xùn)階段、培訓(xùn)起止時(shí)間、培訓(xùn)里程等信息，以及學(xué)員和教練員的多媒體信息，并能通過(guò)通信網(wǎng)絡(luò)與計(jì)時(shí)平臺(tái)進(jìn)行信息交互的設(shè)備，簡(jiǎn)稱(chēng)計(jì)時(shí)終端。按培訓(xùn)類(lèi)別不同，分為車(chē)載計(jì)時(shí)計(jì)程終端、理論計(jì)時(shí)終端和模擬計(jì)時(shí)終端。數(shù)據(jù)通信鏈路異常無(wú)線通信鏈路斷開(kāi)，或暫時(shí)掛起(如通話過(guò)程中)。未前置注冊(cè)學(xué)員未在學(xué)駕平臺(tái)前置注冊(cè)。資料不規(guī)范企業(yè)提交的資料不符合規(guī)范配額不足企業(yè)招生配額不足?？s略語(yǔ)下列縮略語(yǔ)適用于本文件。TCP傳輸控制協(xié)議(Transmission Control Protocol)UDP

7、用戶數(shù)據(jù)報(bào)協(xié)議(user datagrnm protocol)APN接入點(diǎn)名稱(chēng)(access point name)SMS短消息服務(wù) (short message protocol)平臺(tái)接口技術(shù)要求計(jì)時(shí)平臺(tái)接口技術(shù)要求計(jì)時(shí)平臺(tái)接口應(yīng)滿足以下技術(shù)要求：計(jì)時(shí)平臺(tái)非實(shí)時(shí)數(shù)據(jù)的交換應(yīng)采用數(shù)據(jù)接口或者文件傳輸?shù)确绞綄?shí)現(xiàn)數(shù)據(jù)交互，數(shù)據(jù)至少每天同步1次；數(shù)據(jù)通信格式應(yīng)采用XML格式傳輸，數(shù)據(jù)傳參以字符串方式傳遞，各數(shù)據(jù)項(xiàng)之間以“$”符號(hào)分隔；數(shù)據(jù)項(xiàng)中應(yīng)增加安全碼，數(shù)據(jù)接收后比對(duì)安全碼進(jìn)行回調(diào)驗(yàn)證。驗(yàn)證通過(guò)后保存數(shù)據(jù)，不能通過(guò)驗(yàn)證則給出失敗提示；數(shù)據(jù)格式應(yīng)為：數(shù)據(jù)項(xiàng)1$數(shù)據(jù)項(xiàng)2$數(shù)據(jù)項(xiàng)3$數(shù)據(jù)項(xiàng)N$安全碼；返

8、回信息格式應(yīng)為：接收結(jié)果$結(jié)果描述$安全碼。其中接收結(jié)果的值為：0-成功；1-失敗。監(jiān)管服務(wù)平臺(tái)接口要求接口方式基于HTTP協(xié)議的Restful Webservice通信全國(guó)駕培平臺(tái)、監(jiān)管服務(wù)平臺(tái)、計(jì)時(shí)平臺(tái)之間，以及與行業(yè)其它業(yè)務(wù)系統(tǒng)和公安交通管理業(yè)務(wù)系統(tǒng)之間的數(shù)據(jù)交換接口應(yīng)使用HTTP協(xié)議，服務(wù)端的接口方式應(yīng)以Restful WebService方式提供，具體要求見(jiàn)附錄A。通信雙方采用JSON 格式進(jìn)行數(shù)據(jù)傳輸。基于TCP協(xié)議的Socket通信監(jiān)管服務(wù)平臺(tái)與計(jì)時(shí)平臺(tái)的衛(wèi)星定位過(guò)程明細(xì)數(shù)據(jù)和學(xué)時(shí)過(guò)程明細(xì)數(shù)據(jù)接口應(yīng)使用基于JT/T808基礎(chǔ)擴(kuò)充的TCP協(xié)議，服務(wù)端的接口方式應(yīng)以Socket方式提

9、供，具體要求見(jiàn)附錄B。安全策略全國(guó)駕培平臺(tái)向符合接入條件的監(jiān)管服務(wù)平臺(tái)、計(jì)時(shí)平臺(tái)和計(jì)時(shí)終端分配唯一標(biāo)識(shí)和安全認(rèn)證密鑰，用于數(shù)據(jù)交換防篡改和安全認(rèn)證。計(jì)時(shí)終端應(yīng)能在進(jìn)入計(jì)時(shí)培訓(xùn)模式前，向全國(guó)駕培平臺(tái)連線進(jìn)行密鑰驗(yàn)證，通過(guò)驗(yàn)證后方可進(jìn)行培訓(xùn)。文件存儲(chǔ)監(jiān)管服務(wù)平臺(tái)不提供圖片和音視頻等文件自動(dòng)上傳存儲(chǔ)功能，計(jì)時(shí)平臺(tái)應(yīng)上傳圖片和音視頻文件URL及文件md5，并保證所提供URL的可訪問(wèn)性及安全性。平臺(tái)性能要求平臺(tái)總體性能平臺(tái)運(yùn)行應(yīng)滿足以下技術(shù)要求：a)支持724小時(shí)不間斷運(yùn)行；b)在沒(méi)有外部因素影響下，故障恢復(fù)時(shí)間不超過(guò)2小時(shí)；c)平均無(wú)故障時(shí)間不小于10,000小時(shí)。平臺(tái)響應(yīng)時(shí)間平臺(tái)響應(yīng)時(shí)間應(yīng)至少滿足以

10、下要求：a）用戶界面查詢操作響應(yīng)不超過(guò)8秒；b）用戶界面編輯操作相應(yīng)不超過(guò)5秒；c）最大并發(fā)用戶數(shù)達(dá)到其系統(tǒng)設(shè)計(jì)要求時(shí)，各事務(wù)平均響應(yīng)時(shí)間不應(yīng)超過(guò)單用戶平均響應(yīng)時(shí)間的五倍。網(wǎng)絡(luò)傳輸環(huán)境網(wǎng)絡(luò)傳輸環(huán)境應(yīng)滿足以下要求：計(jì)時(shí)平臺(tái)應(yīng)支持互聯(lián)網(wǎng)或互聯(lián)網(wǎng)VPN連接監(jiān)管服務(wù)平臺(tái)，監(jiān)管服務(wù)平臺(tái)應(yīng)支持專(zhuān)線網(wǎng)絡(luò)或互聯(lián)網(wǎng)VPN連接全國(guó)駕培平臺(tái)；計(jì)時(shí)平臺(tái)應(yīng)采用多層緩存機(jī)制，采用雙網(wǎng)雙線訪問(wèn)策略控制。數(shù)據(jù)要求數(shù)據(jù)采集和記錄應(yīng)滿足以下要求：計(jì)時(shí)平臺(tái)采樣衛(wèi)星定位數(shù)據(jù)時(shí)間間隔不得大于30秒；學(xué)時(shí)記錄以分鐘為單位，里程記錄以公里為單位；圖片尺寸應(yīng)不小于320240像素，格式為JPEG，圖片文件應(yīng)不小于10KB；視頻最小幀數(shù)為3幀

11、，分辨率最小為cif。數(shù)據(jù)存儲(chǔ)及備份數(shù)據(jù)存儲(chǔ)及備份應(yīng)滿足以下要求：計(jì)時(shí)平臺(tái)數(shù)據(jù)存儲(chǔ)（包括：學(xué)員基本信息、培訓(xùn)基本信息和培訓(xùn)過(guò)程信息等）時(shí)間應(yīng)不少于4年，且應(yīng)在學(xué)員獲得駕駛證后至少保存3年。監(jiān)管服務(wù)平臺(tái)的培訓(xùn)檔案數(shù)據(jù)存儲(chǔ)時(shí)間，不得少于3年；應(yīng)建立數(shù)據(jù)備份機(jī)制，每月對(duì)數(shù)據(jù)進(jìn)行全量備份，每周對(duì)數(shù)據(jù)進(jìn)行增量備份。數(shù)據(jù)恢復(fù)時(shí)間不超過(guò)5小時(shí)。平臺(tái)安全要求平臺(tái)應(yīng)滿足以下安全要求：數(shù)據(jù)庫(kù)中關(guān)鍵數(shù)據(jù)應(yīng)加密存儲(chǔ)，用戶密碼加密存儲(chǔ)；采用日志對(duì)操作、接收及發(fā)送的數(shù)據(jù)進(jìn)行記錄，日志至少存儲(chǔ)6個(gè)月；采用雙機(jī)熱備份，主平臺(tái)出現(xiàn)故障時(shí)能夠自動(dòng)切換到備份平臺(tái)；平臺(tái)間數(shù)據(jù)交換采用加密傳輸方式。運(yùn)行環(huán)境要求平臺(tái)應(yīng)滿足以下運(yùn)行環(huán)境要

12、求：a)數(shù)據(jù)庫(kù)服務(wù)器支持大數(shù)據(jù)量存儲(chǔ)與檢索；b)局域網(wǎng)網(wǎng)絡(luò)交換速度不低于100Mbps。（規(guī)范性附錄）數(shù)據(jù)交換HTTP接口協(xié)議數(shù)據(jù)格式及約束條件數(shù)據(jù)格式見(jiàn)JT/T 697.12013中5.15。所有的請(qǐng)求和應(yīng)答報(bào)文均采用JSON格式。約束條件見(jiàn)表A.1。約束條件符號(hào)約束條件?0.1，可選項(xiàng)*0.n，可以沒(méi)有，也可以有多項(xiàng)+1.n，至少有1項(xiàng)，也可以有多項(xiàng)1必須且只能填1項(xiàng)F固定長(zhǎng)度V可變長(zhǎng)度接口通用應(yīng)答接口通用應(yīng)答字段名稱(chēng)層級(jí)類(lèi)型取值默認(rèn)值意義備注errorcode1.1int詳見(jiàn)附錄A.3錯(cuò)誤碼定義0錯(cuò)誤碼message1.2stringnull提示信息data1.3objectnull附加

13、信息錯(cuò)誤碼定義錯(cuò)誤碼定義錯(cuò)誤碼意義備注0執(zhí)行成功/數(shù)據(jù)上傳成功1執(zhí)行失敗100請(qǐng)求的服務(wù)/資源不存在200數(shù)據(jù)格式錯(cuò)誤，無(wú)法正確解析統(tǒng)一編號(hào)規(guī)則學(xué)時(shí)記錄編號(hào)：XXXXXX（行政代碼）XXXX（運(yùn)營(yíng)商序列號(hào))XXXXXX（計(jì)時(shí)設(shè)備序列號(hào))XXXXXX（年月日YYMMDD）XXXX（自增流水號(hào)）課程編碼：X（階段：1、2、3）X（實(shí)操1,理論集中學(xué)習(xí)2，模擬3，遠(yuǎn)程教學(xué)4）XX（一級(jí)課程）XX（二級(jí)課程）XX（三級(jí)課程）XX（四級(jí)課程）文件資料信息接口業(yè)務(wù)描述：資料文件上傳，支持JPG/JPEG、PNG、PDF等不同類(lèi)型的文件。不同的接口需要上傳的信息中含有多媒體、PDF等資料文件時(shí)，應(yīng)先使用本接

14、口上傳資料文件，從應(yīng)答中獲得文件的ID，然后再使用相應(yīng)的業(yè)務(wù)數(shù)據(jù)接口并將獲得的文件ID和其他信息一起上傳。接口定義見(jiàn)表A.4：文件資料信息上傳接口定義服務(wù)名ImageupURL/imageup/type? v=version&ts=timestamp&sign=sign_str&user=cert_snHTTP方法POST參數(shù)/表域Type:文件業(yè)務(wù)類(lèi)型stuimg:學(xué)員頭像；stufp:學(xué)員指紋；coachimg:教練員頭像；coachfp:教練員指紋；examinerimg:考核員頭像；examinerfp:考核員指紋；securityguardimg:安全員頭像；securityguar

15、dfg：安全員指紋；vehimg:教練車(chē)圖片；outletsimg:招生點(diǎn)照片；occupationimg:資格證書(shū)圖片；voiceprintimg:聲紋文件；epdfimg:電子培訓(xùn)部分記錄表PDF文件；onlineimg:網(wǎng)絡(luò)遠(yuǎn)程學(xué)習(xí)過(guò)程照片；classroom:課堂教學(xué)過(guò)程照片；simulation:模擬教學(xué)過(guò)程照片；video:視頻文件備注應(yīng)答報(bào)文格式見(jiàn)表A.5：文件資料信息上傳應(yīng)答報(bào)文格式序號(hào)元素名稱(chēng)必選類(lèi)型長(zhǎng)度字段名稱(chēng)描述及要求1errorcode是數(shù)值型V16返回碼2message是字符型V128提示信息3data是對(duì)象附加信息4id是數(shù)值型V16成功上傳的文件ID平臺(tái)間數(shù)據(jù)傳輸

16、接口培訓(xùn)機(jī)構(gòu)信息培訓(xùn)機(jī)構(gòu)信息接口備案培訓(xùn)機(jī)構(gòu)接口業(yè)務(wù)描述：用于計(jì)時(shí)平臺(tái)向廣州市學(xué)駕服務(wù)平臺(tái)備案培訓(xùn)機(jī)構(gòu)信息。接口定義見(jiàn)表A.6：備案培訓(xùn)機(jī)構(gòu)接口定義服務(wù)名InstitutionURL/institution? v=version&ts=timestamp&sign=sign_str&user=cert_snHTTP方法POST參數(shù)/表域備注請(qǐng)求報(bào)文格式見(jiàn)表A.7：備案培訓(xùn)機(jī)構(gòu)請(qǐng)求報(bào)文格式序號(hào)元素名稱(chēng)必選類(lèi)型長(zhǎng)度字段名稱(chēng)描述及要求1district是字符型F6區(qū)縣行政區(qū)劃代碼見(jiàn)GB/T 22602name是字符型V256培訓(xùn)機(jī)構(gòu)名稱(chēng)填寫(xiě)名稱(chēng)全稱(chēng)3shortname是字符型V128培訓(xùn)機(jī)構(gòu)簡(jiǎn)稱(chēng)填寫(xiě)

17、簡(jiǎn)稱(chēng)4licnum是字符型F12經(jīng)營(yíng)許可證編號(hào)5licetime是字符型V64經(jīng)營(yíng)許可日期YYYYMMDD6business是字符型F20營(yíng)業(yè)執(zhí)照注冊(cè)號(hào)7creditcode否字符型F18統(tǒng)一社會(huì)信用代碼8address是字符型V512培訓(xùn)機(jī)構(gòu)地址9postcode是字符型F6郵政編碼10legal是字符型V64法人代表11contact是字符型V64聯(lián)系人12phone是字符型V32聯(lián)系電話13busiscope是字符型V8經(jīng)營(yíng)范圍下列編碼可多選，以英文逗號(hào)分隔：A1,A2,A3,B1,B2,C1,C2,C3,C4,C5,D,E,F,M,N,P14busistatus是字符型V8經(jīng)營(yíng)狀態(tài)經(jīng)營(yíng)

18、狀態(tài)定義如下：1:營(yíng)業(yè)2:停業(yè)3:整改4:停業(yè)整頓5:歇業(yè)6:注銷(xiāo)9:其他15level是字符型V8分類(lèi)等級(jí)1:一級(jí)2:二級(jí)3:三級(jí)16coachnumber是數(shù)值型V16教練員總數(shù)17grasupvnum是數(shù)值型V16考核員總數(shù)18safmngnum是數(shù)值型V16安全員總數(shù)19tracarnum是數(shù)值型V16教練車(chē)總數(shù)20classroom否數(shù)值型V16教室總面積單位：m221thclassroom否數(shù)值型V16理論教室面積單位：m222praticefield是數(shù)值型V16教練場(chǎng)總面積單位：m223roadallowcert是字符型F12道路經(jīng)營(yíng)許可證24passdept是字符型V32批準(zhǔn)

19、機(jī)關(guān)25cardvilidity是字符型V10證件有效期YYYYMMDD26prvdcarddate是字符型V10發(fā)證日期YYYYMMDD27trainvhcltype是字符型F8培訓(xùn)車(chē)型可多選，以英文逗號(hào)分隔：A1,A2,A3,B1,B2,C1,C2,C3,C4,C5,D,E,F,M,N,P28corptype是字符型F2企業(yè)類(lèi)型單選：1:普通機(jī)動(dòng)車(chē)駕駛員培訓(xùn)2:道路運(yùn)輸從業(yè)資格培訓(xùn)3:機(jī)動(dòng)車(chē)駕駛員培訓(xùn)訓(xùn)練場(chǎng)4:機(jī)動(dòng)車(chē)駕駛員培訓(xùn)教練場(chǎng)經(jīng)營(yíng)5:普通合伙29opendate是字符型V10開(kāi)業(yè)日期YYYYMMDD應(yīng)答報(bào)文格式如下表：備案培訓(xùn)機(jī)構(gòu)應(yīng)答報(bào)文格式序號(hào)層級(jí)元素名稱(chēng)約束類(lèi)型長(zhǎng)度描述取值說(shuō)明1

20、1.1errorcode1數(shù)值型V16錯(cuò)誤碼21.2message1字符型V128提示信息31.3data1對(duì)象附加信息41.3.1inscode1字符型V128培訓(xùn)機(jī)構(gòu)編號(hào)統(tǒng)一編號(hào)教練員信息接口備案教練員業(yè)務(wù)描述：用于計(jì)時(shí)平臺(tái)向廣州市學(xué)駕服務(wù)平臺(tái)備案教練員信息。圖片文件ID應(yīng)先使用A5.3文件資料信息接口成功上傳圖片后獲得。接口定義見(jiàn)表A.9：備案教練員接口定義服務(wù)名CoachURL/coach? v=version&ts=timestamp&sign=sign_str&user=cert_snHTTP方法POST參數(shù)/表域備注請(qǐng)求報(bào)文格式見(jiàn)表A.10：備案教練員請(qǐng)求報(bào)文格式序號(hào)元素名稱(chēng)必選

21、類(lèi)型長(zhǎng)度字段名稱(chēng)描述及要求1inscode是字符型F16培訓(xùn)機(jī)構(gòu)編號(hào)統(tǒng)一編號(hào)2name是字符型V64姓名3sex是數(shù)值型V4性別1:男性;2:女性4idcard是字符型V128身份證號(hào)5mobile是字符型V32手機(jī)號(hào)碼6address否字符型V256聯(lián)系地址7photo是數(shù)值型V16照片文件ID成功上傳的教練員頭像文件ID8fingerprint否數(shù)值型V16指紋圖片ID成功上傳的指紋圖片ID9drilicence是字符型V128駕駛證號(hào)10fstdrilicdate是字符型V64駕駛證初領(lǐng)日期YYYYMMDD11occupationno否字符型V128職業(yè)資格證號(hào)12occupationl

22、evel否字符型V8職業(yè)資格等級(jí)1:一級(jí)2:二級(jí)3:三級(jí)4:四級(jí)13dripermitted是字符型V8準(zhǔn)駕車(chē)型下列編碼單選：A1,A2,A3,B1,B2,C1,C2,C3,C4,C5,D,E,F,M,N,P14teachpermitted是字符型V8準(zhǔn)教車(chē)型下列編碼單選：A1,A2,A3,B1,B2,C1,C2,C3,C4,C5,D,E,F,M,N,P15employstatus是字符型V4供職狀態(tài)0:在職1:離職16hiredate是字符型V64入職日期YYYYMMDD17leavedate否字符型V64離職日期YYYYMMDD18birthdate是字符型V64出生日期YYYYMMDD1

23、9position是字符型F1崗位可多選：1:理論教練員2:實(shí)操教練員20educationlevel是字符型F2學(xué)歷單選：1:博士,2:碩士,3:本科生,4:大專(zhuān),5:中專(zhuān),6:高中,7:初中21coachcert否字符型V32教練員證號(hào)應(yīng)答報(bào)文格式如下表：備案教練員接口應(yīng)答報(bào)文格式序號(hào)層級(jí)元素名稱(chēng)約束類(lèi)型長(zhǎng)度描述取值說(shuō)明11.1errorcode1數(shù)值型V16錯(cuò)誤碼21.2message1字符型V128提示信息31.3data1對(duì)象附加信息41.3.1coachnum1字符型V128教練員編號(hào)統(tǒng)一編號(hào)教練車(chē)信息接口備案及修改教練車(chē)業(yè)務(wù)描述：用于計(jì)時(shí)平臺(tái)向廣州市學(xué)駕服務(wù)平臺(tái)備案教練車(chē)信息。圖

24、片文件ID應(yīng)先使用A5.3文件資料信息接口成功上傳圖片后獲得。接口定義見(jiàn)表A.12：備案教練車(chē)接口定義服務(wù)名TrainingCarURL/trainingcar? v=version&ts=timestamp&sign=sign_str&user=cert_snHTTP方法POST參數(shù)/表域備注請(qǐng)求報(bào)文格式見(jiàn)表A.13：備案教練車(chē)請(qǐng)求報(bào)文格式序號(hào)元素名稱(chēng)必選類(lèi)型長(zhǎng)度字段名稱(chēng)描述及要求1inscode是字符型F16駕培編號(hào)統(tǒng)一編號(hào)2franum否字符型V32車(chē)架號(hào)3engnum否字符型V32發(fā)動(dòng)機(jī)號(hào)4licnum是字符型V64車(chē)牌號(hào)5platecolor是字符型V64車(chē)牌顏色1:藍(lán)色2:黃色3:

25、黑色4:白色5:綠色9:其他6photo是否數(shù)值型V16圖片成功上傳的教練車(chē)照片文件ID7manufacture是字符型V256生產(chǎn)廠家如“上汽大眾”8brand是字符型V256車(chē)輛品牌如“桑塔納”9model否字符型V128教學(xué)車(chē)型如“普通桑塔納”、“桑塔納2000”10perdritype是字符型V8培訓(xùn)車(chē)型下列編碼單選：A1,A2,A3,B1,B2,C1,C2,C3,C4,C5,D,E,F,M,N,P11buydate是字符型V64購(gòu)買(mǎi)日期YYYYMMDD12coachvehicleid是字符型V32教練車(chē)憑證號(hào)13loadseat是數(shù)值型F2載客量14factorymodel是字符型V

26、16廠牌型號(hào)應(yīng)答報(bào)文格式如下表：備案教練車(chē)接口應(yīng)答報(bào)文格式序號(hào)層級(jí)元素名稱(chēng)約束類(lèi)型長(zhǎng)度描述取值說(shuō)明11.1errorcode1數(shù)值型V16錯(cuò)誤碼21.2message1字符型V128提示信息31.3data1對(duì)象附加信息41.3.1carnum1字符型V128教練車(chē)編號(hào)統(tǒng)一編號(hào)培訓(xùn)機(jī)構(gòu)教學(xué)區(qū)域備案教學(xué)區(qū)域接口業(yè)務(wù)描述：用于計(jì)時(shí)平臺(tái)向廣州市學(xué)駕服務(wù)平臺(tái)備案培訓(xùn)機(jī)構(gòu)教學(xué)區(qū)域信息。接口定義見(jiàn)表A.15：備案教學(xué)區(qū)域接口服務(wù)名RegionURL/region? v=version&ts=timestamp&sign=sign_str&user=cert_snHTTP方法POST參數(shù)/表域備注請(qǐng)求報(bào)文格

27、式見(jiàn)表A.16：備案教學(xué)區(qū)域請(qǐng)求報(bào)文格式序號(hào)元素名稱(chēng)必選類(lèi)型長(zhǎng)度字段名稱(chēng)描述及要求1inscode是字符型F16培訓(xùn)機(jī)構(gòu)編號(hào)統(tǒng)一編號(hào)2seq是字符型V4教學(xué)區(qū)域編號(hào)計(jì)時(shí)平臺(tái)順序編號(hào)3name否字符型V256教學(xué)區(qū)域名稱(chēng)4address是字符型V256教學(xué)區(qū)域地址5area是數(shù)值型V6教學(xué)區(qū)域面積單位:m26type是數(shù)值型V2教學(xué)區(qū)域類(lèi)型1：第二部分；2：第三部分7vehicletype是字符型V256培訓(xùn)車(chē)型下列編碼可多選，以英文逗號(hào)分隔A1,A2,A3,B1,B2,C1,C2,C3,C4,C5,D,E,F,M,N,P8polygon是字符型V1024多邊形坐標(biāo)序列經(jīng)度1，緯度1；經(jīng)度2，緯

28、度2；經(jīng)度3，緯度3；9totalvehnum否數(shù)值型V6可容納車(chē)輛數(shù)10curvehnum否數(shù)值型V6已投放車(chē)輛數(shù)應(yīng)答報(bào)文格式：通用應(yīng)答。計(jì)時(shí)終端信息接口備案計(jì)時(shí)終端業(yè)務(wù)描述：用于計(jì)時(shí)平臺(tái)向廣州市學(xué)駕服務(wù)平臺(tái)備案計(jì)時(shí)終端信息。接口定義見(jiàn)表A.17：備案計(jì)時(shí)終端接口定義服務(wù)名DeviceURL/device? v=version&ts=timestamp&sign=sign_str&user=cert_snHTTP方法POST參數(shù)/表域備注請(qǐng)求報(bào)文格式見(jiàn)表A.18：備案計(jì)時(shí)終端請(qǐng)求報(bào)文格式序號(hào)元素名稱(chēng)必選類(lèi)型長(zhǎng)度字段名稱(chēng)描述及要求1termtype是數(shù)值型V4計(jì)時(shí)終端類(lèi)型1:車(chē)載計(jì)程計(jì)時(shí)終端2

29、:課堂教學(xué)計(jì)時(shí)終端3:模擬訓(xùn)練計(jì)時(shí)終端2vender是字符串V128生產(chǎn)廠家3model是字符串V128終端型號(hào)4imei是字符型V128終端IMEI號(hào)或設(shè)備MAC地址5sn是字符型V128終端出廠序列號(hào)6inscode是字符型F16培訓(xùn)機(jī)構(gòu)編號(hào)統(tǒng)一編號(hào)，課堂教學(xué)和模擬訓(xùn)練計(jì)時(shí)終端應(yīng)上傳應(yīng)答報(bào)文格式如下表：備案計(jì)時(shí)終端接口應(yīng)答報(bào)文格式序號(hào)元素名稱(chēng)約束類(lèi)型長(zhǎng)度描述取值說(shuō)明1errorcode是數(shù)值型V128錯(cuò)誤碼2message是字符型V128提示信息3data是對(duì)象附加信息4devnum是字符型V128終端編號(hào)統(tǒng)一編號(hào)5key是字符型V4096終端證書(shū)6passwd是字符型V12終端證書(shū)口令車(chē)

30、載計(jì)程計(jì)時(shí)終端綁定接口業(yè)務(wù)描述：用于計(jì)時(shí)平臺(tái)在車(chē)載計(jì)程計(jì)時(shí)終端安裝后，向廣州市學(xué)駕服務(wù)平臺(tái)上傳計(jì)時(shí)終端綁定教練車(chē)信息并進(jìn)行備案。接口定義見(jiàn)表A.20：車(chē)載計(jì)程計(jì)時(shí)終端綁定接口定義服務(wù)名DevassignURL/devassign? v=version&ts=timestamp&sign=sign_str&user=cert_snHTTP方法POST參數(shù)/表域備注請(qǐng)求報(bào)文格式見(jiàn)表A.21：車(chē)載計(jì)程計(jì)時(shí)終端綁定請(qǐng)求報(bào)文格式序號(hào)元素名稱(chēng)必選類(lèi)型長(zhǎng)度字段名稱(chēng)描述及要求1devnum是字符型F16終端編號(hào)統(tǒng)一編號(hào)2carnum是字符型F16車(chē)輛編號(hào)統(tǒng)一編號(hào)3sim是字符型V16終端SIM卡號(hào)應(yīng)答報(bào)文格式

31、：通用應(yīng)答。車(chē)載計(jì)程計(jì)時(shí)終端解綁接口業(yè)務(wù)描述：用于車(chē)載計(jì)程計(jì)時(shí)終端拆除或更換后，向廣州市學(xué)駕服務(wù)平臺(tái)上傳計(jì)時(shí)終端解除綁定教練車(chē)信息并進(jìn)行備案。接口定義見(jiàn)表A.22：車(chē)載計(jì)程計(jì)時(shí)終端解綁接口定義服務(wù)名DevRembindingURL/devRembinding? v=version&ts=timestamp&sign=sign_str&user=cert_snHTTP方法POST參數(shù)/表域備注請(qǐng)求報(bào)文格式見(jiàn)表A.23：車(chē)載計(jì)程計(jì)時(shí)終端解綁請(qǐng)求報(bào)文格式序號(hào)元素名稱(chēng)必選類(lèi)型長(zhǎng)度字段名稱(chēng)描述及要求1devnum是字符型F16終端編號(hào)統(tǒng)一編號(hào)2carnum是字符型F16車(chē)輛編號(hào)統(tǒng)一編號(hào)3sim是字符型V

32、16終端SIM卡號(hào)應(yīng)答報(bào)文格式：通用應(yīng)答。學(xué)員培訓(xùn)過(guò)程信息學(xué)員信息接口備案學(xué)員信息業(yè)務(wù)描述：用于計(jì)時(shí)平臺(tái)向廣州市學(xué)駕服務(wù)平臺(tái)備案學(xué)員信息。接口定義見(jiàn)表A.24：備案及修改學(xué)員接口定義服務(wù)名StudentURL/student? v=version&ts=timestamp&sign=sign_str&user=cert_snHTTP方法POST參數(shù)/表域備注請(qǐng)求報(bào)文格式見(jiàn)表A.25：備案及修改學(xué)員請(qǐng)求報(bào)文格式序號(hào)元素名稱(chēng)必選類(lèi)型長(zhǎng)度字段名稱(chēng)描述及要求1inscode是字符型F16培訓(xùn)機(jī)構(gòu)編號(hào)統(tǒng)一編號(hào)2stunum否字符型F16學(xué)員編號(hào)新增不傳 修改必傳3cardtype是字符型V4證件類(lèi)型1:

33、身份證2:護(hù)照3:軍官證4:其他4idcard是字符型V128證件號(hào)5nationality是字符型V128國(guó)籍6name是字符型V64姓名7sex是字符型V4性別1:男性;2:女性8phone是字符型V32移動(dòng)號(hào)碼9address否字符型V256郵寄地址10photo是數(shù)值型V16照片文件ID成功上傳的學(xué)員頭像照片文件ID11fingerprint否數(shù)值型V16指紋圖片ID12busitype是字符型V4業(yè)務(wù)類(lèi)型0:初領(lǐng)1:增領(lǐng)9:其他13drilicnum否字符型V128駕駛證號(hào)14fstdrilicdate否字符型V64駕駛證初領(lǐng)日期YYYYMMDD15perdritype否字符型V8原

34、準(zhǔn)駕車(chē)型下列編碼單選：A1,A2,A3,B1,B2,C1,C2,C3,C4,C5,D,E,F,M,N,P16traintype是字符型V8申請(qǐng)車(chē)型下列編碼單選：A1,A2,A3,B1,B2,C1,C2,C3,C4,C5,D,E,F,M,N,P17applydate是字符型V64報(bào)名時(shí)間YYYYMMDD18registercode是字符型V16注冊(cè)碼19birthdate是字符型V64出生日期20cardtype2否字符型V4證件類(lèi)型21:身份證2:護(hù)照3:軍官證4:其他21idcard2否字符型V128證件號(hào)222postcode否字符型V6郵政編號(hào)23cardaddress否字符型V256證

35、件地址24telephone否字符型V32固定電話25applyfrom否字符型V128申請(qǐng)來(lái)源1:本地,2:外地,3:外籍4:轉(zhuǎn)入,5:軍警,6:香港7:澳門(mén),8:臺(tái)灣,9:使領(lǐng)館10:農(nóng)機(jī)26applyaddress否字符型V128報(bào)名地點(diǎn)27contractnum否字符型V16協(xié)議編號(hào)28practicecoach否字符型V32實(shí)操教練29platenum否字符型V16車(chē)牌號(hào)30recruitprice否數(shù)值型F8招生價(jià)格31recordprice否數(shù)值型F8備案價(jià)格32ispoor是字符型V1是否貧困生1是0不是33istimer是字符型V1是否計(jì)時(shí)培訓(xùn)學(xué)員1是0不是34areacod

36、e是字符型V6證件地區(qū)號(hào)35areacode2否字符型V6聯(lián)系地址區(qū)號(hào)36distinguishcolor否字符型V1辨色力1合格0不合格37upperlimb否字符型V1上肢1合格0不合格38leftlowerlimb否字符型V1左下肢1合格0不合格39rightlowerlimb否字符型V1右下肢1合格0不合格40trunkneck否字符型V1軀干頸部1合格0不合格41hearing否字符型V1聽(tīng)力1合格0不合格42height否數(shù)值型V1身高（cm）43checkdate否字符型V64體檢日期YYYYMMDD44leftsight否字符型V8左視力45rightsight否字符型V8右視

37、力46hospital否字符型V128體檢醫(yī)院47idphysicscard否字符型V32身份證物理卡號(hào)應(yīng)答報(bào)文格式見(jiàn)表A.26：學(xué)員備案應(yīng)答報(bào)文格式序號(hào)元素名稱(chēng)必選類(lèi)型長(zhǎng)度字段名稱(chēng)描述及要求1errorcode是數(shù)值型V16返回碼2message是字符型V128提示信息3data是對(duì)象附加信息4stunum是字符型F16學(xué)員編號(hào)統(tǒng)一編號(hào)(新增時(shí)返回)電子教學(xué)日志接口業(yè)務(wù)描述：用于計(jì)時(shí)平臺(tái)或遠(yuǎn)程教育平臺(tái)向廣州市學(xué)駕服務(wù)平臺(tái)上傳學(xué)員學(xué)時(shí)信息進(jìn)行備案。實(shí)車(chē)教學(xué)的照片不必使用A5.3文件資料信息接口上傳，其圖片ID采用計(jì)時(shí)終端編號(hào)+TCP協(xié)議中轉(zhuǎn)發(fā)的照片編號(hào)。圖片文件ID應(yīng)先使用A5.3文件資料信息

38、接口成功上傳圖片后獲得。接口定義見(jiàn)表A.27：培訓(xùn)學(xué)時(shí)接口定義服務(wù)名ClassRecordURL/classrecord? v=version&ts=timestamp&sign=sign_str&user=cert_snHTTP方法POST參數(shù)/表域備注請(qǐng)求報(bào)文格式見(jiàn)表A.28：培訓(xùn)學(xué)時(shí)接口請(qǐng)求報(bào)文格式序號(hào)元素名稱(chēng)必選類(lèi)型長(zhǎng)度字段名稱(chēng)描述及要求1inscode是字符型F16培訓(xùn)機(jī)構(gòu)編號(hào)統(tǒng)一編號(hào)2stunum是字符型F16學(xué)員編號(hào)統(tǒng)一編號(hào)3coachnum是字符型F16教練員編號(hào)統(tǒng)一編號(hào)，遠(yuǎn)程教育平臺(tái)不使用4carnum是字符型F16教練車(chē)編號(hào)統(tǒng)一編號(hào)，遠(yuǎn)程教育平臺(tái)不使用5simunum是字符

39、型F16計(jì)時(shí)終端編號(hào)統(tǒng)一編號(hào)，遠(yuǎn)程教育平臺(tái)不使用6platnum是字符型F5平臺(tái)編號(hào)計(jì)時(shí)平臺(tái)或遠(yuǎn)程教育平臺(tái)編號(hào)7recnum是字符型F5電子教學(xué)日志編號(hào)平臺(tái)自主編號(hào)8subjcode是字符型F10課程編碼見(jiàn)A4.29photo1是字符型V32簽到照片相片文件1ID10photo2否字符型V32隨機(jī)照片相片文件2ID，從每15分鐘拍攝的照片中隨機(jī)選一張，超過(guò)15分鐘的教學(xué)必選11photo3是字符型V32簽退照片相片文件3ID12starttime是字符型V64培訓(xùn)開(kāi)始時(shí)間YYYYMMDDHHmmss13endtime是字符型V64培訓(xùn)結(jié)束時(shí)間YYYYMMDDHHmmss14duration是字

40、符型V64培訓(xùn)學(xué)時(shí)單位：min15mileage是數(shù)值型V16培訓(xùn)里程單位：km，非實(shí)操時(shí)為016avevelocity是數(shù)值型V16培訓(xùn)平均速度單位：km/h，非實(shí)操時(shí)為017coacmt否字符型V64教練員點(diǎn)評(píng)18total是數(shù)值型V6總累計(jì)學(xué)時(shí)單位：min19part1是數(shù)值型V6第一部分累計(jì)學(xué)時(shí)單位：min20part2是數(shù)值型V6第二部分累計(jì)學(xué)時(shí)單位：min21part3是數(shù)值型V6第三部分累計(jì)學(xué)時(shí)單位：min22part4是數(shù)值型V6第四部分累計(jì)學(xué)時(shí)單位：min23trainid是數(shù)值型V10課堂ID標(biāo)識(shí)學(xué)員的一次培訓(xùn)過(guò)程，計(jì)時(shí)平臺(tái)自行使用應(yīng)答報(bào)文格式：通用應(yīng)答。學(xué)時(shí)信息接口階段培

41、訓(xùn)記錄信息接口業(yè)務(wù)描述：用于計(jì)時(shí)平臺(tái)或遠(yuǎn)程教育平臺(tái)向廣州市學(xué)駕服務(wù)平臺(tái)上傳階段培訓(xùn)記錄信息和電子培訓(xùn)部分記錄表進(jìn)行審核，電子培訓(xùn)部分記錄表PDF文件ID應(yīng)先使用A5.3文件資料信息接口成功上傳文件后獲得。再次提交同一學(xué)員同一培訓(xùn)部分的階段培訓(xùn)記錄時(shí)，應(yīng)僅提交本次新補(bǔ)充的學(xué)時(shí)記錄。接口定義見(jiàn)表A.29：階段培訓(xùn)記錄接口定義服務(wù)名StageTrainningTimeURL/stagetrainningtime? v=version&ts=timestamp&sign=sign_str&user=cert_snHTTP方法POST參數(shù)/表域備注請(qǐng)求報(bào)文格式見(jiàn)表A.30：階段培訓(xùn)記錄請(qǐng)求報(bào)文格式序號(hào)元

42、素名稱(chēng)必選類(lèi)型長(zhǎng)度字段名稱(chēng)描述及要求1inscode是字符型F16培訓(xùn)機(jī)構(gòu)編號(hào)統(tǒng)一編號(hào)2stunum是字符型F16學(xué)員編號(hào)統(tǒng)一編號(hào)3subject是數(shù)值型V8培訓(xùn)部分1:第一部分；2:第二部分；3:第三部分；4:第四部分4totaltime是數(shù)值型V6培訓(xùn)部分總學(xué)時(shí)單位：分鐘，本培訓(xùn)部分實(shí)際完成的總學(xué)時(shí)，學(xué)員主動(dòng)要求以及由于考核或考試不合格增加的學(xué)時(shí)也應(yīng)上報(bào)5vehicletime是數(shù)值型V6實(shí)車(chē)教學(xué)學(xué)時(shí)單位：分鐘，本培訓(xùn)部分實(shí)際完成的實(shí)車(chē)教學(xué)學(xué)時(shí)，第一、四部分時(shí)為06classtime是數(shù)值型V6課堂教學(xué)學(xué)時(shí)單位：分鐘，本培訓(xùn)部分實(shí)際完成的課堂教學(xué)學(xué)時(shí)，第二、三部分時(shí)為07simulator

43、time是數(shù)值型V6模擬器教學(xué)學(xué)時(shí)單位：分鐘，本培訓(xùn)部分實(shí)際完成的模擬器教學(xué)學(xué)時(shí)，第一、四部分時(shí)為08networktime是數(shù)值型V6遠(yuǎn)程教學(xué)學(xué)時(shí)單位：分鐘，本培訓(xùn)部分實(shí)際完成的遠(yuǎn)程教學(xué)學(xué)時(shí)，第二、三部分時(shí)為09duration是數(shù)值型V6培訓(xùn)學(xué)時(shí)單位：分鐘，本次上報(bào)本培訓(xùn)部分的初審總學(xué)時(shí)10examresult是數(shù)值型V4考核結(jié)果0:未考核；1:合格；2:不合格11mileage否數(shù)值型V6培訓(xùn)里程非第三部分時(shí)可置“0”12pdfid否數(shù)值型V16電子培訓(xùn)部分記錄表PDF文件ID計(jì)時(shí)平臺(tái)應(yīng)使用13esignature是字符型V1024培訓(xùn)機(jī)構(gòu)電子簽章數(shù)據(jù)14rectype是數(shù)值型V4學(xué)時(shí)組

44、成1：實(shí)車(chē)教學(xué)；2：課堂教學(xué)；3：模擬器教學(xué)；4：遠(yuǎn)程教學(xué)；5：混合15recarray是數(shù)組學(xué)時(shí)記錄編號(hào)數(shù)組實(shí)車(chē)教學(xué)時(shí)使用計(jì)時(shí)終端通過(guò)TCP協(xié)議上傳的學(xué)時(shí)記錄編號(hào)；課堂教學(xué)、模擬器教學(xué)、網(wǎng)絡(luò)遠(yuǎn)程教學(xué)時(shí)使用學(xué)員編號(hào)+電子教學(xué)日志編號(hào)16rnum是字符型F26第1個(gè)學(xué)時(shí)記錄編號(hào)17rnum是字符型F26第n個(gè)學(xué)時(shí)記錄編號(hào)應(yīng)答報(bào)文格式：通用應(yīng)答。教練車(chē)進(jìn)出場(chǎng)接口業(yè)務(wù)描述：用于計(jì)時(shí)平臺(tái)備案在教學(xué)區(qū)域進(jìn)出場(chǎng)的教練車(chē)登記信息。接口定義見(jiàn)表A.31：教練車(chē)進(jìn)出場(chǎng)接口定義服務(wù)名VehicleRecordURL/vehiclerecord? v=version&ts=timestamp&sign=sign_s

45、tr&user=cert_snHTTP方法POST參數(shù)/表域備注請(qǐng)求報(bào)文格式見(jiàn)表A.32：教練車(chē)進(jìn)出場(chǎng)接口請(qǐng)求報(bào)文格式序號(hào)元素名稱(chēng)必選類(lèi)型長(zhǎng)度字段名稱(chēng)描述及要求1inscode是字符型F16培訓(xùn)機(jī)構(gòu)編號(hào)統(tǒng)一編號(hào)2seq是字符型V8教學(xué)區(qū)域編號(hào)3platenum是字符型F16車(chē)牌號(hào)6starttime是字符型V20進(jìn)場(chǎng)時(shí)間YYYYMMDDHHmmss7endtime是字符型V64出場(chǎng)時(shí)間YYYYMMDDHHmmss應(yīng)答報(bào)文格式：通用應(yīng)答。平臺(tái)間數(shù)據(jù)通知接口消息通知審核結(jié)果消息通知接口業(yè)務(wù)描述：由計(jì)時(shí)平臺(tái)或遠(yuǎn)程教育平臺(tái)提供，用于監(jiān)管平臺(tái)在審核完成后向計(jì)時(shí)平臺(tái)或遠(yuǎn)程教育平臺(tái)發(fā)送消息通知，計(jì)時(shí)平臺(tái)根據(jù)

46、審核類(lèi)型調(diào)用相應(yīng)的審核結(jié)果查詢接口。對(duì)遠(yuǎn)程教育平臺(tái)的階段培訓(xùn)記錄審核結(jié)果，監(jiān)管平臺(tái)應(yīng)分別通知計(jì)時(shí)平臺(tái)和遠(yuǎn)程教育平臺(tái)。接口定義見(jiàn)表A.33：審核結(jié)果消息通知接口定義服務(wù)名ReviewmsgURL/reviewmsg? v=version&ts=timestamp&sign=sign_str&user=cert_snHTTP方法POST參數(shù)/表域備注請(qǐng)求報(bào)文格式見(jiàn)表A.34：審核結(jié)果消息通知請(qǐng)求報(bào)文格式序號(hào)元素名稱(chēng)必選類(lèi)型長(zhǎng)度字段名稱(chēng)描述及要求1reviewtype是字符型V4審核結(jié)果通知類(lèi)型3：電子教學(xué)日志4：教學(xué)區(qū)域；2data是對(duì)象審核結(jié)果參數(shù)見(jiàn)表A.35、表A.36審核結(jié)果消息通知內(nèi)容-教

47、學(xué)區(qū)域?qū)徍私Y(jié)果參數(shù)報(bào)文格式序號(hào)元素名稱(chēng)必選類(lèi)型長(zhǎng)度字段名稱(chēng)描述及要求1inscode是字符型F16培訓(xùn)機(jī)構(gòu)編號(hào)統(tǒng)一編號(hào)2seq是字符型V4教學(xué)區(qū)域編號(hào)計(jì)時(shí)平臺(tái)順序編號(hào)3name否字符型V256教學(xué)區(qū)域名稱(chēng)4address是字符型V256教學(xué)區(qū)域地址5area是數(shù)值型V6教學(xué)區(qū)域面積單位:m26type是數(shù)值型V2教學(xué)區(qū)域類(lèi)型1：第二部分；2：第三部分7vehicletype是字符型V256培訓(xùn)車(chē)型下列編碼可多選，以英文逗號(hào)分隔A1,A2,A3,B1,B2,C1,C2,C3,C4,C5,D,E,F,M,N,P8polygon是字符型V1024多邊形坐標(biāo)序列經(jīng)度1，緯度1；經(jīng)度2，緯度2；經(jīng)度3，

48、緯度3；9totalvehnum否數(shù)值型V6可容納車(chē)輛數(shù)10curvehnum否數(shù)值型V6已投放車(chē)輛數(shù)11state是數(shù)值型V6狀態(tài)0:停用, 1：?jiǎn)⒂脤徍私Y(jié)果消息通知內(nèi)容-電子教學(xué)日志審核結(jié)果參數(shù)報(bào)文格式序號(hào)元素名稱(chēng)必選類(lèi)型長(zhǎng)度字段名稱(chēng)描述及要求1inscode是字符型F16培訓(xùn)機(jī)構(gòu)編號(hào)統(tǒng)一編號(hào)2stunum是字符型F16學(xué)員編號(hào)統(tǒng)一編號(hào)3recnum是字符型F5電子教學(xué)日志編號(hào)平臺(tái)自主編號(hào)4subject是數(shù)值型V8培訓(xùn)部分1:第一部分；2:第二部分；3:第三部分；4:第四部分5duration是數(shù)值型V6審核合格學(xué)時(shí)本培訓(xùn)部分本次的審核合格總學(xué)時(shí)，單位min6trainid是數(shù)值型V10

49、課堂ID標(biāo)識(shí)學(xué)員的一次培訓(xùn)過(guò)程，計(jì)時(shí)平臺(tái)自行使用應(yīng)答報(bào)文格式：通用應(yīng)答。（規(guī)范性附錄）實(shí)時(shí)傳輸TCP接口協(xié)議概述本附錄規(guī)定了計(jì)時(shí)終端與計(jì)時(shí)平臺(tái)、計(jì)時(shí)平臺(tái)或遠(yuǎn)程教育平臺(tái)與監(jiān)管服務(wù)平臺(tái)以及監(jiān)管服務(wù)平臺(tái)與全國(guó)駕培平臺(tái)之間的實(shí)時(shí)傳輸通信協(xié)議與數(shù)據(jù)格式，包括協(xié)議基礎(chǔ)、通信連接、消息處理、協(xié)議分類(lèi)與說(shuō)明及數(shù)據(jù)格式。協(xié)議基礎(chǔ)通信方式協(xié)議采用的通信方式應(yīng)符合JT/T 808中的相關(guān)規(guī)定，通信協(xié)議可采用TCP或UDP。用于計(jì)時(shí)終端與計(jì)時(shí)平臺(tái)通信時(shí)，平臺(tái)作為服務(wù)器端，終端作為客戶端，當(dāng)數(shù)據(jù)通信鏈路異常時(shí)，終端可以采用SMS消息方式進(jìn)行通信。用于計(jì)時(shí)平臺(tái)或遠(yuǎn)程教育平臺(tái)與監(jiān)管服務(wù)平臺(tái)之間的通信時(shí)，監(jiān)管服務(wù)平臺(tái)作為服務(wù)

50、器端，計(jì)時(shí)平臺(tái)或遠(yuǎn)程教育平臺(tái)作為客戶端。用于監(jiān)管服務(wù)平臺(tái)與全國(guó)駕培平臺(tái)之間的通信時(shí)，全國(guó)駕培平臺(tái)作為服務(wù)器端，監(jiān)管服務(wù)平臺(tái)作為客戶端。數(shù)據(jù)類(lèi)型協(xié)議消息中使用的數(shù)據(jù)類(lèi)型見(jiàn)表B.1。數(shù)據(jù)類(lèi)型數(shù)據(jù)類(lèi)型描述及要求BYTE無(wú)符號(hào)單字節(jié)整型(字節(jié)，8位) WORD無(wú)符號(hào)雙字節(jié)整型(字，16位) DWORD無(wú)符號(hào)四字節(jié)整型(雙字，32位)BYTEnn字節(jié)BCDn8421碼，n字節(jié)STRINGGBK編碼，采用0終結(jié)符，若無(wú)數(shù)據(jù)，則放一個(gè)0終結(jié)符傳輸規(guī)則協(xié)議采用大端模式(big-endian)的網(wǎng)絡(luò)字節(jié)序來(lái)傳遞字和雙字。約定如下:字節(jié) (BYTE)的傳輸約定:按照字節(jié)流的方式傳輸；字(WORD)的傳輸約定:先傳

51、遞高八位，再傳遞低八位；雙字(DWORD)的傳輸約定:先傳遞高24位，然后傳遞高16位，再傳遞高八位，最后傳遞低八位。消息的組成消息結(jié)構(gòu)每條消息由標(biāo)識(shí)位、消息頭、消息體和校驗(yàn)碼組成，消息結(jié)構(gòu)表見(jiàn)表B.2。消息結(jié)構(gòu)表標(biāo)識(shí)位消息頭消息體校驗(yàn)碼標(biāo)識(shí)位標(biāo)識(shí)位采用Ox7e表示，若校驗(yàn)碼、消息頭以及消息體中出現(xiàn)0 x7e，則要進(jìn)行轉(zhuǎn)義處理，轉(zhuǎn)義規(guī)則定義如下:0 x7e0 x7d后緊跟一個(gè)0 x02；0 x7d0 x7d后緊跟一個(gè)0 x01。轉(zhuǎn)義處理過(guò)程如下:發(fā)送消息時(shí):消息封裝計(jì)算并填充校驗(yàn)碼轉(zhuǎn)義;接收消息時(shí):轉(zhuǎn)義還原驗(yàn)證校驗(yàn)碼解析消息。示例:發(fā)送一包內(nèi)容為0 x30 0 x7e 0 x08 0 x7d

52、0 x55的數(shù)據(jù)包，則經(jīng)過(guò)封裝如下:0 x7e 0 x30 7d 0 x02 0 x08 0 x7d 0 x01 0 x55 0 x7e。消息頭消息頭內(nèi)容詳見(jiàn)表B.3。消息頭內(nèi)容起始字節(jié)字段數(shù)據(jù)類(lèi)型描述及要求0協(xié)議版本號(hào)BYTE協(xié)議標(biāo)準(zhǔn)的版本號(hào)，具體定義如下：0：JT/T 808-2011；1：北斗兼容車(chē)載終端通訊協(xié)議技術(shù)規(guī)范-2013；128：機(jī)動(dòng)車(chē)駕駛員計(jì)時(shí)培訓(xùn)系統(tǒng)平臺(tái)技術(shù)規(guī)范-2016；224-255：自定義；其他保留1消息IDWORD3 消息體屬性WORD消息體屬性格式結(jié)構(gòu)圖見(jiàn)表B.45終端手機(jī)號(hào)BCD8根據(jù)安裝后終端自身的手機(jī)號(hào)轉(zhuǎn)換。手機(jī)號(hào)不足16位，則在前補(bǔ)充數(shù)字，大陸手機(jī)號(hào)補(bǔ)充數(shù)

53、字0港澳臺(tái)則根據(jù)其區(qū)號(hào)進(jìn)行位數(shù)補(bǔ)充。平臺(tái)自身的業(yè)務(wù)消息使用自己的平臺(tái)編號(hào)，前補(bǔ)0 x00。13消息流水號(hào)WORD按發(fā)送順序從0開(kāi)始循環(huán)累加15預(yù)留BYTE預(yù)留16消息包封裝項(xiàng)如果消息體屬性中相關(guān)標(biāo)識(shí)位確定消息分包處理，則該項(xiàng)有內(nèi)容，否則無(wú)該項(xiàng)消息體消息體屬性格式消息體屬性格式結(jié)構(gòu)表見(jiàn)表B.4。消息體屬性格式結(jié)構(gòu)表1514131211109876543210保留分包數(shù)據(jù)加密方式消息體長(zhǎng)度數(shù)據(jù)加密方式數(shù)據(jù)加密方式定義如下:bit10-bit12為數(shù)據(jù)加密標(biāo)識(shí)位；當(dāng)此三位都為0時(shí)，表示消息體不加密；僅當(dāng)?shù)?0位為1時(shí)，表示消息體經(jīng)過(guò)RSA算法加密；其他保留。分包當(dāng)消息體屬性中第13位為1時(shí)表示消息體

54、為長(zhǎng)消息，進(jìn)行分包發(fā)送處理，具體分包信息由消息包封裝項(xiàng)決定；若第13位為0，則消息頭中無(wú)消息包封裝項(xiàng)字段。消息包封裝項(xiàng)內(nèi)容見(jiàn)表B.5。消息包封裝內(nèi)容起始字節(jié)字段數(shù)據(jù)類(lèi)型描述及要求0消息總包數(shù)WORD該消息分包后的總包數(shù)2包序號(hào)WORD從1開(kāi)始校驗(yàn)碼校驗(yàn)碼指從消息頭開(kāi)始，同后一字節(jié)異或，直到校驗(yàn)碼前一個(gè)字節(jié)，占用一個(gè)字節(jié)。通信連接連接的建立用于計(jì)時(shí)終端與計(jì)時(shí)平臺(tái)通信時(shí)，數(shù)據(jù)日常連接可采用TCP或UDP方式。用于計(jì)時(shí)平臺(tái)或遠(yuǎn)程教育平臺(tái)與監(jiān)管服務(wù)平臺(tái)、監(jiān)管服務(wù)平臺(tái)與全國(guó)駕培平臺(tái)之間的通信時(shí)，數(shù)據(jù)日常連接應(yīng)采用TCP協(xié)議長(zhǎng)連接方式?？蛻舳藦?fù)位后應(yīng)盡快與服務(wù)器端建立連接，連接建立后計(jì)時(shí)終端客戶端使用終端

55、鑒權(quán)消息進(jìn)行鑒權(quán)，平臺(tái)客戶端使用平臺(tái)登錄請(qǐng)求消息進(jìn)行登錄。連接的維持連接建立和客戶端鑒權(quán)成功后，在沒(méi)有正常業(yè)務(wù)數(shù)據(jù)包傳輸?shù)那闆r下，客戶端應(yīng)周期性向服務(wù)器端發(fā)送客戶端心跳消息，服務(wù)器端收到后向客戶端發(fā)送服務(wù)器端通用應(yīng)答消息，發(fā)送周期由客戶端參數(shù)指定。連接的斷開(kāi)服務(wù)器端和客戶端均可根據(jù)TCP協(xié)議主動(dòng)斷開(kāi)連接，雙方都應(yīng)主動(dòng)判斷TCP連接是否斷開(kāi)。服務(wù)器端判斷TCP連接斷開(kāi)的方法：收到客戶端的登出請(qǐng)求消息；根據(jù)TCP協(xié)議判斷出客戶端主動(dòng)斷開(kāi)；相同身份的客戶端建立新連接，表明原連接已斷開(kāi)；在一定的時(shí)間內(nèi)未收到客戶端發(fā)出的消息?？蛻舳伺袛郥CP連接斷開(kāi)的方法：根據(jù)TCP協(xié)議判斷出服務(wù)器端主動(dòng)斷開(kāi)；數(shù)據(jù)通信

56、鏈路斷開(kāi)；數(shù)據(jù)通信鏈路正常，達(dá)到重傳次數(shù)后仍未收到應(yīng)答。分包消息消息的分包應(yīng)在基本消息和擴(kuò)展消息消息體組包全部完成后進(jìn)行，按照每個(gè)分包的大小進(jìn)行切包，不足一個(gè)分包大小的剩余數(shù)據(jù)放在最后一個(gè)分包中。分包完成后再根據(jù)分包內(nèi)容生成相對(duì)應(yīng)的消息頭，計(jì)算校驗(yàn)碼，再進(jìn)行轉(zhuǎn)義處理。消息采用分包發(fā)送時(shí)，其分包消息應(yīng)采用連續(xù)遞增的流水號(hào)。對(duì)分包消息的應(yīng)答，如果沒(méi)有專(zhuān)門(mén)的應(yīng)答指令，則接收方應(yīng)對(duì)每條分包消息采用一條通用應(yīng)答，并使用結(jié)果字段（成功/失?。└嬷l(fā)送方是否正確收到所有的分包消息。在未正確收到所有的分包消息時(shí)，接收方可采用補(bǔ)傳分包請(qǐng)求命令要求發(fā)送方重傳缺失的分包消息。發(fā)送方應(yīng)采用原始消息將重傳包ID列表中的

57、分包重發(fā)一次，重傳分包與原始分包消息完全一致。轉(zhuǎn)發(fā)消息計(jì)時(shí)平臺(tái)在收到計(jì)時(shí)終端上傳的部分消息時(shí)，應(yīng)首先應(yīng)答終端，然后將終端上傳的消息不做任何修改直接轉(zhuǎn)發(fā)到監(jiān)管服務(wù)平臺(tái)。對(duì)所有轉(zhuǎn)發(fā)的終端消息，監(jiān)管服務(wù)平臺(tái)回復(fù)服務(wù)器端通用應(yīng)答。計(jì)時(shí)平臺(tái)應(yīng)轉(zhuǎn)發(fā)的終端消息包括：終端注冊(cè)、終端注銷(xiāo)、終端鑒權(quán)、位置匯報(bào)、教練員登錄、教練員登出、學(xué)員登錄、學(xué)員登出、上報(bào)學(xué)時(shí)記錄、照片上傳初始化、上傳照片數(shù)據(jù)包，以及對(duì)補(bǔ)傳分包請(qǐng)求消息的應(yīng)答分包消息，轉(zhuǎn)發(fā)終端消息只在該業(yè)務(wù)成功時(shí)進(jìn)行，失敗時(shí)不應(yīng)轉(zhuǎn)發(fā)。其他終端上傳的消息不應(yīng)轉(zhuǎn)發(fā)?；A(chǔ)消息服務(wù)器端主發(fā)的消息所有服務(wù)器端主發(fā)的消息均要求客戶端應(yīng)答，應(yīng)答分為通用應(yīng)答和專(zhuān)門(mén)應(yīng)答，由各具體

58、功能協(xié)議決定。發(fā)送方等待應(yīng)答超時(shí)后，應(yīng)對(duì)消息進(jìn)行重發(fā)。應(yīng)答超時(shí)時(shí)間和重傳次數(shù)由服務(wù)器端參數(shù)指定，每次重傳后的應(yīng)答超時(shí)時(shí)間和重傳次數(shù)由服務(wù)器端參數(shù)指定，每次重傳后的應(yīng)答超時(shí)時(shí)間的計(jì)算公式見(jiàn)式(1): TN+1=TN(N+1) (1)式中： TN+1每次重傳后的應(yīng)答超時(shí)時(shí)間； TN 前一次的應(yīng)答超時(shí)時(shí)間；N 重傳次數(shù)?？蛻舳酥靼l(fā)的消息數(shù)據(jù)通信鏈路正常數(shù)據(jù)通信鏈路正常時(shí)，所有客戶端主發(fā)的消息均要求服務(wù)器端應(yīng)答，應(yīng)答分為通用應(yīng)答和專(zhuān)門(mén)應(yīng)答，由各具體功能協(xié)議決定?？蛻舳说却龖?yīng)答超時(shí)后，應(yīng)對(duì)消息進(jìn)行重發(fā)。應(yīng)答超時(shí)時(shí)間和重傳次數(shù)由客戶端參數(shù)指定，每次重傳后的應(yīng)答超時(shí)時(shí)間按式(1)進(jìn)行計(jì)算。對(duì)于客戶端發(fā)送的關(guān)

59、鍵報(bào)警消息，若達(dá)到重傳次數(shù)后仍未收到應(yīng)答，則應(yīng)對(duì)其進(jìn)行保存。以后在發(fā)送其它消息前要先發(fā)送保存的關(guān)鍵報(bào)警消息。數(shù)據(jù)通信鏈路異常數(shù)據(jù)通信鏈路異常時(shí)，客戶端應(yīng)對(duì)需發(fā)送的位置信息匯報(bào)消息進(jìn)行保存。在數(shù)據(jù)通信鏈路恢復(fù)正常后，立即發(fā)送保存的消息。消息數(shù)據(jù)格式客戶端通用應(yīng)答消息ID: 0 x0001?？蛻舳送ㄓ脩?yīng)答消息體數(shù)據(jù)格式見(jiàn)表B.6?？蛻舳送ㄓ脩?yīng)答消息體數(shù)據(jù)格式起始字節(jié)字段數(shù)據(jù)類(lèi)型描述及要求0應(yīng)答流水號(hào)WORD對(duì)應(yīng)的服務(wù)器端消息的流水號(hào)2應(yīng)答IDWORD對(duì)應(yīng)的服務(wù)器端消息的ID4結(jié)果BYTE0：成功/確認(rèn)；1：失?。?：消息有誤；3：不支持服務(wù)器端通用應(yīng)答消息ID：0X8001。服務(wù)器端通用應(yīng)答消息體

60、數(shù)據(jù)格式見(jiàn)表B.7。服務(wù)器端通用應(yīng)答消息體數(shù)據(jù)格式起始字節(jié)字段數(shù)據(jù)類(lèi)型描述及要求0應(yīng)答流水號(hào)WORD對(duì)應(yīng)的客戶端消息的流水號(hào)2應(yīng)答IDWORD對(duì)應(yīng)的客戶端消息的ID4結(jié)果BYTE0：成功/確認(rèn)；1：失敗；2：消息有誤；3：不支持客戶端心跳消息ID：0 x0002。客戶端在沒(méi)有正常業(yè)務(wù)消息的情況下應(yīng)按照參數(shù)設(shè)置的時(shí)間間隔定期向服務(wù)器端發(fā)送心跳消息以維持鏈路的連接，客戶端心跳消息體數(shù)據(jù)為空。補(bǔ)傳分包請(qǐng)求消息ID：0 x8003。補(bǔ)傳分包請(qǐng)求消息體數(shù)據(jù)格式見(jiàn)表B.8。補(bǔ)傳分包請(qǐng)求消息體數(shù)據(jù)格式起始字節(jié)字段數(shù)據(jù)類(lèi)型描述及要求0原始消息流水號(hào)WORD對(duì)應(yīng)要求補(bǔ)傳的原始消息第一包的消息流水號(hào)4重傳包總數(shù)B