智慧停車聯(lián)網(wǎng)技術(shù)要求及管理規(guī)范目??次前言 III范圍 1規(guī)范性引用文件 1術(shù)語和定義 1技術(shù)要求 2基本規(guī)定 2平臺功能 2接口清單 2交互方式 3基礎(chǔ)數(shù)據(jù)清單 4公共數(shù)據(jù)清單 4上下行接口 5上行接口 5下行接口 9管理要求 11I智慧停車聯(lián)網(wǎng)技術(shù)要求及管理規(guī)范范圍本文件對智慧停車聯(lián)網(wǎng)的術(shù)語與定義、技術(shù)要求、上下行接口和管理要求做出了規(guī)定。本文件適用于符合《機(jī)動車停車場管理辦法》要求的機(jī)動車停車場信息聯(lián)網(wǎng)接入及管理。規(guī)范性引用文件（包括所有的修改單適用于本文件。GB/T25068.1 信息技術(shù)安全技術(shù)IT網(wǎng)絡(luò)安全第1部分：網(wǎng)絡(luò)安全管理GB/T29745公共停車場（庫）信息聯(lián)網(wǎng)通用技術(shù)要求YD/T2248互聯(lián)網(wǎng)數(shù)據(jù)中心和互聯(lián)網(wǎng)接入服務(wù)信息安全管理系統(tǒng)技術(shù)要求YD/T2405互聯(lián)網(wǎng)數(shù)據(jù)中心和互聯(lián)網(wǎng)接入服務(wù)信息安全管理系統(tǒng)接口規(guī)范《機(jī)動車停車場管理辦法》（人民政府令〔2019〕第150號）術(shù)語和定義下列術(shù)語和定義適用于本文件。3.1智慧停車聯(lián)網(wǎng)各類機(jī)動車停車設(shè)施（包含經(jīng)營性、非經(jīng)營性停車場及道路臨時(shí)停車泊位）將停車信息接入智慧停車信息平臺。3.2智慧停車信息平臺用于整合機(jī)動車停車信息資源，按照本文件完成停車數(shù)據(jù)的接入、存儲、處理、交換和分發(fā)功能，3.3接入單元每一個(gè)機(jī)動車停車場或路內(nèi)臨時(shí)停車泊位管理單位的信息管理系統(tǒng)即為聯(lián)網(wǎng)接入信息平臺的一個(gè)接入單元。3.4上行接口接入單元向信息平臺上傳數(shù)據(jù)的接口。3.5下行接口1信息平臺下發(fā)數(shù)據(jù)給接入單元的接口。3.6過車記錄接入單元記錄的由進(jìn)出停車場車輛的車牌號、出入場時(shí)間、場內(nèi)泊位編號、出入口編號、抓拍圖片等內(nèi)容組成的數(shù)據(jù)信息。技術(shù)要求基本規(guī)定TCP、HTTP25068.1、YD/T2248、YD/T24059979520s。接入單元輸入傳輸應(yīng)滿足以下要求：傳輸格式要求：JSON；編碼格式要求：UTF-8；業(yè)務(wù)字段命名規(guī)范要求：小駝峰形式(如：deviceld)；產(chǎn)生的數(shù)據(jù)平均延時(shí)≤10s，丟包率≤0.2%、誤碼率≤0.2%；實(shí)時(shí)連接信息平臺，當(dāng)網(wǎng)絡(luò)連接斷開時(shí)，應(yīng)報(bào)警提醒；支持網(wǎng)絡(luò)異常情況下的數(shù)據(jù)補(bǔ)傳功能；數(shù)據(jù)傳輸過程中應(yīng)對數(shù)據(jù)進(jìn)行加密。TCP接入單元與信息平臺對接完成后，應(yīng)進(jìn)行對接系統(tǒng)測試，做好測試記錄。包括但不限于：對聯(lián)網(wǎng)接口內(nèi)容逐項(xiàng)進(jìn)行功能測試；對聯(lián)網(wǎng)接口程序進(jìn)行性能測試，保障接口程序無間斷運(yùn)行；對程序中斷時(shí)的數(shù)據(jù)回傳功能進(jìn)行測試。平臺功能信息平臺具備資源數(shù)據(jù)管理和統(tǒng)計(jì)、信息資源目錄以及備案信息管理等機(jī)動車停車資源管理功能，應(yīng)滿足對機(jī)動車停車信息的匯聚和存儲，并支持停車管理與服務(wù)。信息平臺負(fù)責(zé)采集停車場信息，并對采集的數(shù)據(jù)進(jìn)行存儲、處理、統(tǒng)計(jì)分析，通過移動終端應(yīng)用、網(wǎng)站等多種方式為政府、停車場經(jīng)營者、公眾提供信息服務(wù)。接口清單接入單元的接口清單見表1。2表1接口清單編號請求方向接口名稱支持協(xié)議方向?qū)崿F(xiàn)要求1接入單元上傳至信息平臺停車場登錄TCP上行2停車場剩余泊位數(shù)上報(bào)HTTP上行3停車場過車記錄上報(bào)HTTP上行4充電樁信息上報(bào)HTTP上行5無感支付請求HTTP上行6錯(cuò)峰共享泊位開通/取消HTTP上行7預(yù)訂泊位開通/取消HTTP上行8協(xié)同追繳開通/取消HTTP上行9電子支付請求HTTP上行10車輛無感狀態(tài)查詢HTTP上行11電子支付對賬HTTP上行12信息平臺下傳至接入單元連接狀態(tài)檢查TCP下行13共享泊位訂單下發(fā)TCP下行14預(yù)訂泊位訂單下發(fā)TCP下行15車主簽約/解約狀態(tài)下發(fā)TCP下行16支付結(jié)果下發(fā)TCP下行交互方式HTTPHTTP協(xié)議調(diào)用信息平臺接口上傳數(shù)據(jù)。各接入單元上傳數(shù)據(jù)時(shí)，上傳的信息中應(yīng)包含簽名信息，簽名算法如下：為支持參數(shù)擴(kuò)展，接入單元應(yīng)使用算法將待簽名參數(shù)排序，不宜硬拼接參數(shù)順序；az&”符號拼接：param1=value1¶m2=value2&……其次將接入單元簽名密鑰增加“&”附加到待簽名字符串后，按指定簽名算法進(jìn)行運(yùn)算。假設(shè)strToSignmerkeysha256strToSign&merkeybytebyte16示例：{"version":"1.0","charset":"UTF-8","sign":"ABCDAEEDDDFA","reqData":{"param1":"value1","param2":"value2","dateTime":"20160622182921"}3}待簽名字符串（不包含接入單元密鑰）為：dateTime=20160622182921¶m1=value1¶m2=value2TCP基礎(chǔ)數(shù)據(jù)清單基礎(chǔ)數(shù)據(jù)清單適用于本文件中所有的數(shù)據(jù)接口?；A(chǔ)數(shù)據(jù)清單見表2。表2基礎(chǔ)數(shù)據(jù)清單類型名稱長度（字符長度）基礎(chǔ)類型(json)描述StringNString字符串Long8Number長整型Int4Number整型Boolean1Boolean布爾型Float4Number浮點(diǎn)型Double8Number雙精度浮點(diǎn)Decimal16Number高精度浮點(diǎn)Date10String日期格式“yyyy-MM-dd”DateTime19String日期時(shí)間格式“yyyy-MM-ddHH:mm:ss"Time8String時(shí)間格式“HH:mm:ss”Timestamp4Number時(shí)間戳1970-01-0100:00:00起的秒數(shù)Uuid32String全球唯一IDOjbectNObject對象ListNArray數(shù)組公共數(shù)據(jù)清單請求數(shù)據(jù)清單請求數(shù)據(jù)清單適用于本文件中的所有上行接口。請求數(shù)據(jù)清單見表3。表3請求數(shù)據(jù)清單屬性名稱數(shù)據(jù)類型長度必須說明timestamp時(shí)間戳Timestamp是charset參數(shù)編碼String是固定為“UTF-8”sign簽名String是vesion版本號String是1.0data請求數(shù)據(jù)List<Object>是根據(jù)接口不同請求數(shù)據(jù)不同示例：{"timestamp":125555556621,"sign":"3535346546be81f014d9beb8098765",4“verison”: "1.0","charset": "data":[{"id":"ff8080814d9be81f014d9beb81090003","placeCode":"A001","parkCode":"p001","placeType":"1","areaName":"A區(qū)","floor":"負(fù)1樓","rStatus":0}]}應(yīng)答數(shù)據(jù)清單應(yīng)答數(shù)據(jù)清單適用于本文件中的所有上行數(shù)據(jù)接口。應(yīng)答數(shù)據(jù)清單見表4。表4應(yīng)答數(shù)據(jù)清單參數(shù)類型是否必填描述charsetString是參數(shù)編碼，固定為“UTF-8”versionString是1.0signString是報(bào)文簽名，對reqData內(nèi)的數(shù)據(jù)進(jìn)行簽名rspDataString是響應(yīng)數(shù)據(jù)codeString是處理結(jié)果返回碼，其它：請求處理失敗messageString是處理結(jié)果返回碼的描述信息signalDataobject是單條數(shù)據(jù)返回上下行接口上行接口5。表5停車場登錄信息表屬性名稱數(shù)據(jù)類型長度必須說明parkCode停車場編號String64是6。5表6泊位信息表屬性名稱類型長度必須說明parkCode停車場編號String64是inSpace己占泊位數(shù)量Int是restSpace空閑泊位數(shù)量Int是totalSpace總泊位數(shù)Int是timestamp上報(bào)時(shí)間戳Timestamp是7。表7過車記錄信息表屬性名稱數(shù)據(jù)類型長度必須說明orderNo訂單編號String64是唯一訂單編號carPlate車牌號String20是carType車輛類型int否小型車、大型車、非機(jī)動車direction方向String20是入場、出場inGateId入場通道編號String64否inPassTime入場時(shí)間dateTime是inPassPic入場圖片String否入場圖片Base64編碼outGateId出場通道編號String64否outPassTime出場時(shí)間dateTime是outPassPic出場圖片String否出場圖片Base64編碼parkCode停車場編號String64是carportNo泊位號String64否為路內(nèi)臨時(shí)泊位時(shí)必填parkTime停車時(shí)長Int否以分鐘為單位billAmount應(yīng)收金額bigdecimal否以元為單位，保留兩位小數(shù)，出場時(shí)必填couponAmount優(yōu)惠金額bigdecimal否以元為單位，保留兩位小數(shù)payAmount實(shí)收金額bigdecimal否以元為單位，保留兩位小數(shù)，，出場時(shí)必填payOffline現(xiàn)金收費(fèi)金額bigdecimal否以元為單位，保留兩位小數(shù)，，出場時(shí)必填payOnline電子收費(fèi)金額bigdecimal否以元為單位，保留兩位小數(shù)，，出場時(shí)必填tradeStatus訂單狀態(tài)String20是“IN_PARK”：在場“PRE_CREATE”：預(yù)付費(fèi)“NO_COMPLETE”:“欠費(fèi)離場”“CREATE”：完成支付離場,“SETTLE”：已完成對賬,“INVALID”:作廢payTime支付時(shí)間dateTime否payChannel支付渠道String20否現(xiàn)金、微信、支付寶、無感支付等，出場時(shí)必填noPassowordChannel無感支付渠道String20否當(dāng)payChannel為“NOPARSSWORD”時(shí)必填6表7（續(xù)）屬性名稱數(shù)據(jù)類型長度必須說明carStatus車輛出入場身份String20是共享車輛，預(yù)約車輛等isImmediately是否為實(shí)時(shí)數(shù)據(jù)int是1：實(shí)時(shí)數(shù)據(jù)，2斷網(wǎng)續(xù)傳數(shù)據(jù)8。表8充電樁使用狀態(tài)參數(shù)名稱數(shù)據(jù)類型長度是否必填描述parkCode停車場編號String64是chargeTotal充電樁總量Int4是chargeInSpace可用充電樁泊位數(shù)Int4是timestamp時(shí)間戳Timestamp是9。表9無感支付信息表參數(shù)名稱數(shù)據(jù)類型長度是否必填描述parkCode停車場編號String64是parkTime停車時(shí)長int是（以分鐘為單位）billAmount應(yīng)收金額bigdecimal是payAmount實(shí)際需要支付金額bigdecimal是orderNo客戶訂單編號String64是carPlate車牌號String20是parkName停車場名稱String255否InPassTime車輛入場時(shí)間DateTime是outPassTime車輛出場時(shí)間DateTime是remark備注信息String255需要特殊說明的信息接入單元可選擇向信息平臺申請電子支付，信息平臺接收到電子支付請求后生成支付二維碼，10。表10電子支付請求信息表屬性名稱數(shù)據(jù)類型長度必須說明parkCode停車場編號String64是carPlate車牌號String10是amount需要支付的金額Bigdecimal是保留兩位小數(shù)carportNo泊位編號String20否orderNo訂單編號String64是過車時(shí)上傳的記錄編號，供對賬使用gateId車道編號String64否接入單元可選擇將共享泊位申請信息上傳至信息平臺，通過信息平臺實(shí)現(xiàn)泊位共享。共享泊位開通/11。7表11共享泊位開通/取消信息表參數(shù)名稱數(shù)據(jù)類型長度是否必填描述productType服務(wù)編碼String20是固定傳值SHAREparkCode停車場編號String64是price價(jià)格Bigdecimal是保留兩位小數(shù)interval可用時(shí)段String20是Month:月Quarter：季度Year:年validDateType可用時(shí)間類型String20是工作日、周末、節(jié)假日等validTimeStart可用時(shí)段開始時(shí)間DateTime是服務(wù)可用開始時(shí)間validTimeEnd可用時(shí)段接收時(shí)間DateTime是服務(wù)可用結(jié)束時(shí)間canBuyTimeStart可銷售開始時(shí)間DateTime是canBuyTimeEnd可銷售結(jié)束時(shí)間DateTime是carportNo泊位號String20是當(dāng)為多個(gè)泊位時(shí)使用逗號隔開type操作類型String20是ADD:新增UPDATE:更新CANCEL:取消accountNo收款賬戶String64否用于收取共享收入分成accountType收款賬戶類型String64否微信、支付寶、銀行等carType車輛類型String20否大型車、小型車等remark備注信息String255否額外描述信息接入單元可選擇將預(yù)訂泊位申請信息上傳至信息平臺，通過信息平臺實(shí)現(xiàn)泊位預(yù)定。預(yù)定泊位服務(wù)開通/12。表12預(yù)定泊位服務(wù)開通/取消信息表參數(shù)名稱數(shù)據(jù)類型長度是否必填描述productType服務(wù)編碼String10是固定傳值BOOKparkCode停車場編號String64是price服務(wù)價(jià)格Bigdecimal是保留兩位小數(shù)interval可用間隔String20是Month:月Quarter：季度Year:年validDateType可用時(shí)間類型String20是工作日、周末、節(jié)假日等validTimeStart可用時(shí)段開始時(shí)間DateTime是服務(wù)可用開始時(shí)間validTimeEnd可用時(shí)段接收時(shí)間DateTime是服務(wù)可用結(jié)束時(shí)間canBuyTimeStart可銷售開始時(shí)間DateTime是canBuyTimeEnd可銷售結(jié)束時(shí)間DateTime是8表12（續(xù)）參數(shù)名稱數(shù)據(jù)類型長度是否必填描述carportNo泊位號String20否預(yù)約指定泊位時(shí)必填，當(dāng)為多個(gè)泊位時(shí)使用逗號隔開。bookCarportkNo可供預(yù)約的泊位數(shù)量int是type操作類型String20是ADD:開通UPDATE:更新CANCEL:取消accountNo收款賬戶String64否用于收取預(yù)約收入分成accountType收款賬戶類型String64否remark備注信息String255否額外描述信息接入單元可選擇將車輛無感簽約狀態(tài)查詢信息上傳至信息平臺。車輛無感簽約狀態(tài)查詢信息見13。表13車輛無感簽約狀態(tài)查詢屬性名稱數(shù)據(jù)類型長度必須說明parkCode停車場編號String64是carPlate車牌String20是/取消信息見表14。表14協(xié)同追繳開通/取消信息表屬性名稱數(shù)據(jù)類型長度必須說明parkCode停車場編號String64是type業(yè)務(wù)類型String20是期望追繳、協(xié)同追繳等status狀態(tài)String20是開通、取消接入單元可選擇向信息平臺申請電子支付信息對賬信息。電子支付對賬信息表15電子支付對賬信息表屬性名稱類型長度必須說明parkCode停車場編號Uuid64是carPlate車牌String20否當(dāng)需要查詢某張查詢車量的賬單請求時(shí)需要orderNo訂單編號String64否車場請求電子支付訂單編號checkBillTime對賬時(shí)間String20是示例2020-12-07下行接口信息平臺以固定時(shí)間間隔向接入單元下發(fā)連接狀態(tài)檢查信息。停車場連接狀態(tài)檢查信息見表16。9表16停車場連接狀態(tài)檢查信息表屬性名稱類型長度必須說明parkCode停車場編號Uuid64是messageType消息類型String20是固定值PING車主選擇在信息平臺開通電子支付服務(wù)時(shí)，信息平臺將支付結(jié)果信息下發(fā)至接入單元。支付結(jié)17。表17支付結(jié)果下發(fā)信息表屬性名稱數(shù)據(jù)類型長度必須說明parkCode停車場編號String64是carPlate車牌號String20是orderNo訂單編號String64是請求計(jì)費(fèi)的訂單編號passRecodeNo過車記錄編號String64否payChannel支付渠道String24是微信、支付寶、銀行卡等account支付金額Bigdecimal是discountAmt優(yōu)惠金額Bigdecimal否payOrderId支付訂單編號String64是供對賬使用payTime支付時(shí)間Datetime是車主選擇在信息平臺開通共享泊位服務(wù)時(shí)，信息平臺將共享泊位訂單信息下發(fā)至接入單元。共18。表18共享泊位訂單下發(fā)信息表參數(shù)名稱數(shù)據(jù)類型長度是否必填描述orderNo共享訂單編號String64是parkCode停車場編號String64是carPlate車牌號String20是carportNo共享泊位編號String20是shareStartTime共享生效時(shí)間dateTime是shareEndTime共享結(jié)束時(shí)間dateTime是sharePay共享支付金額bigDecimal否保留兩位小數(shù)state共享訂單狀態(tài)Int是1：開通；2取消車主選擇在信息平臺開通預(yù)訂泊位服務(wù)時(shí)，信息平臺將預(yù)訂泊位訂單信息下發(fā)至接入單元。預(yù)19。表19預(yù)定泊位訂單下發(fā)信息表屬性名稱數(shù)據(jù)類型長度必須說明orderNo預(yù)訂訂單編號String64是唯一識別碼parkCode停車場編號String64是garageCode車庫編號String20否bookCode預(yù)訂泊位編號String20否10表