1、PAGE 廣州市機動車駕駛員計時培訓系統技術規范和廣州市學駕平臺監管要求 PAGE I目錄 TOC t 前言、引言標題,1,參考文獻、索引標題,1,章標題,1,參考文獻,1,附錄標識,1 前言 PAGEREF _Toc500754856 h I1 范圍 PAGEREF _Toc500754857 h 12 規范性引用文件 PAGEREF _Toc500754858 h 13 術語、定義和縮略語 PAGEREF _Toc500754859 h 14 平臺接口技術要求 PAGEREF _Toc500754860 h 25 平臺性能要求 PAGEREF _Toc500754861 h 3附錄A （規

2、范性附錄） 數據交換HTTP接口協議 PAGEREF _Toc500754862 h 5前言本規范是根據交通運輸部2013年第49號公告機動車駕駛員計時培訓系統平臺技術規范、機動車駕駛員計時培訓系統計時終端技術規范以及廣州市駕培行業的實際監管要求進行制定。注：本規范會根據管理部門要求不定時更新，請及時查看。本規范起草單位：廣州軍軟科技有限公司 PAGE 50機動車駕駛員計時培訓系統和廣州市學駕服務平臺監管系統技術規范范圍本規范規定了廣州市駕駛員培訓機構自主建設的機動車駕駛員培訓計時平臺與管理部門建設的廣州市學駕平臺監管服務系統的功能要求、平臺接口技術要求、平臺安全與運行環境要求、數據交換HTT

3、P接口協議和實時傳輸TCP接口協議要求。本規范適用于駕駛員培訓機構建設、管理和運維計時培訓管理系統以及管理部門建設、管理和運維駕駛培訓監管服務平臺，是機動車駕駛員培訓機構開展計時培訓及道路運輸管理機構實施計時培訓管理和服務的基礎。規范性引用文件下列文件對于本文件的應用是必不可少的。凡是注日期的引用文件，僅所注日期的版本適用于本文件。凡是不注日期的引用文件，其最新版本（包括所有的修改單）適用于本文件。GB/T2260 中華人民共和國行政區劃代碼GB/T30340 機動車駕駛員培訓機構資格條件JT/T 415-2006 道路運輸電子政務平臺編目編碼規則JT/T 697.1-2013 交通信息基礎數

4、據元-第1部分:總則JT/T 808 道路運輸車輛衛星定位系統終端通訊協議及數據格式中華人民共和國道路運輸條例GB/T 30340-2013中華人民共和國國家標準（機動車駕駛培訓機構資格條件）GB/T 30340-2013中華人民共和國國家標準（機動車駕駛培訓教練場技術要求）JT/T325-2006中華人民共和國交通行業標準 機動車駕駛員培訓管理規定（交通部2016年第51號）關于印發機動車駕駛培訓教學與考試大綱的通知（交運發2016年第128號）JT/T 414-2006 道路運政管理信息系統-信息結構體系JT/T 415-2006 道路運政管理信息系統-編目編碼規則關于做好機動車駕駛人培訓

5、考試制度改革工作的通知（公交管201650號）關于推進機動車駕駛人培訓考試制度改革意見的通知（國辦發201588號）關于強制推廣應用帶有衛星定位功能的汽車行駛記錄儀的通知（粵安監200969號）廣東省地方標準DB44/T 5782009 衛星定位汽車行駛記錄儀通用技術規范術語、定義和縮略語術語和定義廣州市學駕服務監管平臺 部署在駕駛培訓管理部門，對駕駛培訓機構計時培訓全過程進行監督和管理，并提供相關信息服務，能夠實現與其他信息系統數據共享與交換的平臺，簡稱監管服務平臺。駕駛員培訓機構計時培訓管理平臺 部署在機動車駕駛員培訓機構或者相關服務企，對學員計時培訓全過程進行管理和服務，并為相關管理部門

