DB4401-T 133-2021 公共停車場管理系統(tǒng)+數(shù)據(jù)聯(lián)網(wǎng)技術(shù)規(guī)范-（高清現(xiàn)行）

ICS35.020CCSL70 DB4401廣 州 市 地 方 標 準DB4401/T133—2021公共停車場管理系統(tǒng)數(shù)據(jù)聯(lián)網(wǎng)技術(shù)規(guī)范Technicalspecificationofthepublicparkingmanagementsystemdatanetworkingdatanetworking2021-12152021-12-31廣州市市場監(jiān)督管理局發(fā)布DB4401/T133—2021DB4401/T133—2021DB4401/T133—2021DB4401/T133—2021目 次前言 Ⅲ范圍 1規(guī)范性引用文件 1術(shù)語和定義 1技術(shù)要求 1數(shù)據(jù)內(nèi)容 1協(xié)議框架 2身份認證 2停車場狀態(tài)信息數(shù)據(jù)采集 2停車場狀態(tài)信息上傳 3停車場狀態(tài)信息上傳的應(yīng)答 6停車位狀態(tài)信息數(shù)據(jù)采集 6停車位狀態(tài)信息上傳 6停車位狀態(tài)信息上傳的應(yīng)答 6車輛入場信息數(shù)據(jù)采集 7車輛入場記錄上傳 7車輛入場記錄上傳的應(yīng)答 7車輛出場信息數(shù)據(jù)采集 8車輛出場記錄上傳 8車輛入場記錄上傳的應(yīng)答 9停車場空位信息數(shù)據(jù)采集 9停車場空位信息記錄上傳 9停車場空位信息上傳的應(yīng)答 10道路泊位信息數(shù)據(jù)采集 10道路泊位路段狀態(tài)信息上傳 10道路泊位車輛出入場記錄上傳 12道路泊位實時狀態(tài)記錄上傳 13用戶登錄 1411.1登錄 1411.2登錄的應(yīng)答 14停車位預約共享服務(wù) 1512.1登錄 15服務(wù)預授權(quán) 15I訂單數(shù)據(jù)上傳 16系統(tǒng)要求 17功能模塊配置要求 17網(wǎng)絡(luò)傳輸要求 17IIII前 言GB/T1.1—20201本文件由廣州市交通運輸局提出并歸口。IIIIIIDB4401/T133—2021DB4401/T133—2021DB4401/T133—2021DB4401/T133—2021公共停車場管理系統(tǒng)數(shù)據(jù)聯(lián)網(wǎng)技術(shù)規(guī)范范圍本文件規(guī)定了公共停車場管理系統(tǒng)數(shù)據(jù)聯(lián)網(wǎng)的術(shù)語和定義、技術(shù)要求、停車場狀態(tài)信息數(shù)據(jù)采集、規(guī)范性引用文件（包括所有的修改單適用于本文件。GB18030—2005信息技術(shù)中文編碼字符集3術(shù)語和定義3術(shù)語和定義下列術(shù)語和定義適用于本文件。3.1公共停車場publicparking3.2公共停車場管理系統(tǒng)publicparkingmanagementsystem3.3廣州停車場行業(yè)管理系統(tǒng)Guangzhouparkingindustrymanagementsystem3.4城市道路臨時泊位temporaryparkingspacesoncityroads利用政府管理的城市道路設(shè)置供機動車臨時停放場所的道路停車泊位。4技術(shù)要求4.1數(shù)據(jù)內(nèi)容1公共停車場管理系統(tǒng)上傳的數(shù)據(jù)應(yīng)包含以下四種內(nèi)容：停車場狀態(tài)信息定時上傳，包括停車場收費標準數(shù)據(jù)等信息；停車位狀態(tài)信息定時上傳，根據(jù)車場或設(shè)備供應(yīng)商條件選擇性傳輸；c）d）停車場空位信息定時上傳，包括當前剩余空位等信息。道路泊位管理系統(tǒng)上傳的數(shù)據(jù)應(yīng)包含以下三種內(nèi)容：a）路段狀態(tài)信息定時上傳，包括路段收費標準數(shù)據(jù)等信息；b）車輛出入場信息即時上傳，包括車輛識別等信息；c）路段實時狀態(tài)信息上傳，包括停車位占用狀態(tài)等信息。協(xié)議框架通信協(xié)議通信協(xié)議應(yīng)符合下列要求：a）通信采用HTTP協(xié)議；b）請求方式采用結(jié)構(gòu)化數(shù)據(jù)（JSON）進行傳遞；c）漢字編碼采用GB18030—2005字符集。格式說明1。表1公共請求參數(shù)1。表1公共請求參數(shù)2。表2 通用響應(yīng)參數(shù)身份認證身份認證過程允許用戶使用平臺分配的用戶名和密碼來申請一個令牌，用于后續(xù)的接口訪問。5停車場狀態(tài)信息數(shù)據(jù)采集2名稱類型描述Authorizationstring訪問令牌，所有需要身份認證的接口都需要在請求頭中攜帶本參數(shù)。名稱類型描述resultObject返回數(shù)據(jù)successBoolean請求處理狀態(tài)errorObject異常或錯誤停車場狀態(tài)信息上傳停車場狀態(tài)信息上傳請求參數(shù)見表3。表3 停車場狀態(tài)信息上傳請求參數(shù)名稱類型描述必選ParkIDlong備案ID（停車場管理系統(tǒng)中該停車場的備案ID）是Namestring(256)名稱是Addr(Address)string(256)地址（詳細到門牌號）是Regionstring(12)行政區(qū)是RegionCodestring(8)行政區(qū)代碼是Streetstring(128)所屬街道是StreetCodestring(16)所屬街道代碼是Propertystring(128)停車場產(chǎn)權(quán)方是Munit(ManagementUnits)string(128)停車場管理單位（全稱）是Typeinteger類型（注）是Noen(Numberentrances)integer入口數(shù)是Noex(Numberofexits)integer出口數(shù)是Spaceinteger總停車位是Nosps(NumberofSpecialparkingSpaces)integer專用停車位數(shù)量（不可向公眾提供服務(wù)的停車位）是Noaps(NumberofAvailableparkingSpaces)integer可用停車位數(shù)量（可向公眾提供服務(wù)的停車位）是CSpace(ChargingSpace)integer新能源專用停車位數(shù)量是FCPile(FastChargingPile)integer充電樁數(shù)量（快充）是SCPile(SlowChargingPile)integer充電樁數(shù)量（慢充）是Cstat(ChargingStatus)boolean當前是否可充電是33表3停車場狀態(tài)信息上傳請求參數(shù)（續(xù)）名稱類型描述必選DSpace(Disabledparkingspaces)integer殘疾人停車位數(shù)是MecPi(Mechanicalparking)CollectionofMecParking（4械車庫結(jié)構(gòu)信息機械停車位信息否Coordsys(CoordinatesSystem)string(8)坐標系可選WGS84、GCJ02、BD09，后續(xù)可擴展。建議使用GCJ02（高德）。是PortalsCollectionofPortalInfo（見表5停車場出入口結(jié)構(gòu)信息）出入口位置（至少應(yīng)包含一個入口位置）是Rstat(ReservationStatus)boolean當前是否可預約是RSpace(ReservationSpace)integer可預約（共享）停車位數(shù)是OpeningHoursstring(256)營業(yè)時間是ROpeningHoursstring(256)預約（共享）開放時間是ChargingPeriodsCollectionofChargingPeriod（6費時段結(jié)構(gòu)信息）收費時段和規(guī)則是ExtraPropertiesJSON擴展屬性（使用結(jié)構(gòu)化的json對象來拓展更多上傳信息）否注：61：122：123第3位數(shù)字為空間類型：1地面、2地下、3兩者均有；第4位數(shù)字為泊位類型：1自走式、2機械式、3兩者均有；560102030405060708101112（如：122105該字段后續(xù)可擴展。44表表6 停車場收費時段結(jié)構(gòu)信息表7 停車場收費規(guī)則結(jié)構(gòu)信息5表4 停車場機械車庫結(jié)構(gòu)信息名稱類型描述必選Mplnum(MechanicalparkinglotNo.)string(128)機械車庫編號是Mplname(MechanicalparkinglotName)string(32)機械車庫名稱是Manufacturerstring(32)制造商是Spaceinteger總停車位是typestring(16)機械車庫類型（升降橫移、垂直升降等）是表5 停車場出入口結(jié)構(gòu)信息名稱類型描述必選addrstring(256)出入口地址（或名稱）是coordinatesCollectionofdouble經(jīng)緯度是typestring(12)類型（入口、出口、出入口）是streetstring(64)連接道路名稱是名稱類型描述必選Startinteger開始時間，距0點的分鐘整數(shù)形式，如凌晨2點設(shè)置為120是Endinteger截止時間，同上是RulesCollectionofChargingRule（見表7）收費規(guī)則是名稱類型描述必選DurStartinteger開始停車時長（分鐘）是DurEndinteger截止停車時長（分鐘），-1為無限大是Pricedecimalnumber單位價格（元/計費跨度）是Spaninteger計費跨度（分鐘），0為每次是停車場狀態(tài)信息上傳的應(yīng)答使用通用響應(yīng)，返回停車場主鍵ID。停車位狀態(tài)信息數(shù)據(jù)采集停車位狀態(tài)信息上傳停車位狀態(tài)信息上傳請求參數(shù)見表8。表8 停車位狀態(tài)信息上傳請求參數(shù)名稱類型描述必選ParkIDlong停車場ID（停車場管理系統(tǒng)備案ID）是SpacesCollectionSpaceInfo（9）詳細停車位信息是表9 停車位信息結(jié)構(gòu)信息名稱類型描述必選SpaceIDstring(128)停車位編號（停車位所在的分區(qū)分層信息需要在該字段體現(xiàn)）是Topr(Typesofpropertyrights)string(8)產(chǎn)權(quán)類型（個人、單位、其他）是Cableboolean是否是充電停車位是Rableboolean是否是可預約（共享）停車位是Ostatinteger占用狀態(tài)01是Cstatinteger充電狀態(tài)01否Cpn(Chargingpilenumber)string(64)充電樁編號否Rstatinteger預約（共享）01該字段后續(xù)可擴展否Lpnstring(32)停泊車牌號碼否6.2停車位狀態(tài)信息上傳的應(yīng)答6.2停車位狀態(tài)信息上傳的應(yīng)答6使用通用響應(yīng)。車輛入場信息數(shù)據(jù)采集車輛入場記錄上傳車輛入場記錄上傳請求參數(shù)見表10。表10車輛入場記錄上傳請求參數(shù)名稱類型描述必選ParkIDlong備案ID（停車場管理系統(tǒng)中該停車場的備案ID）是DataProviderIdstring(64)停車場主鍵ID是Norps(Numberofparkingspaces)integer剩余停車位是Noops(Numberofparkingspaces)integer已占用停車位是Nopsrafc(Numberofparkingspacesremainingavailableforcharging)integer剩余的可供充電停車位數(shù)量是Noopsafc(Numberofoccupiedparkingspacesavailableforcharging)integer已占用的可供充電停車位數(shù)量是Nopsrfr(Numberofparkingspacesremainingforreservations)integer剩余可供預約（共享）的停車位數(shù)量是Noopsfr(Numberofoccupiedparkingspacesforreservations)integer已占用的可供預約（共享）的停車位數(shù)量是EntryTimeDate(string)入場時間是Lpn(Licenseplatenumber)string(32)車牌號碼A88888（藍）)是EntryWaystring(16)入場方式（自動識別、取卡、人工等）否7.2車輛入場記錄上傳的應(yīng)答7.2車輛入場記錄上傳的應(yīng)答7使用通用響應(yīng)。車輛出場信息數(shù)據(jù)采集車輛出場記錄上傳車輛出場記錄上傳請求參數(shù)見表11。表11車輛出場記錄上傳請求參數(shù)名稱類型描述必選ParkIDlong備案ID（停車場管理系統(tǒng)中該停車場的備案ID）是DataProviderIdstring(64)停車場主鍵ID是SpaceIDstring(128)停泊的停車位編號否Norps(Numberofremainingparkingspaces)integer剩余停車位是Noops(Numberofoccupiedparkingspaces)integer已占用停車位是Nopsrafc(Numberofparkingspacesremainingavailableforcharging)integer剩余的可供充電停車位數(shù)量是Noopsafc(Numberofoccupiedparkingspacesavailableforcharging)integer已占用的可供充電停車位數(shù)量是Nopsrfr(Numberofparkingspacesremainingforreservations)integer剩余可供預約（共享）的停車位數(shù)量是Noopsfr(Numberofoccupiedparkingspacesforreservations)integer已占用的可供預約（共享）的停車位數(shù)量是EntryTimeDate(string)入場時間是ExitTimeDate(string)出場時間是88表11車輛出場記錄上傳請求參數(shù)（續(xù)）名稱類型描述必選Durationdouble停車時長（分鐘）否Lpn(Licenseplatenumber)string(32)車牌號碼如系統(tǒng)記錄了車牌的顏色信息，需一并上傳，如：粵A88888（藍）是PayMethodstring(32)支付方式（ETC發(fā)卡等）否ChargesTypestring(32)該次收費的執(zhí)行方式（VIP、月保、臨保等）是TotalCostdouble總費用（元）否車輛入場記錄上傳的應(yīng)答使用通用響應(yīng)。停車場空位信息數(shù)據(jù)采集停車場空位記錄上傳請求參數(shù)見表12。表12停車場空位信息上傳請求參數(shù)9停車場空位信息記錄上傳停車場空位記錄上傳請求參數(shù)見表12。表12停車場空位信息上傳請求參數(shù)9名稱類型描述必選ParkIDlong備案ID（停車場管理系統(tǒng)中該停車場的備案ID）是DataProviderIdstring(64)停車場主鍵ID是Norps(Numberofremainingparkingspaces)integer剩余停車位是Noops(Numberofoccupiedparkingspaces)integer已占用停車位是Nopsrafc(Numberofparkingspacesremainingavailableforcharging)integer剩余的可供充電停車位數(shù)量是表12停車場空位信息上傳請求參數(shù)（續(xù)）名稱類型描述必選Noopsafc(Numberofoccupiedparkingspacesavailableforcharging)integer已占用的可供充電停車位數(shù)量是Nopsrfr(Numberofparkingspacesremainingforreservations)integer剩余可供預約（共享）的停車位數(shù)量是Noopsfr(Numberofoccupiedparkingspacesforreservations)integer已占用的可供預約（共享）的停車位數(shù)量是定時上傳，要求每30（可配置）分鐘上傳1次。使用通用響應(yīng)。10道路泊位信息數(shù)據(jù)采集道路泊位路段狀態(tài)信息上傳請求道路泊位路段狀態(tài)信息上傳請求參數(shù)見表13。使用通用響應(yīng)。10道路泊位信息數(shù)據(jù)采集道路泊位路段狀態(tài)信息上傳請求道路泊位路段狀態(tài)信息上傳請求參數(shù)見表13。表13道路泊位路段狀態(tài)信息上傳請求參數(shù)10名稱類型描述必選ParkingRegisterRecordIdlong備案ID（停車場管理系統(tǒng)中該路段的備案ID）是ParkingCodestring(64)停車場（路段）編碼是ParkingNamestring(128)停車場（路段）名稱是ParkingAddressstring(256)地址是RoadStartstring(128)路段起始位置是RoadEndstring(128)路段終止位置是AreaNamestring(64)行政區(qū)是AreaCodestring(8)行政區(qū)代碼是表13道路泊位路段狀態(tài)信息上傳請求參數(shù)（續(xù)）名稱類型描述必選Descriptionstring(512)備注說明否CompanyNamestring(128)停車場管理單位（全稱）是CompanyAddressstring(256)注冊地址否UnitCodestring(64)統(tǒng)一社會信用代碼否LegalPersonstring(16)法定代表人否LegalTelephonestring(32)法定代表人聯(lián)系電話否ContactPersonstring(16)聯(lián)系人否ContactTelephonestring(32)聯(lián)系人電話否Typeinteger類型（注）是Occupystring(16)單側(cè)或雙側(cè)占用否OccupyLengthdouble占用長度否OccupyWidthdouble占用寬度否OccupyAreadouble占用面積否ParkingSpaceinteger總停車位是ParallelSpaceinteger平行式泊位否VerticalSpaceinteger垂直式泊位否TileSpaceinteger傾斜式泊位否ServiceTelephonestring(128)服務(wù)監(jiān)督電話否JeevesNumberstring(32)占道證號否RoadNumberstring(32)道路編號否InitialOperationTimestring(64)初次營業(yè)日期否Noaps(NumberofAvailableparkingSpaces)integer可用停車位數(shù)量（可向公眾提供服務(wù)的停車位）是PowerChargingSpaceinteger新能源專用停車位數(shù)量是FCPile(FastChargingPile)integer充電樁數(shù)量（快充）否SCPile(SlowChargingPile)integer充電樁數(shù)量（慢充）否Cstat(ChargingStatus)boolean當前是否可充電否DSpace(Disabledparkingspaces)integer殘疾人停車位數(shù)否111110.1.2道路泊位路段狀態(tài)信息上傳的應(yīng)答使用通用響應(yīng)。10.1.2道路泊位路段狀態(tài)信息上傳的應(yīng)答使用通用響應(yīng)。道路泊位車輛出入場記錄上傳請求道路泊位車輛出入場記錄上傳請求參數(shù)見表14。12表13道路泊位路段狀態(tài)信息上傳請求參數(shù)（續(xù)）名稱類型描述必選Coordsys(CoordinatesSystem)string(8)坐標系可選WGS84、GCJ02、BD09，后續(xù)可擴展。建議使用GCJ02（高德）。否Longitudedouble經(jīng)度是Latitudedouble緯度是Rstat(ReservationStatus)boolean當前是否可預約否RSpace(ReservationSpace)integer可預約（共享）停車位數(shù)否PaymentOptioninteger支付方式（0全部1電子2現(xiàn)金）是ChargeModestring(32)收費模式（咪表、人工、線上支付或網(wǎng)點繳費）是ChargeTypestring(512)收費標準是AreaTypestring(16)地區(qū)分類（重點區(qū)域、非重點區(qū)域）是BusinessHourStartstring(128)開始營業(yè)時間是BusinessHourEndstring(128)結(jié)束營業(yè)時間是ROpeningHoursstring(128)預約（共享）開放時間否注：1全天準停泊位專用泊位（212223）限時停放路段（31323334）10.2.2道路泊位車輛出入場記錄上傳的應(yīng)答使用通用響應(yīng)。10.2.2道路泊位車輛出入場記錄上傳的應(yīng)答使用通用響應(yīng)。道路泊位實時狀態(tài)記錄上傳請求道路泊位實時狀態(tài)記錄上傳請求參數(shù)見表15。表15道路泊位實時狀態(tài)記錄上傳請求參數(shù)13表14道路泊位車輛出入場記錄上傳請求參數(shù)名稱類型描述必選ParkingRegisterRecordIdlong備案ID（停車場管理系統(tǒng)中該路段的備案ID）是DataProviderRecordIdstring(64)停車場（路段）主鍵ID是ParkingCodestring(32)停車場（路段）編碼否ParkingAddressstring(256)停車場地址否EntryTimeDate(string)入場時間是ExitTimeDate(string)出場時間是Durationdouble停車時長（分鐘）否PlateNumberstring(32)車牌號碼是PlateColorstring(32)車牌顏色否Statusinteger0離場1在場2出場未識別-1測試是PayMethodstring(32)支付方式（現(xiàn)金、銀行卡、羊城通、微信、支付寶、ETC、自發(fā)卡等）否ChargesTypestring(32)該次收費的執(zhí)行方式（VIP、月保、臨保等）否TotalCostdouble總費用（元）是名稱類型描述必選ParkingRegisterRecordIdlong備案ID（停車場管理系統(tǒng)中該停車場的備案ID）是DataProviderRecordIdstring(64)停車場（路段）主鍵ID是ParkingCodestring(16)停車場（路段）編碼否ParkingAddressstring(256)停車場地址否FreeSpaceinteger剩余停車位是TakenSpaceinteger已占用停車位是10.3.2道路泊位實時狀態(tài)記錄上傳的應(yīng)答使用通用響應(yīng)。10.3.2道路泊位實時狀態(tài)記錄上傳的應(yīng)答使用通用響應(yīng)。11用戶登錄11.1登錄登錄請求參數(shù)見表16。表16登錄請求參數(shù)11.2登錄的應(yīng)答登錄的應(yīng)答響應(yīng)參數(shù)見表17。14表15道路泊位實時狀態(tài)記錄上傳請求參數(shù)（續(xù)）名稱類型描述必選Nopsrafc(Numberofparkingspacesremainingavailableforcharging)integer剩余的可供充電停車位數(shù)量否Noopsafc(Numberofoccupiedparkingspacesavailableforcharging)integer已占用的可供充電停車位數(shù)量否Nopsrfr(Numberofparkingspacesremainingforreservations)integer剩余可供預約（共享）的停車位數(shù)量否Noopsfr(Numberofoccupiedparkingspacesforreservations)integer已占用的可供預約（共享）的停車位數(shù)量否名稱類型描述必選userNameOrEmailAddressstring(32)賬戶是passWordstring(32)密碼是表17登錄響應(yīng)參數(shù)名稱類型描述必選accessTokenstring訪問令牌，用于后續(xù)接口的合法訪問。是expireInSecondsInteger有效時長（秒）是userIdInteger用戶ID停車位預約共享服務(wù)登錄運營商應(yīng)提供有效的appId和appSecret；平臺方通過appId和appSecret可通過登錄接口獲取到訪問憑證accessTokenaccessToken應(yīng)具有有效期限，接口返回數(shù)據(jù)中應(yīng)包含有效期信息。停車位預約共享服務(wù)登錄請求參數(shù)見表18。12.1.5停車位預約共享服務(wù)登錄響應(yīng)參數(shù)見表19。12.1.5停車位預約共享服務(wù)登錄響應(yīng)參數(shù)見表19。表19登錄響應(yīng)參數(shù)服務(wù)預授權(quán)平臺方通過11.1節(jié)接口獲取的accessToken服務(wù)代碼等參數(shù)通過該接口獲取到訪問憑證preAuthCode，后續(xù)的停車位預約共享服務(wù)請求的接口需在請求參數(shù)攜帶上preAuthCode參數(shù)；preAuthCode應(yīng)具有有效期限，接口返回數(shù)據(jù)中應(yīng)包含有效期信息。服務(wù)預授權(quán)請求參數(shù)見表20。表20預授權(quán)請求參數(shù)15名稱類型描述必選appIdstring(64)應(yīng)用ID是appSecretstring(64)應(yīng)用密鑰是名稱類型描述必選accessTokenstring訪問憑證是expireInSecondsInt有效期時長（秒）是名稱類型描述必選accessTokenstring(512)訪問憑證是12.2.512.2.5服務(wù)預授權(quán)響應(yīng)參數(shù)見表22。表