ICS35.240.01

CCSL67

DB4403

深圳市地方標準

DB4403/T315—2023

停車庫（場）預約共享數據接口規范

Specificationforreservationandshareddatainterfaceofparkinglots

2023-02-15發布2023-03-01實施

深圳市市場監督管理局發布

DB4403/T315—2023

停車庫（場）預約共享數據接口規范

1范圍

本文件規定了停車庫（場）預約共享停車業務的總體要求、功能要求、數據接口要求、數據傳

輸要求。

本文件適用于深圳市范圍內停車庫（場）管理系統或停車管理平臺與預約共享停車平臺之間的

數據交換以及功能設計與開發。

2規范性引用文件

下列文件中的內容通過文中的規范性引用而構成本文件必不可少的條款。其中，注日期的引用

文件，僅該日期對應的版本適用于本文件；不注日期的引用文件，其最新版本（包括所有的修改單）

適用于本文件。

GB/T2260中華人民共和國行政區劃代碼

GB5768.2道路交通標志和標線第2部分：道路交通標志

GB/T10114縣級以下行政區劃代碼編制規則

GA/T761停車庫（場）安全管理系統技術要求

DB4403/T89智慧停車基礎信息編碼技術規范

SZJG44停車庫（場）車輛視頻圖像和號牌信息采集與傳輸系統技術要求

3術語和定義

下列術語和定義適用于本文件。

3.1

車位提供方parkingspaceprovider

具有車位產權或使用權，并在一段時間內提供車位的組織或個人。

3.2

停車用戶parkingspaceuser

接受停車服務的組織或個人。

3.3

預約停車reservedparking

車位提供方（3.1）向停車用戶（3.2）提供約定時間內預約入場或預約到位的服務。

注：停車用戶提前申請、預約才可享受停車服務。

3.4

共享停車sharedparking

車位提供方（3.1）在車位空閑時向停車用戶（3.2）提供停車的服務。

3.5

服務商parkingattendant

為停車庫（場）提供預約共享能力解決方案和經營管理服務，協助停車庫（場）接入預約共享

停車平臺的組織或個人。

1

DB4403/T315—2023

注：服務商包括但不限于停車庫（場）運營（承包）公司、平臺廠商、城市停車運營服務平臺運營方、物業管

理企業、工程商/集成商、設備廠商等。

3.6

預約車輛parkingreservationvehicles

向具備預約停車（3.3）的停車庫（場）預約某個時段停車的車輛。

3.7

停車庫（場）管理系統parkinglotsmanagementsystem

對出入停車庫（場）的車輛進行登記、出入認證，監控和管理，提供停車庫（場）區內引導、

尋找車輛等一系列功能的電子系統或網絡。

3.8

停車管理平臺parkingmanagementplatform

用于對路內停車泊位或路外停車場進行統一運營、監控和運維管理的系統或平臺。

3.9

預約共享停車平臺reservationandsharedparkingplatform

運用物聯網、云計算、大數據等技術，通過與第三方停車、充電、機械車庫等系統或平臺的對

接，獲取、處理停車庫（場）停車信息，將各停車資源互聯互通實現停車資源共享、一賬通行等，

對向社會大眾提供目標區域范圍內車位尋找、車位引導、預約停車（3.3）、共享停車（3.4）等服

務的系統。

3.10

流量管控flowcontrol

根據停車庫（場）內剩余車位數，動態調整入場車輛的放行規則。

3.11

飽和度saturation

停車庫（場）內停放車輛數與總車位數的比值。

注：總車位數指可用于預約和非預約車輛停放的車位總數。

4縮略語

下列縮略語適用于本文件。

APP：應用程序（Application）

HMACSHA256：使用安全哈希算法256的消息認證碼（Hash-basedMessageAuthenticationCode-

SecureHashAlgorithm256）

HTTPS：安全套接字層的超文本傳輸協議（HyperTextTransferProtocoloverSecureSocket

Layer）

ID：標識編碼（Identification）

MQTT：消息隊列遙測傳輸（MessageQueuingTelemetryTransport）

NTP：網絡時間協議（NetworkTimeProtocol）

QoS：服務質量（QualityofService）

5總體要求

5.1具備預約共享業務功能的停車庫（場）建設應符合附錄A的規定。

2

DB4403/T315—2023

