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