6、提供信息的平臺，以下簡稱計時平臺。駕駛員培訓計時終端 部署在機動車駕駛員培訓機構，用于采集和記錄車輛的位置、速度和運行狀態，學員的培訓階段、培訓起止時間、培訓里程等信息，以及學員和教練員的多媒體信息，并能通過通信網絡與計時平臺進行信息交互的設備，簡稱計時終端。按培訓類別不同，分為車載計時計程終端、理論計時終端和模擬計時終端。數據通信鏈路異常無線通信鏈路斷開，或暫時掛起(如通話過程中)。未前置注冊學員未在學駕平臺前置注冊。資料不規范企業提交的資料不符合規范配額不足企業招生配額不足。縮略語下列縮略語適用于本文件。TCP傳輸控制協議(Transmission Control Protocol)UDP

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

8、回信息格式應為：接收結果$結果描述$安全碼。其中接收結果的值為：0-成功；1-失敗。監管服務平臺接口要求接口方式基于HTTP協議的Restful Webservice通信全國駕培平臺、監管服務平臺、計時平臺之間，以及與行業其它業務系統和公安交通管理業務系統之間的數據交換接口應使用HTTP協議，服務端的接口方式應以Restful WebService方式提供，具體要求見附錄A。通信雙方采用JSON 格式進行數據傳輸。基于TCP協議的Socket通信監管服務平臺與計時平臺的衛星定位過程明細數據和學時過程明細數據接口應使用基于JT/T808基礎擴充的TCP協議，服務端的接口方式應以Socket方式提

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

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

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

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

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

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

15、dfg：安全員指紋；vehimg:教練車圖片；outletsimg:招生點照片；occupationimg:資格證書圖片；voiceprintimg:聲紋文件；epdfimg:電子培訓部分記錄表PDF文件；onlineimg:網絡遠程學習過程照片；classroom:課堂教學過程照片；simulation:模擬教學過程照片；video:視頻文件備注應答報文格式見表A.5：文件資料信息上傳應答報文格式序號元素名稱必選類型長度字段名稱描述及要求1errorcode是數值型V16返回碼2message是字符型V128提示信息3data是對象附加信息4id是數值型V16成功上傳的文件ID平臺間數據傳輸

16、接口培訓機構信息培訓機構信息接口備案培訓機構接口業務描述：用于計時平臺向廣州市學駕服務平臺備案培訓機構信息。接口定義見表A.6：備案培訓機構接口定義服務名InstitutionURL/institution? v=version&ts=timestamp&sign=sign_str&user=cert_snHTTP方法POST參數/表域備注請求報文格式見表A.7：備案培訓機構請求報文格式序號元素名稱必選類型長度字段名稱描述及要求1district是字符型F6區縣行政區劃代碼見GB/T 22602name是字符型V256培訓機構名稱填寫名稱全稱3shortname是字符型V128培訓機構簡稱填寫

17、簡稱4licnum是字符型F12經營許可證編號5licetime是字符型V64經營許可日期YYYYMMDD6business是字符型F20營業執照注冊號7creditcode否字符型F18統一社會信用代碼8address是字符型V512培訓機構地址9postcode是字符型F6郵政編碼10legal是字符型V64法人代表11contact是字符型V64聯系人12phone是字符型V32聯系電話13busiscope是字符型V8經營范圍下列編碼可多選，以英文逗號分隔：A1,A2,A3,B1,B2,C1,C2,C3,C4,C5,D,E,F,M,N,P14busistatus是字符型V8經營狀態經營

18、狀態定義如下：1:營業2:停業3:整改4:停業整頓5:歇業6:注銷9:其他15level是字符型V8分類等級1:一級2:二級3:三級16coachnumber是數值型V16教練員總數17grasupvnum是數值型V16考核員總數18safmngnum是數值型V16安全員總數19tracarnum是數值型V16教練車總數20classroom否數值型V16教室總面積單位：m221thclassroom否數值型V16理論教室面積單位：m222praticefield是數值型V16教練場總面積單位：m223roadallowcert是字符型F12道路經營許可證24passdept是字符型V32批準

