DB4403/T 313-2023 智慧停车 业务数据接口规范

DB4403/T 313-2023

广东省地方标准 简体中文 废止 页数:137页 | 格式:PDF

基本信息

标准号
DB4403/T 313-2023
标准类型
广东省地方标准
标准状态
废止
中国标准分类号(CCS)
国际标准分类号(ICS)
发布日期
2023-02-10
实施日期
2023-03-01
发布单位/组织
深圳市市场监督管理局
归口单位
深圳市公安局交通警察局
适用范围
本文件适用于第三方停车、充电、机械车库等系统或平台与城市停车管理平台之间的停车信息交换。

发布历史

研制信息

起草单位:
深圳市捷顺科技实业股份有限公司、深圳市信息基础设施投资发展有限公司、深圳市停车行业协会、深圳市标准技术研究院、深圳技术大学、智慧互通科技有限公司、深圳市前海亿车科技有限公司、深圳特来电新能源有限公司、深圳市凯达尔科技实业股份有限公司、深圳市易停车库科技有限公司、深圳怡丰自动化科技有限公司、深圳航天信息有限公司、中电科新型智慧城市研究院有限公司、中兴智能交通股份有限公司、百望电子发票数据服务有限公司、深圳市未来智能网联交通系统产业创新中心、深圳道迩环境设计研究院有限公司、北京理工大学深圳汽车研究院。
起草人:
陈显东、易飞、徐伟剑、郑雷克、高皓、刘颖、任健、陈晓宁、李红清、周凯、段华威、米志立、祁涛、张毅、董晓波、包丽娟、杨舸、杨光东、王益群、李静涛、杨雄基、李淳伟、刘鹏、林坚立、张锟、魏宇、何宝华、徐裕忠、陈镇武、吴新宇、柳庆勇、储斌、王天小、危眀武、王文茜、赵婷婷、胡露、孙超。
出版信息:
页数:137页 | 字数:- | 开本: -

内容描述

ICS35.240.01

CCSL67

DB4403

深圳市地方标准

DB4403/T313—2023

智慧停车业务数据与接口规范

Smartparking—Businessdataandinterfacesspecifications

2023-02-10发布2023-03-01实施

深圳市市场监督管理局发布

DB4403/T313—2023

目次

前言II

1范围1

2规范性引用文件1

3术语和定义1

4缩略语3

5系统架构3

6接口规范19

附录A(规范性)编码51

附录B(规范性)充电桩接口55

附录C(资料性)常见场景流程68

附录D(资料性)接口使用示例80

参考文献133

I

DB4403/T313—2023

前言

本文件按照GB/T1.1—2020《标准化工作导则第1部分:标准化文件的结构和起草规则》的规定

起草。

本文件由深圳市公安局交通警察局提出并归口。

本文件起草单位:深圳市捷顺科技实业股份有限公司、深圳市信息基础设施投资发展有限公司、深

圳市停车行业协会、深圳市标准技术研究院、深圳技术大学、智慧互通科技有限公司、深圳市前海亿车

科技有限公司、深圳特来电新能源有限公司、深圳市凯达尔科技实业股份有限公司、深圳市易停车库科

技有限公司、深圳怡丰自动化科技有限公司、深圳航天信息有限公司、中电科新型智慧城市研究院有限

公司、中兴智能交通股份有限公司、百望电子发票数据服务有限公司、深圳市未来智能网联交通系统产

业创新中心、深圳道迩环境设计研究院有限公司、北京理工大学深圳汽车研究院。

本文件主要起草人:陈显东、易飞、徐伟剑、郑雷克、高皓、刘颖、任健、陈晓宁、李红清、周凯、

段华威、米志立、祁涛、张毅、董晓波、包丽娟、杨舸、杨光东、王益群、李静涛、杨雄基、李淳伟、

刘鹏、林坚立、张锟、魏宇、何宝华、徐裕忠、陈镇武、吴新宇、柳庆勇、储斌、王天小、危眀武、王

文茜、邱达赖、赵婷婷、胡露、孙超。

II

DB4403/T313—2023

智慧停车业务数据与接口规范

1范围

本文件规定了智慧停车业务中,城市停车管理平台与各方系统或平台之间的系统架构、接口规范。