5.2預約共享停車平臺與各停車庫（場）管理系統或停車管理平臺進行數據對接，預約共享停車業

務示意圖見圖1，具體接入方式如下：

a)預約停車資源或共享停車資源通過停車管理平臺接入預約共享停車平臺進行數據交互；

b)預約停車資源或共享停車資源通過停車庫（場）管理系統接入預約共享停車平臺進行數據

交互。

預約停車

資源

停車管理平臺

共享停車

資源

預約共享停車平臺停車用戶

預約停車

資源

停車庫（場）管理系

統

共享停車

資源

車位提供方服務商平臺運營方用戶端

注：實線框表示在本文件界定的范圍。

圖1預約共享停車業務示意圖

5.3當產生共享停車業務或預約停車業務時，停車業務場景及流程見附錄B。

6功能要求

6.1通用要求

接入預約共享停車平臺的停車庫（場）管理系統或停車管理平臺應符合以下要求：

a)支持向預約共享停車平臺提供停車庫（場）地理位置（如地址、出入口經緯度）、車位信

息（如車位數量）、收費標準等信息，并符合以下要求：

1)應保證登記的車位信息真實有效，若車位信息變更，應及時維護；

2)應按照登記發布的車位信息提供停車服務，不隨意變更。

b)支持電子支付功能；

c)支持發票開具功能；

d)支持對車輛出入事件信息的記錄、管理及查詢等功能；

e)支持向預約共享停車平臺上傳車輛的入場信息、出場信息、收費記錄等功能；

f)支持對出入停車庫（場）的車輛和車位進行采集、記錄、認證、監控及管理等功能；

g)支持接收預約共享停車平臺的車輛管控名單功能；

h)支持預約車輛費用減免、打折優惠等功能。

6.2預約停車

6.2.1停車庫（場）管理系統或停車管理平臺應支持接收預約共享停車平臺下發的預約停車數據，

包括：

a)預約信息：車輛信息、預約時間等；

b)預約時段變更信息：車輛信息、變更預約時段等；

3

DB4403/T315—2023

c)限時取消預約信息：車輛信息、取消預約等；

d)預約時段與停車時段信息：未按預約訂單起始時間進入停車庫（場）的處置規則。

6.2.2停車庫（場）管理系統或停車管理平臺宜支持將預約車輛入口臨時調整成非預約車輛入口的

功能。

6.2.3停車庫（場）管理系統或停車管理平臺宜支持設置停放車輛飽和度的功能。

6.2.4停車庫（場）管理系統或停車管理平臺應支持開啟或關閉預約車輛優先通行功能，并向預約

共享停車平臺通知其開啟或關閉的狀態信息。

6.2.5停車庫（場）管理系統或停車管理平臺宜支持根據飽和度動態調整流量管控規則保障預約車

輛優先通行的功能。

6.3共享停車

6.3.1停車庫（場）管理系統或停車管理平臺應向預約共享停車平臺上報以下信息：

a)共享方案信息：車位共享方案類型、車型限制、車位停放時段、有效期等；

b)支付結果信息：共享方案訂單編號、訂單類型、支付結果狀態、支付方式等；

c)超時訂單信息：共享方案訂單編號、超時訂單編號、車牌號碼、入場時間、出場時間、超

時時間等；

d)退款結果信息：退款流水號、共享方案訂單編號、訂單類型、退款狀態等；

e)訂單信息變更信息：共享方案訂單編號、訂單狀態、車牌號碼、開始日期、結束日期等。

6.3.2停車庫（場）管理系統或停車管理平臺應接收預約共享停車平臺下發以下信息：

a)共享停車訂單信息：車輛信息、共享時段等；

b)共享停車時段變更信息：車輛信息、變更預約時段等；

c)共享停車限時取消信息：車輛信息、取消預約等。

7數據接口要求

7.1概述

停車庫（場）管理系統或停車管理平臺與預約共享停車平臺對接前，服務商向預約共享停車平

臺運營方提出接入申請，并進行數據對接。

7.2基礎數據類型

基礎數據應符合表1的要求，其中停車庫（場）編號、車位編號應符合DB4403/T89的要求。

表1基礎數據類型清單

類型名稱長度基礎類（json）說明

StringNaString字符串

Long8字節Number長整型

Int4字節Number整型

Boolean1字節Boolean布爾型

Float4字節Number浮點型