19、機關25cardvilidity是字符型V10證件有效期YYYYMMDD26prvdcarddate是字符型V10發證日期YYYYMMDD27trainvhcltype是字符型F8培訓車型可多選，以英文逗號分隔：A1,A2,A3,B1,B2,C1,C2,C3,C4,C5,D,E,F,M,N,P28corptype是字符型F2企業類型單選：1:普通機動車駕駛員培訓2:道路運輸從業資格培訓3:機動車駕駛員培訓訓練場4:機動車駕駛員培訓教練場經營5:普通合伙29opendate是字符型V10開業日期YYYYMMDD應答報文格式如下表：備案培訓機構應答報文格式序號層級元素名稱約束類型長度描述取值說明1

20、1.1errorcode1數值型V16錯誤碼21.2message1字符型V128提示信息31.3data1對象附加信息41.3.1inscode1字符型V128培訓機構編號統一編號教練員信息接口備案教練員業務描述：用于計時平臺向廣州市學駕服務平臺備案教練員信息。圖片文件ID應先使用A5.3文件資料信息接口成功上傳圖片后獲得。接口定義見表A.9：備案教練員接口定義服務名CoachURL/coach? v=version&ts=timestamp&sign=sign_str&user=cert_snHTTP方法POST參數/表域備注請求報文格式見表A.10：備案教練員請求報文格式序號元素名稱必選

21、類型長度字段名稱描述及要求1inscode是字符型F16培訓機構編號統一編號2name是字符型V64姓名3sex是數值型V4性別1:男性;2:女性4idcard是字符型V128身份證號5mobile是字符型V32手機號碼6address否字符型V256聯系地址7photo是數值型V16照片文件ID成功上傳的教練員頭像文件ID8fingerprint否數值型V16指紋圖片ID成功上傳的指紋圖片ID9drilicence是字符型V128駕駛證號10fstdrilicdate是字符型V64駕駛證初領日期YYYYMMDD11occupationno否字符型V128職業資格證號12occupationl

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

23、9position是字符型F1崗位可多選：1:理論教練員2:實操教練員20educationlevel是字符型F2學歷單選：1:博士,2:碩士,3:本科生,4:大專,5:中專,6:高中,7:初中21coachcert否字符型V32教練員證號應答報文格式如下表：備案教練員接口應答報文格式序號層級元素名稱約束類型長度描述取值說明11.1errorcode1數值型V16錯誤碼21.2message1字符型V128提示信息31.3data1對象附加信息41.3.1coachnum1字符型V128教練員編號統一編號教練車信息接口備案及修改教練車業務描述：用于計時平臺向廣州市學駕服務平臺備案教練車信息。圖

24、片文件ID應先使用A5.3文件資料信息接口成功上傳圖片后獲得。接口定義見表A.12：備案教練車接口定義服務名TrainingCarURL/trainingcar? v=version&ts=timestamp&sign=sign_str&user=cert_snHTTP方法POST參數/表域備注請求報文格式見表A.13：備案教練車請求報文格式序號元素名稱必選類型長度字段名稱描述及要求1inscode是字符型F16駕培編號統一編號2franum否字符型V32車架號3engnum否字符型V32發動機號4licnum是字符型V64車牌號5platecolor是字符型V64車牌顏色1:藍色2:黃色3:

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

26、16廠牌型號應答報文格式如下表：備案教練車接口應答報文格式序號層級元素名稱約束類型長度描述取值說明11.1errorcode1數值型V16錯誤碼21.2message1字符型V128提示信息31.3data1對象附加信息41.3.1carnum1字符型V128教練車編號統一編號培訓機構教學區域備案教學區域接口業務描述：用于計時平臺向廣州市學駕服務平臺備案培訓機構教學區域信息。接口定義見表A.15：備案教學區域接口服務名RegionURL/region? v=version&ts=timestamp&sign=sign_str&user=cert_snHTTP方法POST參數/表域備注請求報文格