本文件适用于第三方停车、充电、机械车库等系统或平台与城市停车管理平台之间的停车信息交换。

2规范性引用文件

下列文件中的内容通过文中的规范性引用而构成本文件必不可少的条款。其中,注日期的引用文件,

仅该日期对应的版本适用于本文件。不注日期的引用文件,其最新版本(包括所有的修改单)适用于本

文件。

GB/T2260中华人民共和国行政区划代码

GB/T10114县以下行政区划代码编制规则

GB11643公民身份号码

GB/T35789.1—2017机动车电子标识通用规范第1部分:汽车

DB4403/T89智慧停车基础信息编码技术规范

DB4403/T305—2022智慧停车清分结算业务规范

3术语和定义

DB4403/T305—2022界定的以及下列术语和定义适用于本文件。

3.1

城市停车管理平台urbanparkingmanagementplatform

运用物联网、云计算、大数据等技术,通过与第三方停车、充电、机械车库等系统或平台的对接,

获取、处理停车场停车信息,将各停车资源互联互通实现停车资源共享、一账通行等,向社会大众提供

车位诱导、车位信息查询、共享停车等服务的系统。

[来源:DB4403/T305—2022,3.1]

注:本文件中涉及第三方是除停车管理平台以外的系统或平台。

3.2

第三方停车平台thirdpartyparkingplatform

用于对路内停车泊位或路外停车场进行统一运营、监控、运维管理的系统或平台。

3.3

充电运营服务平台chargingoperationserviceplatform

实现电动汽车充电和电池更换相关业务的数据采集、数据存储、统计分析、运营方式、营业服务以

及调度管理的系统或平台。

3.4

第三方机械车库运营平台thirdpartymechanicalgarageoperationplatform

对机械车库使用状态等信息进行采集、处理、存储、管理和服务,并将相关数据上传到行业主管部

门监控平台的系统。

1

DB4403/T313—2023

3.5

第三方电子发票服务平台thirdpartyelectronicinvoiceissuingserviceplatform

由第三方单位提供的用于开具电子发票的服务和发票管理的系统或平台。

3.6

电子政务平台e-governmentplatform

政府在行使其管理和服务职能时运用现代信息和通信技术,实现政府组织间数据共享、业务互通,

从而更系统、高效地向社会提供公共服务的系统或平台。

3.7

城市停车诱导平台urbanparkingguidanceplatform

通过在城市的主要交通道路上设置停车诱导信息发布装置等方式,向车辆驾驶者提供停车场位置、

车位使用状况及行车方向指示的系统或平台。

3.8

清分结算平台clearingsettlementplatform

用于城市停车管理平台与第三方停车平台或第三方机械车库运营平台等对线上支付的对账、清分、

结算、付款的系统。

[来源:DB4403/T305—2022,3.3]

3.9

停车场parkinglot

专用于车辆停放的场所。

[来源:GB50067—2014,2.0.3,有修改]

3.10

路内停车区on-streetparkingzone

利用城市道路一侧或两侧,按照相关法律、规定的要求划出的可供车辆停放的区域。

[来源:DB4403/T312—2023,3.1]

3.11

路外停车场off-streetparkinglots

道路以外兴建的停车场。

3.12

车位parkingspace

为停放车辆而设置的停车位置。

3.13

停车订单parkingorder

由第三方停车平台产生的待缴费凭据。

注:包含订单编号、车辆入场时间、车辆出场时间、车牌号码、停车时长、应缴金额、优惠金额等信息。

3.14

停车收费记录parkingpaymentrecord

停车用户根据停车订单完成缴费后形成的支付信息。

注:包含缴费流水、停车订单、出场优惠、实收、其他费用、收费类型等信息。

3.15

共享停车sharedparking

拥有车位产权或使用权的组织、个人,在车位空闲时面向社会提供周期性停车的服务。

3.16

无感支付non-inductivepayment

通过车辆识别技术实现的快捷支付服务的方式。

2

DB4403/T313—2023

3.17

全景图panorama

包含完整车辆、整体车位以及附属设施的图像。

4缩略语

下列缩略语适用于本文件。

API:应用程序编程接口(ApplicationProgrammingInterface)

APP:应用程序(Application)

ID:标识编码(Identification)

JSON:JS对象简谱(JavaScriptObjectNotation)

