DB4403 T 313-2023 智慧停车 业务数据接口规范.pdf
《DB4403 T 313-2023 智慧停车 业务数据接口规范.pdf》由会员分享,可在线阅读,更多相关《DB4403 T 313-2023 智慧停车 业务数据接口规范.pdf(137页珍藏版)》请在麦多课文档分享上搜索。
1、ICS 35.240.01 CCS L 67 DB4403深圳市地方标准DB4403/T 3132023 智慧停车 业务数据与接口规范 Smart parkingBusiness data and interfaces specifications 2023-02-10 发布2023-03-01 实施深圳市市场监督管理局 发 布DB4403/T 3132023 I 目次 前言.II 1 范围.1 2 规范性引用文件.1 3 术语和定义.1 4 缩略语.3 5 系统架构.3 6 接口规范.19 附录 A(规范性)编码.51 附录 B(规范性)充电桩接口.55 附录 C(资料性)常见场景流程.68
2、 附录 D(资料性)接口使用示例.80 参考文献.133 DB4403/T 3132023 II 前 言 本文件按照GB/T 1.12020标准化工作导则 第1部分:标准化文件的结构和起草规则的规定起草。本文件由深圳市公安局交通警察局提出并归口。本文件起草单位:深圳市捷顺科技实业股份有限公司、深圳市信息基础设施投资发展有限公司、深圳市停车行业协会、深圳市标准技术研究院、深圳技术大学、智慧互通科技有限公司、深圳市前海亿车科技有限公司、深圳特来电新能源有限公司、深圳市凯达尔科技实业股份有限公司、深圳市易停车库科技有限公司、深圳怡丰自动化科技有限公司、深圳航天信息有限公司、中电科新型智慧城市研究院有
3、限公司、中兴智能交通股份有限公司、百望电子发票数据服务有限公司、深圳市未来智能网联交通系统产业创新中心、深圳道迩环境设计研究院有限公司、北京理工大学深圳汽车研究院。本文件主要起草人:陈显东、易飞、徐伟剑、郑雷克、高皓、刘颖、任健、陈晓宁、李红清、周凯、段华威、米志立、祁涛、张毅、董晓波、包丽娟、杨舸、杨光东、王益群、李静涛、杨雄基、李淳伟、刘鹏、林坚立、张锟、魏宇、何宝华、徐裕忠、陈镇武、吴新宇、柳庆勇、储斌、王天小、危眀武、王文茜、邱达赖、赵婷婷、胡露、孙超。DB4403/T 3132023 1 智慧停车 业务数据与接口规范 1 范围 本文件规定了智慧停车业务中,城市停车管理平台与各方系统或
4、平台之间的系统架构、接口规范。本文件适用于第三方停车、充电、机械车库等系统或平台与城市停车管理平台之间的停车信息交换。2 规范性引用文件 下列文件中的内容通过文中的规范性引用而构成本文件必不可少的条款。其中,注日期的引用文件,仅该日期对应的版本适用于本文件。不注日期的引用文件,其最新版本(包括所有的修改单)适用于本文件。GB/T 2260 中华人民共和国行政区划代码 GB/T 10114 县以下行政区划代码编制规则 GB 11643 公民身份号码 GB/T 35789.12017 机动车电子标识通用规范 第1部分:汽车 DB4403/T 89 智慧停车 基础信息编码技术规范 DB4403/T
5、3052022 智慧停车 清分结算业务规范 3 术语和定义 DB4403/T 3052022 界定的以及下列术语和定义适用于本文件。3.1 城市停车管理平台 urban parking management platform 运用物联网、云计算、大数据等技术,通过与第三方停车、充电、机械车库等系统或平台的对接,获取、处理停车场停车信息,将各停车资源互联互通实现停车资源共享、一账通行等,向社会大众提供车位诱导、车位信息查询、共享停车等服务的系统。来源:DB4403/T 3052022,3.1 注:本文件中涉及第三方是除停车管理平台以外的系统或平台。3.2 第三方停车平台 third party
6、parking platform 用于对路内停车泊位或路外停车场进行统一运营、监控、运维管理的系统或平台。3.3 充电运营服务平台 charging operation service platform 实现电动汽车充电和电池更换相关业务的数据采集、数据存储、统计分析、运营方式、营业服务以及调度管理的系统或平台。3.4 第三方机械车库运营平台 third party mechanical garage operation platform 对机械车库使用状态等信息进行采集、处理、存储、管理和服务,并将相关数据上传到行业主管部门监控平台的系统。DB4403/T 3132023 2 3.5 第三方
7、电子发票服务平台 third party electronic invoice issuing service platform 由第三方单位提供的用于开具电子发票的服务和发票管理的系统或平台。3.6 电子政务平台 e-government platform 政府在行使其管理和服务职能时运用现代信息和通信技术,实现政府组织间数据共享、业务互通,从而更系统、高效地向社会提供公共服务的系统或平台。3.7 城市停车诱导平台 urban parking guidance platform 通过在城市的主要交通道路上设置停车诱导信息发布装置等方式,向车辆驾驶者提供停车场位置、车位使用状况及行车方向指示的
8、系统或平台。3.8 清分结算平台 clearing settlement platform 用于城市停车管理平台与第三方停车平台或第三方机械车库运营平台等对线上支付的对账、清分、结算、付款的系统。来源:DB4403/T 3052022,3.3 3.9 停车场 parking lot 专用于车辆停放的场所。来源:GB 500672014,2.0.3,有修改 3.10 路内停车区 on-street parking zone 利用城市道路一侧或两侧,按照相关法律、规定的要求划出的可供车辆停放的区域。来源:DB4403/T 3122023,3.1 3.11 路外停车场 off-street park
9、ing lots 道路以外兴建的停车场。3.12 车位 parking space 为停放车辆而设置的停车位置。3.13 停车订单 parking order 由第三方停车平台产生的待缴费凭据。注:包含订单编号、车辆入场时间、车辆出场时间、车牌号码、停车时长、应缴金额、优惠金额等信息。3.14 停车收费记录 parking payment record 停车用户根据停车订单完成缴费后形成的支付信息。注:包含缴费流水、停车订单、出场优惠、实收、其他费用、收费类型等信息。3.15 共享停车 shared parking 拥有车位产权或使用权的组织、个人,在车位空闲时面向社会提供周期性停车的服务。3
10、.16 无感支付 non-inductive payment 通过车辆识别技术实现的快捷支付服务的方式。DB4403/T 3132023 3 3.17 全景图 panorama 包含完整车辆、整体车位以及附属设施的图像。4 缩略语 下列缩略语适用于本文件。API:应用程序编程接口(Application Programming Interface)APP:应用程序(Application)ID:标识编码(Identification)JSON:JS对象简谱(JavaScript Object Notation)MD5:信息摘要算法第5版(Message Digest Algorithm 5)N
11、TP:网络时间协议(Network Time Protocol)TCP:传输控制协议(Transmission Control Protocol)HTTPS:超文本传输安全协议(Hypertext Transfer Protocol Secure)TLS:安全传输层协议(Transport Layer Security)URL:统一资源定位系统(Uniform Resource Locator)5 系统架构 5.1 系统整体架构 城市停车管理平台与第三方停车平台、第三方机械车库运营平台、城市停车诱导平台、充电运营服务平台以及清分结算平台(以下统称为“外部系统或平台”)数据交互。架构图见图1。城
12、市停车管理平台城市停车诱导平台充电运营服务平台第三方停车平台第三方机械车库运营平台清分结算平台第三方电子发票开具服务平台政府数据平台城市停车APP微信公众号支付宝服务号其他 图1 城市停车管理平台架构图 5.2 接口清单 接口清单应符合表1的规定。DB4403/T 3132023 4 表1 接口清单 接口编号 接口说明 支持协议 方向 1001 登录(https)https 上行 1002 刷新 Token(https)https 上行 1003 登出(https)https 上行 1004 登录(TCP)TCP 上行 1005 登出(TCP)TCP 上行 1006 心跳(TCP)TCP 上行
13、 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
14、 记录校正信息上报 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 查询停车费
15、https/TCP 下行 6007 订单支付成功通知下发 https/TCP 下行 6008 车辆代扣签约状态变更通知 https/TCP 下行 6009 月租车租约查询 https 上行 6010 月租车延期 https 下行 8001 机械车库信息上报 https 上行 8002 机械车库运行状态信息上报 https 上行 8003 机械车库剩余车位信息上报 https 上行 8004 机械车库存车接口 https 下行 DB4403/T 3132023 5 表1 接口清单(续)接口编号 接口说明 支持协议 方向 8005 机械车库取车接口 https 下行 9001 停车场信息推送 ht
16、tps/TCP 下行 1101 备案充换电设备信息 https上行 1102 推送设备状态 https上行 1103 充电业务信息交换 https上行 1104 充电订单信息上报 https上行 1105 充电订单信息推送 https 上行 1106 充电订单信息查询 https 下行 1201 电子发票开具接口 https 上行 1202 发票库存查询接口 https 上行 1301 公共信用信息上报 https 上行 1401 请求订单 https 上行 注1:上行:第三方停车平台、第三方机械车库运营平台、城市停车诱导平台以及清分结算平台作为发起方,发送数据给城市停车管理平台的接口。注2:
17、下行:停车管理平台作为发起方,发送数据给第三方停车平台、第三方机械车库运营平台、城市停车诱导平台以及清分结算平台的接口。5.3 基础数据类型 基础数据应符合表 2 的规定。其中,停车场编号、车位编号应符合 DB4403/T 89 的规定。表2 基础数据类型清单 类型名称 长度 基础类型(json)描述 String Na String 字符串 Long 8字节 Number 长整型 Int 4字节 Number 整型 Boolean 1字节 Boolean 布尔型 Float 4字节 Number 浮点型 Double 8字节 Number 双精度浮点 Decimal 16字节 Number
18、高精度浮点 Date 10字符 String 日期,格式“yyyy-MM-dd”DateTime 19字符 String 日期时间,格式“yyyy-MM-dd HH:mm:ss”Time 8字符 String 时间,格式“HH:mm:ss”Timestamp 4字节 Number 时间戳,1970-01-01 00:00:00 起的秒数 Uuid 32字符 String 全球唯一ID Object Nb Object 对象,用具体数据类型表示 例:停车场信息为parkInfo,后续引用时直接使用parkInfo List Nb Array 数组,用List表示 例:引用停车场信息列表时,使用L
19、ist表示 DB4403/T 3132023 6 表 2 基础数据类型清单(续)类型名称 长度 基础类型(json)描述 注1:未作特殊说明情况下,本文件中涉及的金额统一采用数据类型Decimal,单位为元,精度为小数点后2位。注2:无特殊说明,本文件中的经纬度均为GCJ 02坐标系坐标。注3:后文的数据中未写明长度的数据类型的字符长度以本表规定为准。注4:Na 表示各属性(名称)已有对应长度,Nb表示引用其他对象,不需界定字符长度。5.4 停车实体信息 5.4.1 停车场信息(parkInfo)停车场信息(parkInfo)清单应符合表3的规定。表3 停车场信息清单 属性 名称 数据类型 字
20、符长度 必须 说明 parkCode 停车场编号 String 20 是 parkName 停车场名称 String 255 是 parkType 停车场类型 Int 是 0:路内停车区;1:室内停车场;2:室外停车场 isGarage 否是有机械车库 Int 否 0:否;1:是 chargingStandard 收费标准 Object 否 收费的经营性停车场应提供,收费标准应符合表4的规定 province 省份 String 10 否 city 城市 String 10 否 district 行政区 String 10 否 area 片区 String 10 否 districtCode
21、行政区代码 String 9 是 行政区代码应符合GB/T 2260、GB/T 10114的规定 roadName 道路名称 String 10 是 address 停车场详细地址 String 255 否 totalSpaces 总车位数 Int 是 reservableSpaces 总可预约车位数 Int 否 支持车位预约的停车场应提供 sharedSpaces 总共享停车车位数 Int 否 支持共享停车的停车场应提供longitude 经度 Double 否 latitude 纬度 Double 否 shenzhenX 深圳独立坐标X Double 否 shenzhenY 深圳独立坐标Y
22、 Double 否 shenzhenH 深圳独立坐标H Double 否 operatorId 停车场运营方编号 String 10 是 由城市停车管理平台统一分配 owner 停车场产权方 String 50 是 garagesmaintainer 停车场维护方 String 50 否 二级运营商 DB4403/T 3132023 7 表 3 停车场信息清单(续)属性 名称 数据类型 字符长度 必须 说明 serviceType 服务属性 Int 是 1:商业;2:住宅;3:医院;4:园区;5:交通枢纽;6:行政机关;7:学校;8:其它 garagesInfoTable 机械车库ID列表 L
23、ist 否 机械车库信息应符合表7的规定 affiliatedStation 所属派出所 String 50 否 所属派出所名称 responsibleOfficer 区域负责民警 String 50 否 姓名、警号、联系电话 committeeInfo 业委会信息 String 50 否 taxpayer 缴税主体 String 50 否 taxpayerId 纳税人识别号 String 18 否 stationInfotable 充电站关系列表 List 否 充电站信息列表应符合表6的规定 publicInfo 经营信息 String 200 是 经营时间等(如6:008:00)5.4.2
24、 收费标准(chargingStandard)收费标准(chargingStandard)清单应符合表4的规定。表4 收费标准清单 属性 名称 数据类型 字符长度 必须 说明 parkCode 停车场编号 String 20 是 permitNo 停车许可证号 String 6 是 charger 收费单位 String 100 是 princing 定价方式 Int 是 1:政府定价;2:政府指导价;3:市场调节价 region 区域划分 Int 是 1:一类地区;2:二类地区;3:三类地区。区域划分内容见深圳市发展和改革委员会关于完善我市机动车停放服务收费政策的通知 complaintTe
25、l 价格投诉电话 String 20 是 remark 补充说明 String 500 否 pricingSign 收费标价牌图片 String 否 图片内容BASE64编码 chargeItemstable 收费项目列表 List 是 收费项目列表应符合表5的规定 DB4403/T 3132023 8 表5 收费项目列表 属性 名称 数据类型 字符长度 必须 说明 chargeItem 收费项目 String 20 是 例:小型车临时停放 chargeDesc 收费标准描述 String 255 是 例:第一小时XX元,第二小时起XX元/小时,每天最高收费XX元 5.4.3 充电站信息(st
- 1.请仔细阅读文档,确保文档完整性,对于不预览、不比对内容而直接下载带来的问题本站不予受理。
- 2.下载的文档,不会出现我们的网址水印。
- 3、该文档所得收入(下载+内容+预览)归上传者、原创作者;如果您是本文档原作者,请点此认领!既往收益都归您。
下载文档到电脑,查找使用更方便
5000 积分 0人已下载
下载 | 加入VIP,交流精品资源 |
- 配套讲稿:
如PPT文件的首页显示word图标,表示该PPT已包含配套word讲稿。双击word图标可打开word文档。
- 特殊限制:
部分文档作品中含有的国旗、国徽等图片,仅作为作品整体效果示例展示,禁止商用。设计者仅对作品中独创性部分享有著作权。
- 关 键 词:
- DB4403 313-2023 智慧停车 业务数据接口规范 313 2023 智慧 停车 业务 数据 接口 规范