27、式見表A.16：備案教學區域請求報文格式序號元素名稱必選類型長度字段名稱描述及要求1inscode是字符型F16培訓機構編號統一編號2seq是字符型V4教學區域編號計時平臺順序編號3name否字符型V256教學區域名稱4address是字符型V256教學區域地址5area是數值型V6教學區域面積單位:m26type是數值型V2教學區域類型1：第二部分；2：第三部分7vehicletype是字符型V256培訓車型下列編碼可多選，以英文逗號分隔A1,A2,A3,B1,B2,C1,C2,C3,C4,C5,D,E,F,M,N,P8polygon是字符型V1024多邊形坐標序列經度1，緯度1；經度2，緯

28、度2；經度3，緯度3；9totalvehnum否數值型V6可容納車輛數10curvehnum否數值型V6已投放車輛數應答報文格式：通用應答。計時終端信息接口備案計時終端業務描述：用于計時平臺向廣州市學駕服務平臺備案計時終端信息。接口定義見表A.17：備案計時終端接口定義服務名DeviceURL/device? v=version&ts=timestamp&sign=sign_str&user=cert_snHTTP方法POST參數/表域備注請求報文格式見表A.18：備案計時終端請求報文格式序號元素名稱必選類型長度字段名稱描述及要求1termtype是數值型V4計時終端類型1:車載計程計時終端2

29、:課堂教學計時終端3:模擬訓練計時終端2vender是字符串V128生產廠家3model是字符串V128終端型號4imei是字符型V128終端IMEI號或設備MAC地址5sn是字符型V128終端出廠序列號6inscode是字符型F16培訓機構編號統一編號，課堂教學和模擬訓練計時終端應上傳應答報文格式如下表：備案計時終端接口應答報文格式序號元素名稱約束類型長度描述取值說明1errorcode是數值型V128錯誤碼2message是字符型V128提示信息3data是對象附加信息4devnum是字符型V128終端編號統一編號5key是字符型V4096終端證書6passwd是字符型V12終端證書口令車

30、載計程計時終端綁定接口業務描述：用于計時平臺在車載計程計時終端安裝后，向廣州市學駕服務平臺上傳計時終端綁定教練車信息并進行備案。接口定義見表A.20：車載計程計時終端綁定接口定義服務名DevassignURL/devassign? v=version&ts=timestamp&sign=sign_str&user=cert_snHTTP方法POST參數/表域備注請求報文格式見表A.21：車載計程計時終端綁定請求報文格式序號元素名稱必選類型長度字段名稱描述及要求1devnum是字符型F16終端編號統一編號2carnum是字符型F16車輛編號統一編號3sim是字符型V16終端SIM卡號應答報文格式

31、：通用應答。車載計程計時終端解綁接口業務描述：用于車載計程計時終端拆除或更換后，向廣州市學駕服務平臺上傳計時終端解除綁定教練車信息并進行備案。接口定義見表A.22：車載計程計時終端解綁接口定義服務名DevRembindingURL/devRembinding? v=version&ts=timestamp&sign=sign_str&user=cert_snHTTP方法POST參數/表域備注請求報文格式見表A.23：車載計程計時終端解綁請求報文格式序號元素名稱必選類型長度字段名稱描述及要求1devnum是字符型F16終端編號統一編號2carnum是字符型F16車輛編號統一編號3sim是字符型V

32、16終端SIM卡號應答報文格式：通用應答。學員培訓過程信息學員信息接口備案學員信息業務描述：用于計時平臺向廣州市學駕服務平臺備案學員信息。接口定義見表A.24：備案及修改學員接口定義服務名StudentURL/student? v=version&ts=timestamp&sign=sign_str&user=cert_snHTTP方法POST參數/表域備注請求報文格式見表A.25：備案及修改學員請求報文格式序號元素名稱必選類型長度字段名稱描述及要求1inscode是字符型F16培訓機構編號統一編號2stunum否字符型F16學員編號新增不傳 修改必傳3cardtype是字符型V4證件類型1:

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