MD5:信息摘要算法第5版(MessageDigestAlgorithm5)

NTP:网络时间协议(NetworkTimeProtocol)

TCP:传输控制协议(TransmissionControlProtocol)

HTTPS:超文本传输安全协议(HypertextTransferProtocolSecure)

TLS:安全传输层协议(TransportLayerSecurity)

URL:统一资源定位系统(UniformResourceLocator)

5系统架构

5.1系统整体架构

城市停车管理平台与第三方停车平台、第三方机械车库运营平台、城市停车诱导平台、充电运营服

务平台以及清分结算平台(以下统称为“外部系统或平台”)数据交互。架构图见图1。

城市停车APP微信公众号支付宝服务号其他

清分

结算

城市停车诱导平台充电运营服务平台平台

政府

数据城市停车管理平台

平台

第三

方电

子发

票开

第三方机械车库运营

第三方停车平台具服

平台务平

图1城市停车管理平台架构图

5.2接口清单

接口清单应符合表1的规定。

3

DB4403/T313—2023

表1接口清单

接口编号接口说明支持协议方向

1001登录(https)https上行

1002刷新Token(https)https上行

1003登出(https)https上行

1004登录(TCP)TCP上行

1005登出(TCP)TCP上行

1006心跳(TCP)TCP上行

2001图片上传接口https上行

2002系统事件上报https上行

3001停车场信息上报https上行

3002出入口信息上报https上行

3003设备信息上报https上行

3004车位信息上报https上行

3005停车场收费标准信息上报https上行

4001车辆管控名单下发https/TCP下行

5001车位状态变更上报https上行

5002设备状态信息上报https上行

5003场内车位数上报https上行

5004车辆驶入信息上报https上行

5005车辆驶离信息上报https上行

5006记录校正信息上报https上行

5007请求支付https上行

5008车辆收费记录上报https上行

5009车辆退费信息上报https上行

5010请求车辆代扣验签https上行

5011出入口状态变更上报https上行

5012月租车租约信息更新上报https上行

6001车位预约锁定https/TCP下行

6002车位预约确定https/TCP下行

6003车辆锁车/解锁指令下发https/TCP下行

6004共享停车信息下发https/TCP下行

6005场内车辆查询https/TCP下行

6006查询停车费https/TCP下行

6007订单支付成功通知下发https/TCP下行

6008车辆代扣签约状态变更通知https/TCP下行

6009月租车租约查询https上行

6010月租车延期https下行

8001机械车库信息上报https上行

8002机械车库运行状态信息上报https上行

8003机械车库剩余车位信息上报https上行

8004机械车库存车接口https下行

4

DB4403/T313—2023

表1接口清单(续)

接口编号接口说明支持协议方向

8005机械车库取车接口https下行

9001停车场信息推送https/TCP下行

1101备案充换电设备信息https上行

1102推送设备状态https上行

1103充电业务信息交换https上行

1104充电订单信息上报https上行

1105充电订单信息推送https上行

1106充电订单信息查询https下行

1201电子发票开具接口https上行

1202发票库存查询接口https上行

1301公共信用信息上报https上行

1401请求订单https上行

注1:上行:第三方停车平台、第三方机械车库运营平台、城市停车诱导平台以及清分结算平台作为发起方,发

送数据给城市停车管理平台的接口。

注2:下行:停车管理平台作为发起方,发送数据给第三方停车平台、第三方机械车库运营平台、城市停车诱导

平台以及清分结算平台的接口。

5.3基础数据类型

基础数据应符合表2的规定。其中,停车场编号、车位编号应符合DB4403/T89的规定。

表2基础数据类型清单

类型名称长度基础类型(json)描述

StringNaString字符串

Long8字节Number长整型

Int4字节Number整型

Boolean1字节Boolean布尔型

Float4字节Number浮点型

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起的秒数

Uuid32字符String全球唯一ID

对象,用具体数据类型表示

ObjectNbObject

例:停车场信息为parkInfo,后续引用时直接使用parkInfo

数组,用List<>表示

ListNbArray

例:引用停车场信息列表时,使用List<parkInfo>表示

5

DB4403/T313—2023

表2基础数据类型清单(续)

类型名称长度基础类型(json)描述

注1:未作特殊说明情况下,本文件中涉及的金额统一采用数据类型Decimal,单位为元,精度为小数点后2位。