4

DB4403/T315—2023

表1基礎數據類型清單（續）

類型名稱長度基礎類（json）說明

Double8字節Number雙精度浮點

Decimal16字節Number高精度浮點

Date10字符String日期，格式“yyyy-MM-dd”

DateTime19字符String日期時間，格式“yyyy-MM-ddHH:mm:ss”

Time8字符String時間，格式“HH:mm:ss”

Timestamp4字節Number時間戳，1970-01-0100:00:00：00起的秒數

Uuid32字符String全球唯一ID

ObjectNbObject對象

ListNbArray數組

注1：未作特殊說明情況下，本文件中涉及的金額統一采用數據類型Decimal，單位為元，精度為小數點后2位。

注2：無特殊說明，本文件中的經緯度均為GCJ-02坐標系坐標。

注3：后文的數據定義中未寫明長度的數據類型的字符長度以本表規定為準。

注4：Na表示根據各屬性（名稱）定義其字符長度，Nb表示引用其他對象。

7.3接口要求

7.3.1協議使用要求

對接要求

停車庫（場）管理系統或停車管理平臺在對接預約共享停車平臺前，按預約共享停車平臺的管

理要求，準備信息包括但不限于：

a)注冊獲取平臺服務器地址、對接賬號（HTTPS對接的使用的userId/clientId、password

及鹽值salt）信息等；

b)向預約共享停車平臺提供服務器IP地址（可選）。

基本要求

基本要求如下：

a)傳輸格式：JSON；

b)編碼格式：UTF-8；

c)屬性命名規范：小駝峰形式（如：deviceId）；

d)協議要求：HTTPS或MQTT；

e)使用接口一次發送數據的大小不應超過10M字節；

f)預約共享停車平臺、停車管理平臺采用如NTP時間同步技術和北京時間保持同步；

g)接口請求超時時間限制：20秒以內；

h)請求數據基本格式見表2，應答數據基本格式見表3；

i)編碼定義應符合附錄C的規定；

j)簽名和接口使用示例見附錄D。

5

DB4403/T315—2023

表2請求數據基本格式

屬性名稱數據類型字符長度必須說明

timestamp時間戳Timestamp4是—

簽名算法HMACSHA256，key值使用

sign簽名String—是平臺分配的鹽值salt，對data數

據進行簽名

data請求數據List<Object>—是根據接口不同請求數據不同

表3應答數據基本格式

屬性名稱數據類型字符長度必須說明

code系統編碼Int—是通用錯誤編碼見表C.1

message系統消息String255否系統編碼對應的消息

timestamp時間戳Timestamp—是—

data返回數據List<Object>—是根據接口不同返回數據不同

HTTPS接口要求

HTTPS接口符合以下要求：

a)采用Token機制實現身份認證；Token放到HTTPSheader的Authorization中；

b)接口URL規則：https：//{服務器地址}/sys/{版本號}/event/{接口編碼}/post。

示例：https：///sys/v1/event/login/post。

MQTT接口要求

MQTT接口符合以下要求：

a)加密方式：傳輸加密采用tls證書加密方式；

b)認證方式：使用預約共享停車平臺分配的MQTT客戶端ID（clientId，標識每個MQTT連接

需要唯一ID）和密碼登錄消息中間件；

c)服務質量（QoS）：使用默認的QoS等級0；

d)當使用MQTT協議傳輸數據時：

1)上行符合以下要求：

請求Topic：/sys/{版本號}/event/{接口編碼}/post；

響應Topic：/sys/{版本號}/event/{接口編碼}/post_reply。

示例：

請求Topic：/sys/v1/event/login/post；

響應Topic：/sys/v1/event/login/post_reply。

2)下行符合以下要求：

請求Topic：/sys/{版本號}/service/{接口編碼}/post；

響應Topic：/sys/{版本號}/service/{接口編碼}/post_reply。

示例：

請求Topic：/sys/v1/service/requestBookStall/post；

響應Topic：/sys/v1/service/requestBookStall/post_reply。

6

DB4403/T315—2023

7.3.2安全認證接口

登錄

安全認證接口的登錄應符合以下要求：

a)接口編碼：login；

b)場景：停車庫（場）管理系統或停車管理平臺請求登錄預約共享停車平臺，平臺驗證用戶

標識，生成Token返回；