34、準駕車型下列編碼單選：A1,A2,A3,B1,B2,C1,C2,C3,C4,C5,D,E,F,M,N,P16traintype是字符型V8申請車型下列編碼單選：A1,A2,A3,B1,B2,C1,C2,C3,C4,C5,D,E,F,M,N,P17applydate是字符型V64報名時間YYYYMMDD18registercode是字符型V16注冊碼19birthdate是字符型V64出生日期20cardtype2否字符型V4證件類型21:身份證2:護照3:軍官證4:其他21idcard2否字符型V128證件號222postcode否字符型V6郵政編號23cardaddress否字符型V256證

35、件地址24telephone否字符型V32固定電話25applyfrom否字符型V128申請來源1:本地,2:外地,3:外籍4:轉入,5:軍警,6:香港7:澳門,8:臺灣,9:使領館10:農機26applyaddress否字符型V128報名地點27contractnum否字符型V16協議編號28practicecoach否字符型V32實操教練29platenum否字符型V16車牌號30recruitprice否數值型F8招生價格31recordprice否數值型F8備案價格32ispoor是字符型V1是否貧困生1是0不是33istimer是字符型V1是否計時培訓學員1是0不是34areacod

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

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

38、接口成功上傳圖片后獲得。接口定義見表A.27：培訓學時接口定義服務名ClassRecordURL/classrecord? v=version&ts=timestamp&sign=sign_str&user=cert_snHTTP方法POST參數/表域備注請求報文格式見表A.28：培訓學時接口請求報文格式序號元素名稱必選類型長度字段名稱描述及要求1inscode是字符型F16培訓機構編號統一編號2stunum是字符型F16學員編號統一編號3coachnum是字符型F16教練員編號統一編號，遠程教育平臺不使用4carnum是字符型F16教練車編號統一編號，遠程教育平臺不使用5simunum是字符

39、型F16計時終端編號統一編號，遠程教育平臺不使用6platnum是字符型F5平臺編號計時平臺或遠程教育平臺編號7recnum是字符型F5電子教學日志編號平臺自主編號8subjcode是字符型F10課程編碼見A4.29photo1是字符型V32簽到照片相片文件1ID10photo2否字符型V32隨機照片相片文件2ID，從每15分鐘拍攝的照片中隨機選一張，超過15分鐘的教學必選11photo3是字符型V32簽退照片相片文件3ID12starttime是字符型V64培訓開始時間YYYYMMDDHHmmss13endtime是字符型V64培訓結束時間YYYYMMDDHHmmss14duration是字

40、符型V64培訓學時單位：min15mileage是數值型V16培訓里程單位：km，非實操時為016avevelocity是數值型V16培訓平均速度單位：km/h，非實操時為017coacmt否字符型V64教練員點評18total是數值型V6總累計學時單位：min19part1是數值型V6第一部分累計學時單位：min20part2是數值型V6第二部分累計學時單位：min21part3是數值型V6第三部分累計學時單位：min22part4是數值型V6第四部分累計學時單位：min23trainid是數值型V10課堂ID標識學員的一次培訓過程，計時平臺自行使用應答報文格式：通用應答。學時信息接口階段培

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

42、素名稱必選類型長度字段名稱描述及要求1inscode是字符型F16培訓機構編號統一編號2stunum是字符型F16學員編號統一編號3subject是數值型V8培訓部分1:第一部分；2:第二部分；3:第三部分；4:第四部分4totaltime是數值型V6培訓部分總學時單位：分鐘，本培訓部分實際完成的總學時，學員主動要求以及由于考核或考試不合格增加的學時也應上報5vehicletime是數值型V6實車教學學時單位：分鐘，本培訓部分實際完成的實車教學學時，第一、四部分時為06classtime是數值型V6課堂教學學時單位：分鐘，本培訓部分實際完成的課堂教學學時，第二、三部分時為07simulator

