《智慧園區(qū) 停車數(shù)據(jù)與接口規(guī)范》

ICS點擊此處添加ICS號

點擊此處添加中國標準文獻分類號

T/

深圳市智慧園區(qū)產(chǎn)業(yè)標準聯(lián)盟團體標準

T/XXXXXXXX—XXXX

智慧園區(qū)停車數(shù)據(jù)與接口規(guī)范

點擊此處添加標準英文譯名

點擊此處添加與國際標準一致性程度的標識

文稿版次選擇

XXXX-XX-XX發(fā)布XXXX-XX-XX實施

發(fā)布

目次

前言................................................................................II

1范圍..............................................................................1

2規(guī)范性引用文件....................................................................1

3術(shù)語和定義........................................................................1

4系統(tǒng)架構(gòu)..........................................................................3

5接口規(guī)范.........................................................................18

附錄A（規(guī)范性附錄）編碼...........................................................48

附錄B（資料性附錄）常見場景流程...................................................52

附錄C（資料性附錄）接口使用示例...................................................64

前言

本文件按照GB/T1.1-2009給出的規(guī)則起草。

本文件由深圳智慧園區(qū)產(chǎn)業(yè)聯(lián)盟提出并歸口。

本文件起草單位：

本文件主要起草人：

Q/XXXXXXXX—XXXX

智慧園區(qū)停車業(yè)務(wù)數(shù)據(jù)與接口規(guī)范

1范圍

本標準規(guī)定了智慧園區(qū)停車業(yè)務(wù)數(shù)據(jù)中，智慧園區(qū)管理平臺與停車子系統(tǒng)或智慧園區(qū)停車管理平臺

之間的系統(tǒng)架構(gòu)、接口規(guī)范。

本標準適用于不同歸屬的停車子系統(tǒng)或智慧園區(qū)停車管理平臺與智慧園區(qū)管理平臺之間的停車信

息交換。

2規(guī)范性引用文件

下列文件對于本文件的應(yīng)用是必不可少的。凡是注日期的引用文件，僅所注日期的版本適用于本文

件。凡是不注日期的引用文件，其最新版本（包括所有的修改單）適用于本文件。

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

GB/T10114縣以下行政區(qū)劃代碼編制規(guī)則

GB11643公民身份號碼

GB/T26476機械式停車設(shè)備術(shù)語

JGJ100-2015車庫建筑設(shè)計規(guī)范

3術(shù)語和定義

GB/T26476界定的以及下列術(shù)語和定義適用于本文件。

3.1

智慧園區(qū)smartpark

通過物聯(lián)網(wǎng)、云計算等新一代信息技術(shù)，實現(xiàn)園區(qū)基礎(chǔ)設(shè)施優(yōu)化、運營管理精細化、功能服務(wù)信息

化和產(chǎn)業(yè)發(fā)展智慧化。

[DB44/T2228-2020，定義3.2]

3.2

智慧園區(qū)管理平臺managementplatformofsmartpark

運用物聯(lián)網(wǎng)、云計算、大數(shù)據(jù)等技術(shù)，將園區(qū)內(nèi)各相關(guān)系統(tǒng)互通，通過信息交換服務(wù)實現(xiàn)基礎(chǔ)架構(gòu)

和基礎(chǔ)應(yīng)用與服務(wù)之間的數(shù)據(jù)交換，對基礎(chǔ)設(shè)施、系統(tǒng)等進行統(tǒng)一認證管理、權(quán)限管理等操作，向園區(qū)

內(nèi)相關(guān)方展示和管理的系統(tǒng)。

3.3

智慧園區(qū)停車管理平臺Parkingmanagementplatformofsmartpark

1

Q/XXXXXXXX—XXXX

通過與停車子系統(tǒng)對接，獲取、處理停車場停車信息，將園區(qū)內(nèi)各停車資源互聯(lián)互通實現(xiàn)停車資源

共享、一賬通行等，向園區(qū)內(nèi)相關(guān)方提供車場車位管理、設(shè)備管理、月租車管理、停車繳費、車位引導、