注2:无特殊说明,本文件中的经纬度均为GCJ02坐标系坐标。

注3:后文的数据中未写明长度的数据类型的字符长度以本表规定为准。

注4:Na表示各属性(名称)已有对应长度,Nb表示引用其他对象,不需界定字符长度。

5.4停车实体信息

5.4.1停车场信息(parkInfo)

停车场信息(parkInfo)清单应符合表3的规定。

表3停车场信息清单

属性名称数据类型字符长度必须说明

parkCode停车场编号String20是—

parkName停车场名称String255是—

0:路内停车区;1:室内停车场;

parkType停车场类型Int—是

2:室外停车场

isGarage否是有机械车库Int—否0:否;1:是

收费的经营性停车场应提供,收费标

chargingStandard收费标准Object—否

准应符合表4的规定

province省份String10否—

city城市String10否—

district行政区String10否—

area片区String10否—

行政区代码应符合GB/T2260、GB/T

districtCode行政区代码String9是

10114的规定

roadName道路名称String10是—

address停车场详细地址String255否—

totalSpaces总车位数Int—是—

reservableSpaces总可预约车位数Int—否支持车位预约的停车场应提供

sharedSpaces总共享停车车位数Int—否支持共享停车的停车场应提供

longitude经度Double—否—

latitude纬度Double—否—

shenzhenX深圳独立坐标XDouble—否—

shenzhenY深圳独立坐标YDouble—否—

shenzhenH深圳独立坐标HDouble—否—

operatorId停车场运营方编号String10是由城市停车管理平台统一分配

owner停车场产权方String50是—

garagesmaintaine

停车场维护方String50否二级运营商

r

6

DB4403/T313—2023

表3停车场信息清单(续)

属性名称数据类型字符长度必须说明

1:商业;2:住宅;3:医院;

serviceType服务属性Int—是4:园区;5:交通枢纽;6:行政机

关;7:学校;8:其它

List<Str

garagesInfoTable机械车库ID列表—否机械车库信息应符合表7的规定

ing>

affiliatedStatio

所属派出所String50否所属派出所名称

n

responsibleOffic

区域负责民警String50否姓名、警号、联系电话

er

committeeInfo业委会信息String50否—

taxpayer缴税主体String50否—

taxpayerId纳税人识别号String18否—

List<sta

stationInfotable充电站关系列表tionName—否充电站信息列表应符合表6的规定

Info>

publicInfo经营信息String200是经营时间等(如6:00~8:00)

5.4.2收费标准(chargingStandard)

收费标准(chargingStandard)清单应符合表4的规定。

表4收费标准清单

属性名称数据类型字符长度必须说明

parkCode停车场编号String20是—

permitNo停车许可证号String6是—

charger收费单位String100是—

1:政府定价;2:政府指导价;3:市场调

princing定价方式Int—是

节价

1:一类地区;2:二类地区;3:三类地区。

区域划分内容见《深圳市发展和改革委员

region区域划分Int—是

会关于完善我市机动车停放服务收费政策

的通知》

complaintTel价格投诉电话String20是—

remark补充说明String500否—

pricingSign收费标价牌图片String—否图片内容BASE64编码

chargeItemstList<char

收费项目列表—是收费项目列表应符合表5的规定

ablegeItems>

7

DB4403/T313—2023

表5收费项目列表

属性名称数据类型字符长度必须说明

chargeItem收费项目String20是例:小型车临时停放

例:第一小时XX元,第二小时起XX元

chargeDesc收费标准描述String255是

/小时,每天最高收费XX元

5.4.3充电站信息(stationNameInfo)

充电站信息(stationNameInfo)应符合表6的规定。

表6充电站信息列表

属性名称数据类型字符长度必须说明

operatorID充电运营商IDString9是—

operatorName充电运营商名称String65是—

stationID充电站IDString20是充电站唯一编码,运营商提供

stationName充电站名称String50是—

5.4.4机械车库信息(garageInfo)

机械车库信息(garageInfo)应符合表7的规定。

表7机械车库信息列表

属性名称数据类型字符长度必须说明

id机械车库IDUuid32是记录ID(全球唯一标识32位Guid)

parkCode

定制服务

    相似标准推荐

    更多>