43、time是數值型V6模擬器教學學時單位：分鐘，本培訓部分實際完成的模擬器教學學時，第一、四部分時為08networktime是數值型V6遠程教學學時單位：分鐘，本培訓部分實際完成的遠程教學學時，第二、三部分時為09duration是數值型V6培訓學時單位：分鐘，本次上報本培訓部分的初審總學時10examresult是數值型V4考核結果0:未考核；1:合格；2:不合格11mileage否數值型V6培訓里程非第三部分時可置“0”12pdfid否數值型V16電子培訓部分記錄表PDF文件ID計時平臺應使用13esignature是字符型V1024培訓機構電子簽章數據14rectype是數值型V4學時組

44、成1：實車教學；2：課堂教學；3：模擬器教學；4：遠程教學；5：混合15recarray是數組學時記錄編號數組實車教學時使用計時終端通過TCP協議上傳的學時記錄編號；課堂教學、模擬器教學、網絡遠程教學時使用學員編號+電子教學日志編號16rnum是字符型F26第1個學時記錄編號17rnum是字符型F26第n個學時記錄編號應答報文格式：通用應答。教練車進出場接口業務描述：用于計時平臺備案在教學區域進出場的教練車登記信息。接口定義見表A.31：教練車進出場接口定義服務名VehicleRecordURL/vehiclerecord? v=version&ts=timestamp&sign=sign_s

45、tr&user=cert_snHTTP方法POST參數/表域備注請求報文格式見表A.32：教練車進出場接口請求報文格式序號元素名稱必選類型長度字段名稱描述及要求1inscode是字符型F16培訓機構編號統一編號2seq是字符型V8教學區域編號3platenum是字符型F16車牌號6starttime是字符型V20進場時間YYYYMMDDHHmmss7endtime是字符型V64出場時間YYYYMMDDHHmmss應答報文格式：通用應答。平臺間數據通知接口消息通知審核結果消息通知接口業務描述：由計時平臺或遠程教育平臺提供，用于監管平臺在審核完成后向計時平臺或遠程教育平臺發送消息通知，計時平臺根據

46、審核類型調用相應的審核結果查詢接口。對遠程教育平臺的階段培訓記錄審核結果，監管平臺應分別通知計時平臺和遠程教育平臺。接口定義見表A.33：審核結果消息通知接口定義服務名ReviewmsgURL/reviewmsg? v=version&ts=timestamp&sign=sign_str&user=cert_snHTTP方法POST參數/表域備注請求報文格式見表A.34：審核結果消息通知請求報文格式序號元素名稱必選類型長度字段名稱描述及要求1reviewtype是字符型V4審核結果通知類型3：電子教學日志4：教學區域；2data是對象審核結果參數見表A.35、表A.36審核結果消息通知內容-教

47、學區域審核結果參數報文格式序號元素名稱必選類型長度字段名稱描述及要求1inscode是字符型F16培訓機構編號統一編號2seq是字符型V4教學區域編號計時平臺順序編號3name否字符型V256教學區域名稱4address是字符型V256教學區域地址5area是數值型V6教學區域面積單位:m26type是數值型V2教學區域類型1：第二部分；2：第三部分7vehicletype是字符型V256培訓車型下列編碼可多選，以英文逗號分隔A1,A2,A3,B1,B2,C1,C2,C3,C4,C5,D,E,F,M,N,P8polygon是字符型V1024多邊形坐標序列經度1，緯度1；經度2，緯度2；經度3，

48、緯度3；9totalvehnum否數值型V6可容納車輛數10curvehnum否數值型V6已投放車輛數11state是數值型V6狀態0:停用, 1：啟用審核結果消息通知內容-電子教學日志審核結果參數報文格式序號元素名稱必選類型長度字段名稱描述及要求1inscode是字符型F16培訓機構編號統一編號2stunum是字符型F16學員編號統一編號3recnum是字符型F5電子教學日志編號平臺自主編號4subject是數值型V8培訓部分1:第一部分；2:第二部分；3:第三部分；4:第四部分5duration是數值型V6審核合格學時本培訓部分本次的審核合格總學時，單位min6trainid是數值型V10