反向?qū)ぼ?、車位預約等服務(wù)的系統(tǒng)。

3.4

機械式機動車庫mechanicalmotorvehiclegarage

采用機械式停車設(shè)備存取、停放機動車的車庫，簡稱“機械車庫”。

[JGJ100-2015，術(shù)語2.0.11]

3.5

停車庫（場）parkinglot

專用于機動車輛停放的場所，簡稱“停車場”。

注：改寫GB50067-2014，術(shù)語2.0.3。

3.6

路內(nèi)停車場curbparking

指城市管理部門為了緩解停車難、停放亂等社會問題，通過對道路兩側(cè)、橋梁等控制線以內(nèi)的公共

可容停車空間進行車位資源規(guī)劃、設(shè)計，整體調(diào)節(jié)城市停車布局而設(shè)置的停車場所。

3.7

路外停車場off-streetparking

是指道路用地控制線以外，根據(jù)城市規(guī)劃建造以及建筑配套專門開辟興建的停車場、停車庫或停車

樓。

3.8

車（泊）位vehiclestall

為停放車輛而設(shè)置的停車位置,簡稱“車位”。

3.9

停車訂單parkingorder

由智慧園區(qū)停車管理平臺或停車子系統(tǒng)產(chǎn)生的待繳費憑據(jù)。

注：包含訂單編號，車輛入場時間，車輛出場時間，車牌號碼，停車時長，應(yīng)繳金額，優(yōu)惠金額等信息。

3.10

繳費記錄paymentrecord

用戶根據(jù)停車訂單完成繳費后形成的支付信息。

注：包含繳費流水、停車訂單信息以及出場優(yōu)惠、實收、其他費用、收費類型等信息。

3.11

2

Q/XXXXXXXX—XXXX

車位分享stallssharing

將閑置的車位資源通過智慧園區(qū)管理平臺共享、統(tǒng)一發(fā)布，由智慧園區(qū)停車管理平臺提供車位共享

服務(wù)。

3.12

無感支付non-inductivepayment

通過車牌識別技術(shù)與各種支付渠道捆綁而實現(xiàn)的自動支付服務(wù)。

3.13

全景圖panorama

包含完整車輛、整體車位以及附屬設(shè)施的圖像。

3.14

商戶merchants

與智慧園區(qū)管理平臺簽訂支付清結(jié)算協(xié)議的法人主體。

注：包括個體工商戶、企業(yè)法人等。

3.15

時間戳timestamp

特指發(fā)送同一份業(yè)務(wù)數(shù)據(jù)時的發(fā)送時刻。

3.16

下行接口southinterface

智慧園區(qū)管理平臺作為發(fā)起方，發(fā)送數(shù)據(jù)給停車子系統(tǒng)或智慧園區(qū)停車管理平臺的接口。

3.17

上行接口northinterface

停車子系統(tǒng)或智慧園區(qū)停車管理平臺作為發(fā)起方，發(fā)送數(shù)據(jù)給的接口智慧園區(qū)管理平臺。

4系統(tǒng)架構(gòu)

4.1系統(tǒng)架構(gòu)

智慧園區(qū)管理平臺與停車子系統(tǒng)或智慧園區(qū)停車管理平臺之間數(shù)據(jù)交互，實現(xiàn)智慧停車業(yè)務(wù)。本標

準內(nèi)容僅涵蓋北向接口（智慧園區(qū)管理平臺與停車子系統(tǒng)、智慧園區(qū)管理平臺與智慧園區(qū)停車管理平臺

之間的接口），系統(tǒng)架構(gòu)見圖1。

注：為便于描述，下文將停車子系統(tǒng)、智慧園區(qū)停車管理平臺簡稱為‘停車子系統(tǒng)’。

3

Q/XXXXXXXX—XXXX

圖1停車系統(tǒng)架構(gòu)圖

4.2接口清單

接口清單如表1所示。

表1接口清單

接口編號接口說明支持協(xié)議方向

