DB3401T 348-2024智慧停車(chē)綜合管理服務(wù)平臺(tái)數(shù)據(jù)接入規(guī)范

3401DataaccessspecificationforsmartparkingcomprehplatformI本文件按照GB/T1.1—2020《標(biāo)準(zhǔn)化工作導(dǎo)則第1部分：標(biāo)準(zhǔn)化文件的結(jié)構(gòu)和起草規(guī)則》的規(guī)定請(qǐng)注意本文件的某些內(nèi)容可能涉及專利。本文件的發(fā)布機(jī)構(gòu)不承擔(dān)識(shí)別專利的責(zé)任。有限公司、合肥市公安局交通警察支隊(duì)、安徽省停車(chē)服務(wù)行業(yè)協(xié)會(huì)、安徽標(biāo)跡科技有限公智慧停車(chē)綜合管理服務(wù)平臺(tái)數(shù)據(jù)接入規(guī)范本文件界定了智慧停車(chē)綜合管理服務(wù)平臺(tái)(以下簡(jiǎn)稱“平臺(tái)”)數(shù)據(jù)接入的術(shù)語(yǔ)和定義、縮略語(yǔ)，規(guī)定了基本要求、數(shù)據(jù)分類、數(shù)據(jù)接口和數(shù)據(jù)接入的內(nèi)容。本文件適用于指導(dǎo)停車(chē)場(chǎng)和技術(shù)服務(wù)商開(kāi)展停車(chē)數(shù)據(jù)接入平臺(tái)工作。2規(guī)范性引用文件下列文件中的內(nèi)容通過(guò)文中的規(guī)范性引用而構(gòu)成本文件必不可少的條款。其中，注日期的引用文件，僅該日期對(duì)應(yīng)的版本適用于本文件；不注日期的引用文件，其最新版本(包括所有的修改單)適用于本文件。GB/T29745公共停車(chē)場(chǎng)(庫(kù))信息聯(lián)網(wǎng)通用技術(shù)要求GB/T37373—2019智能交通數(shù)據(jù)安全服務(wù)GB/T42442.2—2024智慧城市智慧停車(chē)第2部分：數(shù)據(jù)要求GB/T42442.3智慧城市智慧停車(chē)第3部分：平臺(tái)技術(shù)要求GA/T1302停車(chē)服務(wù)與管理信息系統(tǒng)通用技術(shù)條件3術(shù)語(yǔ)和定義下列術(shù)語(yǔ)和定義適用于本文件。智慧停車(chē)綜合管理服務(wù)平臺(tái)smartparkingcomprehensivemanagementserviceplatform停車(chē)主管部門(mén)負(fù)責(zé)建設(shè)，對(duì)城市停車(chē)資源和信息開(kāi)展態(tài)勢(shì)感知、數(shù)據(jù)分析、運(yùn)營(yíng)調(diào)度、公共服務(wù)、監(jiān)督管理等工作的服務(wù)平臺(tái)。技術(shù)服務(wù)商technicalserviceproviders為停車(chē)場(chǎng)提供停車(chē)系統(tǒng)運(yùn)維服務(wù)，協(xié)助停車(chē)場(chǎng)將數(shù)據(jù)接入平臺(tái)的組織。4縮略語(yǔ)下列縮略語(yǔ)適用于本文件：——ID:身份標(biāo)識(shí)號(hào)(IdentityDocument)——UTF:統(tǒng)一碼轉(zhuǎn)換格式(UnicodeTransformationFormat)5基本要求5.1智慧停車(chē)綜合管理服務(wù)平臺(tái)5.1.1應(yīng)開(kāi)放接口，向合肥市停車(chē)場(chǎng)提供資源和服務(wù)的運(yùn)行數(shù)據(jù)接入。5.1.2應(yīng)具備對(duì)合肥市停車(chē)場(chǎng)統(tǒng)一備案的能力。工25.1.3數(shù)據(jù)安全應(yīng)參照GB/T37373—2019第6章執(zhí)行。5.2.1應(yīng)在平臺(tái)注冊(cè)，通過(guò)并獲得5.2.3應(yīng)接入互聯(lián)網(wǎng)，具備實(shí)現(xiàn)聯(lián)網(wǎng)5.2.4聯(lián)網(wǎng)接入應(yīng)符合GA/T1302和GB/T29745的要求。5.3.1應(yīng)在平臺(tái)注冊(cè)，通過(guò)并獲得5.3.4應(yīng)具備24h服務(wù)的能力，保障停車(chē)數(shù)據(jù)實(shí)時(shí)接入平臺(tái)。6.1停車(chē)場(chǎng)數(shù)據(jù)分類與數(shù)據(jù)元素按GB/T42442.2—2024的規(guī)定執(zhí)行。6.2宜根據(jù)平臺(tái)功能變化、停車(chē)場(chǎng)備案要求變化等調(diào)整接入數(shù)據(jù)的分7.1數(shù)據(jù)應(yīng)通過(guò)指定接口接入，接口清單見(jiàn)表1。表1接口清單0接口說(shuō)明方向圖片信息上報(bào)對(duì)賬日平臺(tái)訂單號(hào)查詢注：上行指第三方停車(chē)平臺(tái)作為發(fā)起方，發(fā)送數(shù)據(jù)至平7.2公共參數(shù)要求按GB/T42442.3的規(guī)定執(zhí)行。7.3車(chē)輛入場(chǎng)信息、車(chē)輛出場(chǎng)信息、圖片信息、停車(chē)余位數(shù)信息和停車(chē)場(chǎng)心跳信息的接口和參數(shù)要求按GB/T42442.3的規(guī)定執(zhí)行。7.4停車(chē)記錄日對(duì)賬接口請(qǐng)求參數(shù)見(jiàn)表2,停車(chē)記錄日對(duì)賬接口返回參數(shù)見(jiàn)表3。3參數(shù)說(shuō)明數(shù)據(jù)類型備案系統(tǒng)中停車(chē)場(chǎng)編碼(ID)是是格式為：2021-01-01是是參數(shù)說(shuō)明數(shù)據(jù)類型是返回消息是是7.5對(duì)賬日平臺(tái)訂單號(hào)查詢接口請(qǐng)求參數(shù)見(jiàn)表4,對(duì)賬日平臺(tái)訂單號(hào)查詢接口返回參數(shù)見(jiàn)表5。參數(shù)說(shuō)明數(shù)據(jù)類型備案系統(tǒng)中停車(chē)場(chǎng)編碼(ID)是是格式為：2021-01-01是常量定義在SDK的TyhConstants.DriveType中參數(shù)說(shuō)明數(shù)據(jù)類型是的order_id_list是7.6接口遵守Restful風(fēng)格定義，采用UTF-8編碼，所有訪問(wèn)ID都需要進(jìn)行加解密認(rèn)證。接口簽名加停車(chē)場(chǎng)的平臺(tái)注冊(cè)人員應(yīng)閱讀并同意《開(kāi)放平臺(tái)服務(wù)協(xié)議》,錄入注冊(cè)人員姓名、手機(jī)號(hào)和停車(chē)場(chǎng)的平臺(tái)注冊(cè)人員應(yīng)填報(bào)停車(chē)場(chǎng)運(yùn)營(yíng)單位信息，包括企業(yè)名稱、統(tǒng)一社會(huì)信用代碼、企技術(shù)服務(wù)商應(yīng)在平臺(tái)提交服務(wù)商資料注冊(cè)，注冊(cè)完成后獲得賬號(hào)、密碼等信息。停車(chē)場(chǎng)應(yīng)在平臺(tái)按填報(bào)要求提交靜態(tài)數(shù)據(jù)完成停車(chē)場(chǎng)備案，靜態(tài)數(shù)據(jù)包括企業(yè)認(rèn)證信息、停備案資料。應(yīng)提交的靜態(tài)數(shù)據(jù)見(jiàn)附錄B。停車(chē)場(chǎng)主管部門(mén)對(duì)靜態(tài)數(shù)據(jù)進(jìn)行審核，審核通過(guò)后，平臺(tái)生成停車(chē)場(chǎng)編碼；審核未通過(guò)，平已通過(guò)審核的停車(chē)場(chǎng)發(fā)生靜態(tài)數(shù)據(jù)信息發(fā)生變化時(shí)，應(yīng)登錄平臺(tái)進(jìn)行修改并提交審核。備案信息提交后，平臺(tái)自動(dòng)為停車(chē)場(chǎng)生成唯一停車(chē)場(chǎng)編碼。停車(chē)場(chǎng)編碼為13位數(shù)字編碼，由行政區(qū)代碼+平臺(tái)代碼+備案數(shù)代碼組成，行政區(qū)代碼為1~6位，平臺(tái)代碼為7～8位，備案數(shù)代碼為9～13位。8.2動(dòng)態(tài)數(shù)據(jù)接入已備案的停車(chē)場(chǎng)，在平臺(tái)備案系統(tǒng)中停車(chē)場(chǎng)基本信息頁(yè)面，點(diǎn)擊開(kāi)通數(shù)據(jù)對(duì)接選項(xiàng)，選擇當(dāng)技術(shù)服務(wù)商進(jìn)行對(duì)接調(diào)試，訪問(wèn)平臺(tái)查看接口文檔，獲取申請(qǐng)對(duì)接的停車(chē)場(chǎng)編碼信息，按照接口要求進(jìn)行數(shù)據(jù)對(duì)接，調(diào)試必傳接口(停車(chē)入場(chǎng)、出場(chǎng)、圖片、余位、心跳、對(duì)賬數(shù)據(jù))。必傳接口各有一次成功上傳數(shù)據(jù)記錄為對(duì)接成功。停車(chē)場(chǎng)動(dòng)態(tài)數(shù)據(jù)自動(dòng)接入平臺(tái)，接入數(shù)據(jù)包括車(chē)輛入場(chǎng)信息、車(chē)輛出場(chǎng)信息、圖片信息、停技術(shù)服務(wù)商應(yīng)監(jiān)測(cè)、保持?jǐn)?shù)據(jù)接入的持續(xù)性和及時(shí)性，應(yīng)對(duì)平臺(tái)反饋的數(shù)據(jù)異常及時(shí)處理。技術(shù)服務(wù)商應(yīng)保持停車(chē)數(shù)據(jù)接入在線，——車(chē)輛入場(chǎng)數(shù)據(jù)：入場(chǎng)時(shí)間與平臺(tái)入庫(kù)時(shí)間差距小于10s的記錄數(shù)占當(dāng)日入場(chǎng)記錄數(shù)的90%以——車(chē)輛離場(chǎng)數(shù)據(jù)：離場(chǎng)時(shí)間與平臺(tái)入庫(kù)時(shí)間差距小于10s的記錄數(shù)占當(dāng)日離場(chǎng)記錄數(shù)的90%以——心跳數(shù)據(jù)：當(dāng)日心跳記錄數(shù)超過(guò)90%(以每10min計(jì)則為115條);——圖片數(shù)據(jù)：當(dāng)日入場(chǎng)照片總數(shù)占車(chē)輛入場(chǎng)記錄數(shù)的90%及以上，出場(chǎng)照片總數(shù)的90%及以上；——對(duì)賬數(shù)據(jù)：前一日車(chē)輛入場(chǎng)離場(chǎng)數(shù)據(jù)已平賬(本地系統(tǒng)與平臺(tái)數(shù)據(jù)一致)。——圖片應(yīng)包含有機(jī)動(dòng)車(chē)前部(或后部)全貌、號(hào)牌、顏色、車(chē)型、顯著地理特征等；——疊加在每幅圖片上的信息至少應(yīng)包括車(chē)輛出、入場(chǎng)時(shí)間、號(hào)牌、車(chē)——無(wú)圖片，平臺(tái)納入數(shù)據(jù)準(zhǔn)確性校驗(yàn)范圍。數(shù)據(jù)管理應(yīng)符合GB/T42442.2—2024第10章的要求，數(shù)據(jù)存儲(chǔ)應(yīng)符合GB/T42442.2—2024第11章的要求。5(規(guī)范性)接口簽名加解密A.1私鑰示例-----BEGINPRIVATEKEY----------ENDPRIVATEKEY-----A.2參數(shù)信息示例A.3計(jì)算出參數(shù)信息Base64編碼示例請(qǐng)求Body變?yōu)椋?data":"eyJOb3RhbCI6IDEwMCwic3VycGxA.4按照J(rèn)SON對(duì)象的健值首字母遞增排序，拼接出字符串示例3401040030003465eyJOb3RhbCI6IDEwMCw對(duì)以上字符串進(jìn)行RSA簽名并進(jìn)行Base64輸出：A.5最終接口請(qǐng)求參數(shù)示例6"data":"eyJOb3RhbCI6IDEwMCwic3VycGx"2j9R91P6Uz/dhEeE98ajDjWWbpcmfrLAjlQVT6wfHqlzM/rG/eetEdUJu+TBXloNnMuWH3lrq8mx3161CRRe406ynTOE6TSz6ebakwdGOmRIkaObjuSVpsnX31jUVmJFlPFwMA2CsZjYj6f}7(規(guī)范性)靜態(tài)數(shù)據(jù)停車(chē)場(chǎng)應(yīng)填寫(xiě)提交的靜態(tài)數(shù)據(jù)見(jiàn)表B.1。表B.1靜態(tài)數(shù)