基本信息
发布历史
-
2023年02月
研制信息
- 起草单位:
- 深圳市捷顺科技实业股份有限公司、深圳市信息基础设施投资发展有限公司、深圳市停车行业协会、深圳市标准技术研究院、深圳技术大学、智慧互通科技有限公司、深圳市前海亿车科技有限公司、深圳特来电新能源有限公司、深圳市凯达尔科技实业股份有限公司、深圳市易停车库科技有限公司、深圳怡丰自动化科技有限公司、深圳航天信息有限公司、中电科新型智慧城市研究院有限公司、中兴智能交通股份有限公司、百望电子发票数据服务有限公司、深圳市未来智能网联交通系统产业创新中心、深圳道迩环境设计研究院有限公司、北京理工大学深圳汽车研究院。
- 起草人:
- 陈显东、易飞、徐伟剑、郑雷克、高皓、刘颖、任健、陈晓宁、李红清、周凯、段华威、米志立、祁涛、张毅、董晓波、包丽娟、杨舸、杨光东、王益群、李静涛、杨雄基、李淳伟、刘鹏、林坚立、张锟、魏宇、何宝华、徐裕忠、陈镇武、吴新宇、柳庆勇、储斌、王天小、危眀武、王文茜、赵婷婷、胡露、孙超。
- 出版信息:
- 页数: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
定制服务
推荐标准
- HJ 1100-2020 环境空气中颗粒物(PM10和PM2.5)β射线法自动监测技术指南 2020-02-12
- HJ 1099-2020 环境空气臭氧监测一级校准技术规范 2020-02-12
- HJ1097-2020 污染源源强核算技术指南 汽车制造 2020-01-17
- HJ1096-2020 污染源源强核算技术指南 陶瓷制品制造 2020-01-17
- HJ 1120-2020 排污许可证申请与核发技术规范 水处理通用工序 2020-03-13
- HJ1095-2020 芬顿氧化法废水处理工程技术规范 2020-01-14
- HJ 1112-2020 环境影响评价技术导则 广播电视 2020-02-27
- HJ 1113-2020 输变电建设项目环境保护技术要求 2020-02-27
- HJ 1098-2020 水华遥感与地面监测评价技术规范 2020-02-12
- HJ471-2020 纺织染整工业废水治理工程技术规范 2020-01-14