1001登錄（HTTPs）HTTPS上行

1002刷新Token（HTTPs）HTTPS上行

1003登出（HTTPs）HTTPS上行

1004登錄(TCP)TCP上行

1005登出(TCP)TCP上行

1006心跳(TCP)TCP上行

2001圖片上傳接口HTTPS上行

2002系統(tǒng)事件上報HTTPS上行

3001車場信息上報HTTPS上行

3002出入口信息上報HTTPS上行

3003設(shè)備信息上報HTTPS上行

4

Q/XXXXXXXX—XXXX

表1（續(xù)）

接口編號接口說明支持協(xié)議方向

3004車位信息上報HTTPS上行

3005車場收費標準信息上報HTTPS上行

4001車輛管控名單下發(fā)HTTPS/TCP下行

5001車位狀態(tài)變更上報HTTPS上行

5002設(shè)備狀態(tài)信息上報HTTPS上行

5003場內(nèi)車位數(shù)上報HTTPS上行

5004車輛駛?cè)胄畔⑸蠄驢TTPS上行

5005車輛駛離信息上報HTTPS上行

5006記錄校正信息上報HTTPS上行

5007請求支付HTTPS上行

5008車輛收費記錄上報HTTPS上行

5009車輛退費信息上報HTTPS上行

5010請求車輛代扣驗簽HTTPS上行

5011出入口狀態(tài)變更上報HTTPS上行

5012月租車租約信息更新上報HTTPS上行

6001車位預定鎖定HTTPS/TCP下行

6002車位預定確定HTTPS/TCP下行

6003車輛鎖車/解鎖指令下發(fā)HTTPS/TCP下行

6004車位分享信息下發(fā)HTTPS/TCP下行

6005場內(nèi)車輛查詢HTTPS/TCP下行

6006查詢停車費HTTPS/TCP下行

6007訂單支付成功通知下發(fā)HTTPS/TCP下行

6008車輛代扣簽約狀態(tài)變更通知HTTPS/TCP下行

6009月租車租約查詢HTTPS/TCP下行

6010月租車延期HTTPS/TCP下行

6013注銷月租車HTTPS/TCP下行

6015設(shè)備操控HTTPS/TCP下行

8001機械車庫信息上報HTTPS上行

8002機械車庫運行狀態(tài)信息上報HTTPS上行

8003機械車庫剩余車位信息上報HTTPS上行

8004機械車庫存車接口HTTPS/TCP下行

8005機械車庫取車接口HTTPS/TCP下行

9001停車場信息推送HTTPS/TCP下行

1201電子發(fā)票開具接口HTTPS上行

1202發(fā)票庫存查詢接口HTTPS上行

4.3基礎(chǔ)數(shù)據(jù)類型

基礎(chǔ)數(shù)據(jù)應(yīng)符合下列要求：

5

Q/XXXXXXXX—XXXX

a)未作特殊說明情況下，本標準中涉及的金額統(tǒng)一采用數(shù)據(jù)類型Decimal，單位為元，精度為小

數(shù)點后2位。

b)本標準中使用的停車場編號、車位編號遵循園區(qū)管理方的要求。

c)無特殊說明，本標準中的經(jīng)緯度均為WGS84坐標系坐標。

d)后文的數(shù)據(jù)定義中未寫明長度的數(shù)據(jù)類型的字符長度以表2的規(guī)定為準。

表2基礎(chǔ)數(shù)據(jù)類型清單

類型名稱長度基礎(chǔ)類型（json）描述

StringNaString字符串

Long8字節(jié)Number長整型

Int4字節(jié)Number整型

Boolean1字節(jié)Boolean布爾型

Float4字節(jié)Number浮點型

Double8字節(jié)Number雙精度浮點

Decimal16字節(jié)Number高精度浮點

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

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

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

Timestamp4字節(jié)Number時間戳，1970-01-0100:00:00起的秒數(shù)

Uuid32字符String全球唯一ID

ObjectNbObject對象

ListNbArray數(shù)組