c)數據屬性：請求數據屬性定義見表4，應答數據屬性定義見表5。

表4請求數據屬性定義

屬性名稱數據類型字符長度必須說明

userId用戶唯一標識String32是—

不使用明文，采用SHA1對原用戶

password用戶密碼String64是

密碼加上鹽值salt簽名后的值

表5應答數據屬性定義

屬性名稱數據類型字符長度必須說明

code消息碼Int—否發生錯誤時為必填，編碼見表C.2

message消息詳細String255否業務異常信息

scope范圍String50否請求的業務范圍，默認值basic

tokenType鑒權token類型String50是默認值bearer

accessToken的有效時間，單位：

expiresIn有效時間Int—是

秒

accessToken權限TokenString255是Oauth2.0鑒權參數

refreshToken刷新TokenString255是Oauth2.0鑒權參數

刷新Token

安全認證接口的刷新應符合以下要求：

a)接口編碼：refreshToken；

b)場景：accessToken快過期時，停車庫（場）管理系統或停車管理平臺通過調用此接口，

重新獲取可用token。accessToken有效時間按照返回字段expiresIn的值；

c)數據屬性：請求數據屬性定義見表6，應答數據屬性定義見表7。

表6請求數據屬性定義

屬性名稱數據類型字符長度必須說明

userId用戶唯一標識String32是預約共享停車平臺分配

不使用明文，采用SHA1對原用戶

password用戶密碼String64是

密碼加上鹽值salt簽名后的值

refreshToken刷新TokenString—是—

7

DB4403/T315—2023

表7應答數據屬性定義

屬性名稱數據類型字符長度必須說明

id業務IDUuid32是—

code消息碼Int—否發生錯誤時為必填，編碼見表C.2

message消息詳細String255否業務異常信息

tokenType鑒權token類型String50是默認值bearer

accessToken的有效時間，單位：

expiresIn有效時間Int—是

秒

accessToken權限TokenString50是Oauth2.0鑒權參數

refreshToken刷新TokenString50是Oauth2.0鑒權參數

登出

安全認證接口的登出應符合以下要求：

a)接口編碼：logout；

b)場景：注銷Token；

c)數據屬性：請求數據屬性定義見表8，應答數據屬性定義見表9。

表8請求數據屬性定義

屬性名稱數據類型字符長度必須說明

accessToken權限TokenString50是—

表9應答數據屬性定義

屬性名稱數據類型字符長度必須說明

code消息碼Int—否發生錯誤時為必填，編碼見表C.2

message消息詳細String255否業務異常信息

7.3.3基礎數據接口

停車庫（場）信息上報

基礎數據接口的停車庫（場）信息上報應符合以下要求：

a)接口編碼：parkInfo；

b)場景：停車庫（場）管理系統或停車管理平臺調用接口主動推送停車庫（場）信息；

c)數據屬性：請求數據屬性定義見表10，應答數據屬性定義見表11。

表10請求數據屬性定義

屬性名稱數據類型字符長度必須說明

停車庫（場）編

parkCodeString20是預約共享停車平臺提供

號

8

DB4403/T315—2023

表10請求數據屬性定義（續）

屬性名稱數據類型字符長度必須說明

停車庫（場）名

parkNameString255是服務商提供

稱

由預約共享停車平臺分配，涉及共

providerCode服務商編號String100否

享停車應提供

roadName道路名稱String10否—

0：路內停車區；

停車庫（場）類

parkTypeInt—是1：室內停車場；

型

2：室外停車場

0：否；

isGarage是否有機械車庫Int—否

1：是

停車庫（場）詳

addressString255是停車庫（場）詳細地址

細地址

經度，服務商上傳時應說明數據來

longitude經度Double—是

源

緯度，服務商上傳時應說明數據來

latitude緯度Double—是

源

編碼規則應符合GB/T2260、GB/T

provinceCode省編碼String50是

10114的要求

編碼規則應符合GB/T2260、GB/T

cityCode城市編碼String50是

10114的要求

編碼規則應符合GB/T2260、GB/T

areaCode區域編碼String50是

10114的要求

totalSpaces總車位數Int—是總車位數

reservableSpa

總可預約車位數Int—否涉及預約停車業務應提供

ces

totalCharingS

總充電車位數Int—否涉及充電業務應提供

paces

totalReservab

總可預約充電車