49、課堂ID標識學員的一次培訓過程，計時平臺自行使用應答報文格式：通用應答。（規范性附錄）實時傳輸TCP接口協議概述本附錄規定了計時終端與計時平臺、計時平臺或遠程教育平臺與監管服務平臺以及監管服務平臺與全國駕培平臺之間的實時傳輸通信協議與數據格式，包括協議基礎、通信連接、消息處理、協議分類與說明及數據格式。協議基礎通信方式協議采用的通信方式應符合JT/T 808中的相關規定，通信協議可采用TCP或UDP。用于計時終端與計時平臺通信時，平臺作為服務器端，終端作為客戶端，當數據通信鏈路異常時，終端可以采用SMS消息方式進行通信。用于計時平臺或遠程教育平臺與監管服務平臺之間的通信時，監管服務平臺作為服務

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

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

52、0 x55的數據包，則經過封裝如下:0 x7e 0 x30 7d 0 x02 0 x08 0 x7d 0 x01 0 x55 0 x7e。消息頭消息頭內容詳見表B.3。消息頭內容起始字節字段數據類型描述及要求0協議版本號BYTE協議標準的版本號，具體定義如下：0：JT/T 808-2011；1：北斗兼容車載終端通訊協議技術規范-2013；128：機動車駕駛員計時培訓系統平臺技術規范-2016；224-255：自定義；其他保留1消息IDWORD3 消息體屬性WORD消息體屬性格式結構圖見表B.45終端手機號BCD8根據安裝后終端自身的手機號轉換。手機號不足16位，則在前補充數字，大陸手機號補充數

53、字0港澳臺則根據其區號進行位數補充。平臺自身的業務消息使用自己的平臺編號，前補0 x00。13消息流水號WORD按發送順序從0開始循環累加15預留BYTE預留16消息包封裝項如果消息體屬性中相關標識位確定消息分包處理，則該項有內容，否則無該項消息體消息體屬性格式消息體屬性格式結構表見表B.4。消息體屬性格式結構表1514131211109876543210保留分包數據加密方式消息體長度數據加密方式數據加密方式定義如下:bit10-bit12為數據加密標識位；當此三位都為0時，表示消息體不加密；僅當第10位為1時，表示消息體經過RSA算法加密；其他保留。分包當消息體屬性中第13位為1時表示消息體

54、為長消息，進行分包發送處理，具體分包信息由消息包封裝項決定；若第13位為0，則消息頭中無消息包封裝項字段。消息包封裝項內容見表B.5。消息包封裝內容起始字節字段數據類型描述及要求0消息總包數WORD該消息分包后的總包數2包序號WORD從1開始校驗碼校驗碼指從消息頭開始，同后一字節異或，直到校驗碼前一個字節，占用一個字節。通信連接連接的建立用于計時終端與計時平臺通信時，數據日常連接可采用TCP或UDP方式。用于計時平臺或遠程教育平臺與監管服務平臺、監管服務平臺與全國駕培平臺之間的通信時，數據日常連接應采用TCP協議長連接方式。客戶端復位后應盡快與服務器端建立連接，連接建立后計時終端客戶端使用終端

55、鑒權消息進行鑒權，平臺客戶端使用平臺登錄請求消息進行登錄。連接的維持連接建立和客戶端鑒權成功后，在沒有正常業務數據包傳輸的情況下，客戶端應周期性向服務器端發送客戶端心跳消息，服務器端收到后向客戶端發送服務器端通用應答消息，發送周期由客戶端參數指定。連接的斷開服務器端和客戶端均可根據TCP協議主動斷開連接，雙方都應主動判斷TCP連接是否斷開。服務器端判斷TCP連接斷開的方法：收到客戶端的登出請求消息；根據TCP協議判斷出客戶端主動斷開；相同身份的客戶端建立新連接，表明原連接已斷開；在一定的時間內未收到客戶端發出的消息。客戶端判斷TCP連接斷開的方法：根據TCP協議判斷出服務器端主動斷開；數據通信