注1：Na表示應(yīng)根據(jù)各屬性（名稱）定義其字符長度；

注2：Nb表示引用其他對象，不需定義字符長度。

4.4停車實體定義

4.4.1停車場數(shù)據(jù)(parkInfo)

停車場數(shù)據(jù)信息（parkInfo）如表3所示。

表3停車場數(shù)據(jù)信息

屬性名稱數(shù)據(jù)類型字符長度必須說明

parkCode停車場編號String20是

parkName停車場名稱String255是

0：路內(nèi)；

1：路外室內(nèi)；

parkType停車場類型Int是2：路外室外；

3：機械車庫；

4：路外通用

chargingS

charging收費標準否對于收費的經(jīng)營性停車場應(yīng)提供

tandard

province省份String10否

6

Q/XXXXXXXX—XXXX

表3（續(xù)）

屬性名稱數(shù)據(jù)類型字符長度必須說明

city城市String10否

canton行政區(qū)String10否

area片區(qū)String10否

areaCode行政區(qū)代碼String9是見GB/T2260、GB/T10114

roadName道路名稱String10是

address停車場詳細地址String255否

totalStalls總車位數(shù)Int是

reservableStalls總可預訂車位數(shù)Int否需停車場支持車位預訂

staggerStalls錯峰停車車位數(shù)Int否

longitude經(jīng)度Double否

latitude緯度Double否

operatorId停車場運營方編號String10是由智慧園區(qū)管理平臺統(tǒng)一分配

owner停車場產(chǎn)權(quán)方String50是

maintenance停車場維護方String50否

serviceType服務(wù)屬性Int是

List<Strin

garages機械車庫ID列表是機械車庫信息見表6

g>

ownStation所屬派出所String50否所屬派出所名稱

chargePolice區(qū)域負責民警String50否姓名、警號、聯(lián)系電話

industAuthorInfo業(yè)委會信息String50否

taxMain繳稅主體String50否

taxId納稅人識別號String18否

publicInfo經(jīng)營信息String200是經(jīng)營時間等

mapImage停車場電子平面圖String否Base64編碼格式

4.4.2收費標準（chargingStandard）

收費標準信息（chargingStandard）如表4所示。

表4收費標準信息

屬性名稱數(shù)據(jù)類型字符長度必須說明

parkCode停車場編號String20是

permitNo停車許可證號String6是

charger收費單位String100是

1：政府定價；

2：政府指導價；

princing定價方式Int是

3：市場調(diào)節(jié)價

4：其他

7

Q/XXXXXXXX—XXXX

表4（續(xù)）

屬性名稱數(shù)據(jù)類型字符長度必須說明

region區(qū)域劃分String否

complaintTel價格投訴電話String5是

remark補充說明String500否

pricingSign收費標價牌圖片String否圖片內(nèi)容BASE64編碼

List<char

items收費項目列表是收費項目信息見表5

gedItem>

表5收費項目信息（chargedItem）

屬性名稱數(shù)據(jù)類型字符長度必須說明

chargeItem收費項目String20是例：小車臨時停放

例：第一小時XX元，第二小時起XX

chargeDesc收費標準描述String100是

元/小時，每天最高收費XX元

4.4.3機械車庫信息（garageInfo）

機械車庫信息（garageInfo）如表6所示。

表6機械車庫信息

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

id機械車庫IDUuid32是記錄ID（全球唯一標識32位Guid）

parkCode停車場編號String20是所屬的停車場編號

garageCode機械車庫編號String22是

garageName機械車庫名稱String50否

operator運營方String50是

owner機械車庫產(chǎn)權(quán)方String50是

maintenance機械車庫維護方String50否

manufacturer制造商String50否

totalStalls總車位數(shù)Int是

1：升降橫移類機械式停車設(shè)備；

2：簡易升降類機械式停車設(shè)備；

3：平面移動類機械式停車設(shè)備；

4：巷道堆垛類機械式停車設(shè)備；

garageType機械車庫類型Int是5：垂直升降類機械式停車設(shè)備；