leCharingSpacInt—否涉及充電業務應提供

位數

es

總共享停車車位

sharedSpacesInt—否—

數

停車庫（場）運由預約共享停車平臺統一分配，涉

operatorIdString10否

營方編號及預約停車業務時應提供

針對住宅類

committeeInfo是否有業委會Int—否0：是；

1：否

9

DB4403/T315—2023

表10請求數據屬性定義（續）

屬性名稱數據類型字符長度必須說明

publicInfo經營信息String200否經營時間（如6:00～8:00）

1：商業；

2：住宅；

3：醫院；

4：園區；

serviceType服務屬性Int—否

5：交通樞紐；

6：行政機關；

7：學校；

8：其它

示例：免費時長30分鐘，首小時

chargingStand

收費標準描述String255是10元，后每小時5元，每24小時

ardDesc

封頂60元

停車庫（場）收圖片URL訪問地址，見.7

imageUrlString255否

費牌圖片圖片上傳接口

停車庫（場）電圖片URL訪問地址，見.7

mapImageString255否

子平面圖圖片上傳接口

parkingSpaceI圖片URL訪問地址，見.7

車位分布圖String255否

mage圖片上傳接口

contacts聯系人String50否停車庫（場）聯系人

tel聯系電話String20否停車庫（場）聯系電話

停車庫（場）使用狀態：

bizStatus狀態Int—否0：禁用；

1：啟用

remark備注字段String255否備注字段

表11應答數據屬性定義

屬性名稱數據類型字符長度必須說明

parkCode停車庫（場）編號String20是—

code消息碼Int—否發生錯誤時為必填，編碼見表C.2

message消息詳細String255否業務異常信息

isvParkId平臺車場IDString50是預約共享停車平臺生成

出入口信息上報

基礎數據接口的出入口信息上報應符合以下要求：

a)接口編碼：entranceExitInfo；

b)場景：停車庫（場）管理系統或停車管理平臺調用接口主動推送出入口信息；

c)數據屬性：請求數據屬性定義見表12，應答數據屬性定義見表13。

10

DB4403/T315—2023

表12請求數據屬性定義

屬性名稱數據類型字符長度必須說明

id出入口IDUuid32是停車庫（場）的出入口ID

name名稱String10是—

停車庫（場）編

parkCodeString20是—

號

roadName道路名稱String10否—

1：入口；

type出入口類型Int—是2：出口；

3：出入口

經度，服務商上傳時應說明數據來

longitude經度Double—是

源

緯度，服務商上傳時應說明數據來

latitude緯度Double—是

源

1：正常；

status狀態Int—是2：刪除；

3：臨時封閉（故障、管制等）

表13應答數據屬性定義

屬性名稱數據類型字符長度必須說明

id出入口IDUuid32是停車庫（場）的出入口ID

code消息碼Int—否發生錯誤時為必填，編碼見表C.2

message消息詳細String255否業務異常信息

車位基礎信息上報

基礎數據接口的車位基礎信息上報應符合以下要求：

a)接口編碼：spaceInfo；

b)場景：停車庫（場）管理系統或停車管理平臺調用接口主動推送車位基礎信息；

c)數據屬性：請求數據屬性定義見表14，應答數據屬性定義見表15。

表14請求數據屬性定義

屬性名稱數據類型字符長度必須說明

idIDString—是—

spaceNo車位編號String28是車位方格內的編號

停車庫（場）編

parkCodeString20是—

號

11

DB4403/T315—2023

表14請求數據屬性定義（續）

屬性名稱數據類型字符長度必須說明

0：分時；

1：長期包月；

manageType經營類型Int—否2：限時段包月；

3：已售；

4：專用車位（如消防）

1：個人；

ownerType產權類型Int—否2：單位；

3：其他

0：路內；

positionType位置類型Int—是1：停車庫；

2：停車場

車位分類【長（毫米）×寬（毫

米）】：

1：小型：4000×2200；

sizeType尺寸類型Int—否

2：中型：5000×2500；

3：大型：15600×3250；

4：子母車位：10000×2500

長（毫米）×寬（毫米）×高（毫

spaceSize車位尺寸String—否

米），不限高度車位，高度為0

1：商業；

2：住宅；

3：醫院；

4：園區；

serviceType服務屬性Int—否

5：交通樞紐；

6：行政機關；