56、鏈路斷開；數據通信鏈路正常，達到重傳次數后仍未收到應答。分包消息消息的分包應在基本消息和擴展消息消息體組包全部完成后進行，按照每個分包的大小進行切包，不足一個分包大小的剩余數據放在最后一個分包中。分包完成后再根據分包內容生成相對應的消息頭，計算校驗碼，再進行轉義處理。消息采用分包發送時，其分包消息應采用連續遞增的流水號。對分包消息的應答，如果沒有專門的應答指令，則接收方應對每條分包消息采用一條通用應答，并使用結果字段（成功/失敗）告知發送方是否正確收到所有的分包消息。在未正確收到所有的分包消息時，接收方可采用補傳分包請求命令要求發送方重傳缺失的分包消息。發送方應采用原始消息將重傳包ID列表中的

57、分包重發一次，重傳分包與原始分包消息完全一致。轉發消息計時平臺在收到計時終端上傳的部分消息時，應首先應答終端，然后將終端上傳的消息不做任何修改直接轉發到監管服務平臺。對所有轉發的終端消息，監管服務平臺回復服務器端通用應答。計時平臺應轉發的終端消息包括：終端注冊、終端注銷、終端鑒權、位置匯報、教練員登錄、教練員登出、學員登錄、學員登出、上報學時記錄、照片上傳初始化、上傳照片數據包，以及對補傳分包請求消息的應答分包消息，轉發終端消息只在該業務成功時進行，失敗時不應轉發。其他終端上傳的消息不應轉發。基礎消息服務器端主發的消息所有服務器端主發的消息均要求客戶端應答，應答分為通用應答和專門應答，由各具體

58、功能協議決定。發送方等待應答超時后，應對消息進行重發。應答超時時間和重傳次數由服務器端參數指定，每次重傳后的應答超時時間和重傳次數由服務器端參數指定，每次重傳后的應答超時時間的計算公式見式(1): TN+1=TN(N+1) (1)式中： TN+1每次重傳后的應答超時時間； TN 前一次的應答超時時間；N 重傳次數。客戶端主發的消息數據通信鏈路正常數據通信鏈路正常時，所有客戶端主發的消息均要求服務器端應答，應答分為通用應答和專門應答，由各具體功能協議決定。客戶端等待應答超時后，應對消息進行重發。應答超時時間和重傳次數由客戶端參數指定，每次重傳后的應答超時時間按式(1)進行計算。對于客戶端發送的關

59、鍵報警消息，若達到重傳次數后仍未收到應答，則應對其進行保存。以后在發送其它消息前要先發送保存的關鍵報警消息。數據通信鏈路異常數據通信鏈路異常時，客戶端應對需發送的位置信息匯報消息進行保存。在數據通信鏈路恢復正常后，立即發送保存的消息。消息數據格式客戶端通用應答消息ID: 0 x0001。客戶端通用應答消息體數據格式見表B.6。客戶端通用應答消息體數據格式起始字節字段數據類型描述及要求0應答流水號WORD對應的服務器端消息的流水號2應答IDWORD對應的服務器端消息的ID4結果BYTE0：成功/確認；1：失敗；2：消息有誤；3：不支持服務器端通用應答消息ID：0X8001。服務器端通用應答消息體

60、數據格式見表B.7。服務器端通用應答消息體數據格式起始字節字段數據類型描述及要求0應答流水號WORD對應的客戶端消息的流水號2應答IDWORD對應的客戶端消息的ID4結果BYTE0：成功/確認；1：失敗；2：消息有誤；3：不支持客戶端心跳消息ID：0 x0002。客戶端在沒有正常業務消息的情況下應按照參數設置的時間間隔定期向服務器端發送心跳消息以維持鏈路的連接，客戶端心跳消息體數據為空。補傳分包請求消息ID：0 x8003。補傳分包請求消息體數據格式見表B.8。補傳分包請求消息體數據格式起始字節字段數據類型描述及要求0原始消息流水號WORD對應要求補傳的原始消息第一包的消息流水號4重傳包總數B