6：垂直循環(huán)類機械式停車設(shè)備；

7：水平循環(huán)類機械式停車設(shè)備；

8：多層循環(huán)類機械式停車設(shè)備；

9：汽車專用升降機

longitude經(jīng)度Double否

latitude緯度Double否

8

Q/XXXXXXXX—XXXX

4.4.4出入口信息（entranceInfo）

出入口信息（entranceInfo）如表7所示。

表7出入口信息

屬性名稱數(shù)據(jù)類型字符長度必須說明

id出入口IDUuid32是

name名稱String10是

parkCode停車場編號String20否路外停車時應(yīng)提供

garageCode機械車庫編號String22否停放車位屬于機械車庫時須提供

roadName道路String10否

1：入口；

Type出入口類型Int是2：出口；

3：出入口

longitude經(jīng)度Double否

latitude緯度Double否

出入口安裝的設(shè)備列表，如道閘、

List<equi控制機、車牌識別器、地感、機械

equipments關(guān)聯(lián)的設(shè)備列表否

pment>車庫通道、機械車庫升降機等，見

表8

4.4.5設(shè)備信息(equipment)

設(shè)備信息(equipment)如表8所示。

表8設(shè)備信息

屬性名稱數(shù)據(jù)類型字符長度必須說明

id設(shè)備IDUuid32是

parkCode關(guān)聯(lián)停車場編號String20否路外停車時應(yīng)提供

entranceExitId出入口IDUuid32否

garageCode機械車庫編號String22否停放車位屬于機械車庫時須提供

equipmentCode設(shè)備編號String20是

Name設(shè)備名稱String50是

1000：出入口設(shè)備；

3000：車位設(shè)備；

equipmentType設(shè)備類型String4是4000：網(wǎng)關(guān)設(shè)備；

5000：誘導設(shè)備；

6XXX：機械車庫設(shè)備，見附錄A.4

stallNo車位編號String28否

manufacturer制造商String50否

model設(shè)備型號String20否

mfd出廠日期DateTime否

State狀態(tài)Int4是1：使用中；

9

Q/XXXXXXXX—XXXX

表8（續(xù)）

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

2：已停用；

state狀態(tài)Int4是3：維護中；

4：故障

moment狀態(tài)檢測時間DateTime是設(shè)備狀態(tài)檢測時間

4.4.6車位信息(stallInfo)

車位信息(stallInfo)如表9所示。

表9車位信息

屬性名稱數(shù)據(jù)類型字符長度必須說明

stallNo車位編號String28是

parkCode停車場編號String20否路外停車時應(yīng)提供

garageCode機械車庫編號String22否停放車位屬于機械車庫時須提供

0：分時；

1：長期包月；

manageType經(jīng)營類型Int否2：限時段包月；

3：已售；

4：專用車位（如消防）

1：個人；

ownerType產(chǎn)權(quán)類型Int否2：單位；

3：其他

0：路內(nèi)；

positionType位置類型Int是1：路外室內(nèi)；

2：路外室外

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

*高（毫米）】：

1：微型（機械車庫）：

4700*1850*1550；

2：緊湊型（機械車庫）：

5000*1850*1550；

3：中型（機械車庫）：

5300*1900*1850；

sizeType尺寸類型Int否

4：大型（機械車庫）：

5300*1950*2050

5：小型a：

4000*2200

6：中型a：

5000*2500

7：大型a：

15600*3250

10

Q/XXXXXXXX—XXXX

表9(續(xù))

屬性名稱數(shù)據(jù)類型字符長度必須說明

8：子母車位：

sizeType尺寸類型Int否

10000*2500

0：普通車位（平面自走式）；

materialType形態(tài)類型Int是

1：機械車庫車位

0：居住車位；

1：出行車位；

visitType出行性質(zhì)Int否

2：居住和出行兼用；

3：未知

floor所屬樓層String10否

areaName所屬區(qū)域String50否

0：否；

withLocker配置車位鎖標志Int是

1：是

long