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

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