DB4403∕T 315-2023 停车库(场)预约共享数据接口规范.pdf
《DB4403∕T 315-2023 停车库(场)预约共享数据接口规范.pdf》由会员分享,可在线阅读,更多相关《DB4403∕T 315-2023 停车库(场)预约共享数据接口规范.pdf(83页珍藏版)》请在咨信网上搜索。
1、 DB4403/T 3152023 停车库(场)预约共享数据接口规范 Specification for reservation and shared data interface of parking lots 2023-02-15 发布 2023-03-01 实施 深圳市市场监督管理局 发 布 深圳市地方标准 ICS 35.240.01 CCS L 67 DB4403 DB4403/T 3152023 I 目 次 前言.II 1 范围.1 2 规范性引用文件.1 3 术语和定义.1 4 缩略语.2 5 总体要求.2 6 功能要求.3 7 数据接口要求.4 8 数据传输要求.38 附录 A(
2、规范性)具备预约共享业务功能的停车库(场)建设要求.40 附录 B(资料性)停车业务场景及流程.41 附录 C(规范性)编码定义.47 附录 D(资料性)签名和接口使用示例.49 参考文献.80 DB4403/T 3152023 II 前 言 本文件按照GB/T 1.12020标准化工作导则 第1部分:标准化文件的结构和起草规则的规定起草。本文件由深圳市公安局交通警察局提出并归口。本文件起草单位:深圳市信息基础设施投资发展有限公司、深圳市停车行业协会、深圳市顺易通信息科技有限公司、鹏城智慧共享科技(深圳)有限公司、深圳市博思高科技有限公司、深圳市凯达尔科技实业有限公司、深圳锦沃科技有限公司、深
3、圳市道尔智控科技股份有限公司、深圳市豪位科技有限公司、深圳智优停科技有限公司、深圳市安赛科技有限公司、深圳信路通智能技术有限公司、深圳市奇见科技有限公司、深圳市富士智能股份有限公司、深圳市红门智慧停车科技有限公司、深圳地铁物业管理发展有限公司、深圳市计通智能技术有限公司、深圳市皇驰科技有限公司、深圳市中安测标准技术有限公司。本文件主要起草人:陈显东、陈晓宁、王乐、徐伟剑、郑雷克、蔡志敏、张毅、高皓、何军、李民、吴曲曲、黄应辉、梁峰、董晓波、李静涛、黄钟洪、王桃、何宝华、杨纪刚、黄兰发、方明星、陈明春、李友斌、李志亮、徐纯梁、叶汉中、陈汉、曾北桂、蒋志文、朱志波、曲飞宇、童洪明、白国强、陈在杰、
4、陈鑫、吴金平。DB4403/T 3152023 1 停车库(场)预约共享数据接口规范 1 范围 本文件规定了停车库(场)预约共享停车业务的总体要求、功能要求、数据接口要求、数据传输要求。本文件适用于深圳市范围内停车库(场)管理系统或停车管理平台与预约共享停车平台之间的数据交换以及功能设计与开发。2 规范性引用文件 下列文件中的内容通过文中的规范性引用而构成本文件必不可少的条款。其中,注日期的引用文件,仅该日期对应的版本适用于本文件;不注日期的引用文件,其最新版本(包括所有的修改单)适用于本文件。GB/T 2260 中华人民共和国行政区划代码 GB 5768.2 道路交通标志和标线 第2部分:道
5、路交通标志 GB/T 10114 县级以下行政区划代码编制规则 GA/T 761 停车库(场)安全管理系统技术要求 DB4403/T 89 智慧停车 基础信息编码技术规范 SZJG 44 停车库(场)车辆视频图像和号牌信息采集与传输系统技术要求 3 术语和定义 下列术语和定义适用于本文件。3.1 车位提供方 parking space provider 具有车位产权或使用权,并在一段时间内提供车位的组织或个人。3.2 停车用户 parking space user 接受停车服务的组织或个人。3.3 预约停车 reserved parking 车位提供方(3.1)向停车用户(3.2)提供约定时间
6、内预约入场或预约到位的服务。注:停车用户提前申请、预约才可享受停车服务。3.4 共享停车 shared parking 车位提供方(3.1)在车位空闲时向停车用户(3.2)提供停车的服务。3.5 服务商 parking attendant 为停车库(场)提供预约共享能力解决方案和经营管理服务,协助停车库(场)接入预约共享停车平台的组织或个人。DB4403/T 3152023 2 注:服务商包括但不限于停车库(场)运营(承包)公司、平台厂商、城市停车运营服务平台运营方、物业管 理企业、工程商/集成商、设备厂商等。3.6 预约车辆 parking reservation vehicles 向具备预
7、约停车(3.3)的停车库(场)预约某个时段停车的车辆。3.7 停车库(场)管理系统 parking lots management system 对出入停车库(场)的车辆进行登记、出入认证,监控和管理,提供停车库(场)区内引导、寻找车辆等一系列功能的电子系统或网络。3.8 停车管理平台 parking management platform 用于对路内停车泊位或路外停车场进行统一运营、监控和运维管理的系统或平台。3.9 预约共享停车平台 reservation and shared parking platform 运用物联网、云计算、大数据等技术,通过与第三方停车、充电、机械车库等系统或平台
8、的对接,获取、处理停车库(场)停车信息,将各停车资源互联互通实现停车资源共享、一账通行等,对向社会大众提供目标区域范围内车位寻找、车位引导、预约停车(3.3)、共享停车(3.4)等服务的系统。3.10 流量管控 flow control 根据停车库(场)内剩余车位数,动态调整入场车辆的放行规则。3.11 饱和度 saturation 停车库(场)内停放车辆数与总车位数的比值。注:总车位数指可用于预约和非预约车辆停放的车位总数。4 缩略语 下列缩略语适用于本文件。APP:应用程序(Application)HMACSHA256:使用安全哈希算法256的消息认证码(Hash-based Messag
9、e Authentication Code-Secure Hash Algorithm 256)HTTPS:安全套接字层的超文本传输协议(Hyper Text Transfer Protocol over Secure Socket Layer)ID:标识编码(Identification)MQTT:消息队列遥测传输(Message Queuing Telemetry Transport)NTP:网络时间协议(Network Time Protocol)QoS:服务质量(Quality of Service)5 总体要求 5.1 具备预约共享业务功能的停车库(场)建设应符合附录 A 的规定。D
10、B4403/T 3152023 3 5.2 预约共享停车平台与各停车库(场)管理系统或停车管理平台进行数据对接,预约共享停车业务示意图见图 1,具体接入方式如下:a)预约停车资源或共享停车资源通过停车管理平台接入预约共享停车平台进行数据交互;b)预约停车资源或共享停车资源通过停车库(场)管理系统接入预约共享停车平台进行数据交互。预约停车资源共享停车资源预约停车资源共享停车资源停车库(场)管理系统停车管理平台预约共享停车平台车位提供方服务商平台运营方停车用户用户端 注:实线框表示在本文件界定的范围。图1 预约共享停车业务示意图 5.3 当产生共享停车业务或预约停车业务时,停车业务场景及流程见附录
11、 B。6 功能要求 6.1 通用要求 接入预约共享停车平台的停车库(场)管理系统或停车管理平台应符合以下要求:a)支持向预约共享停车平台提供停车库(场)地理位置(如地址、出入口经纬度)、车位信息(如车位数量)、收费标准等信息,并符合以下要求:1)应保证登记的车位信息真实有效,若车位信息变更,应及时维护;2)应按照登记发布的车位信息提供停车服务,不随意变更。b)支持电子支付功能;c)支持发票开具功能;d)支持对车辆出入事件信息的记录、管理及查询等功能;e)支持向预约共享停车平台上传车辆的入场信息、出场信息、收费记录等功能;f)支持对出入停车库(场)的车辆和车位进行采集、记录、认证、监控及管理等功
12、能;g)支持接收预约共享停车平台的车辆管控名单功能;h)支持预约车辆费用减免、打折优惠等功能。6.2 预约停车 6.2.1 停车库(场)管理系统或停车管理平台应支持接收预约共享停车平台下发的预约停车数据,包括:a)预约信息:车辆信息、预约时间等;b)预约时段变更信息:车辆信息、变更预约时段等;DB4403/T 3152023 4 c)限时取消预约信息:车辆信息、取消预约等;d)预约时段与停车时段信息:未按预约订单起始时间进入停车库(场)的处置规则。6.2.2 停车库(场)管理系统或停车管理平台宜支持将预约车辆入口临时调整成非预约车辆入口的功能。6.2.3 停车库(场)管理系统或停车管理平台宜支
13、持设置停放车辆饱和度的功能。6.2.4 停车库(场)管理系统或停车管理平台应支持开启或关闭预约车辆优先通行功能,并向预约共享停车平台通知其开启或关闭的状态信息。6.2.5 停车库(场)管理系统或停车管理平台宜支持根据饱和度动态调整流量管控规则保障预约车辆优先通行的功能。6.3 共享停车 6.3.1 停车库(场)管理系统或停车管理平台应向预约共享停车平台上报以下信息:a)共享方案信息:车位共享方案类型、车型限制、车位停放时段、有效期等;b)支付结果信息:共享方案订单编号、订单类型、支付结果状态、支付方式等;c)超时订单信息:共享方案订单编号、超时订单编号、车牌号码、入场时间、出场时间、超时时间等
14、;d)退款结果信息:退款流水号、共享方案订单编号、订单类型、退款状态等;e)订单信息变更信息:共享方案订单编号、订单状态、车牌号码、开始日期、结束日期等。6.3.2 停车库(场)管理系统或停车管理平台应接收预约共享停车平台下发以下信息:a)共享停车订单信息:车辆信息、共享时段等;b)共享停车时段变更信息:车辆信息、变更预约时段等;c)共享停车限时取消信息:车辆信息、取消预约等。7 数据接口要求 7.1 概述 停车库(场)管理系统或停车管理平台与预约共享停车平台对接前,服务商向预约共享停车平台运营方提出接入申请,并进行数据对接。7.2 基础数据类型 基础数据应符合表 1 的要求,其中停车库(场)
15、编号、车位编号应符合 DB4403/T 89 的要求。表1 基础数据类型清单 类型名称 长度 基础类(json)说明 String Na String 字符串 Long 8 字节 Number 长整型 Int 4 字节 Number 整型 Boolean 1 字节 Boolean 布尔型 Float 4 字节 Number 浮点型 DB4403/T 3152023 5 表 1 基础数据类型清单(续)类型名称 长度 基础类(json)说明 Double 8 字节 Number 双精度浮点 Decimal 16 字节 Number 高精度浮点 Date 10 字符 String 日期,格式“yyy
16、y-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:00 起的秒数 Uuid 32 字符 String 全球唯一 ID Object Nb Object 对象 List Nb Array 数组 注1:未作特殊说明情况下,本文件中涉及的金额统一采用数据类型Decimal,单位为元,精度为小数点后2位。注2:无特殊说明,本文件中的经纬度均为GCJ-02坐标系坐标。注3:后文的数据定
17、义中未写明长度的数据类型的字符长度以本表规定为准。注4:Na表示根据各属性(名称)定义其字符长度,Nb表示引用其他对象。7.3 接口要求 7.3.1 协议使用要求 7.3.1.1 对接要求 停车库(场)管理系统或停车管理平台在对接预约共享停车平台前,按预约共享停车平台的管理要求,准备信息包括但不限于:a)注册获取平台服务器地址、对接账号(HTTPS 对接的使用的 userId/clientId、password及盐值 salt)信息等;b)向预约共享停车平台提供服务器 IP 地址(可选)。7.3.1.2 基本要求 基本要求如下:a)传输格式:JSON;b)编码格式:UTF-8;c)属性命名规范
18、:小驼峰形式(如:deviceId);d)协议要求:HTTPS 或 MQTT;e)使用接口一次发送数据的大小不应超过 10M 字节;f)预约共享停车平台、停车管理平台采用如 NTP 时间同步技术和北京时间保持同步;g)接口请求超时时间限制:20 秒以内;h)请求数据基本格式见表 2,应答数据基本格式见表 3;i)编码定义应符合附录 C 的规定;j)签名和接口使用示例见附录 D。DB4403/T 3152023 6 表2 请求数据基本格式 属性 名称 数据类型 字符长度 必须 说明 timestamp 时间戳 Timestamp 4 是 sign 签名 String 是 签名算法 HMACSHA
19、256,key 值使用平台分配的盐值 salt,对 data 数据进行签名 data 请求数据 List 是 根据接口不同请求数据不同 表3 应答数据基本格式 属性 名称 数据类型 字符长度 必须 说明 code 系统编码 Int 是 通用错误编码见表 C.1 message 系统消息 String 255 否 系统编码对应的消息 timestamp 时间戳 Timestamp 是 data 返回数据 List 是 根据接口不同返回数据不同 7.3.1.3 HTTPS 接口要求 HTTPS接口符合以下要求:a)采用 Token 机制实现身份认证;Token 放到 HTTPS header 的
20、Authorization 中;b)接口 URL 规则:https:/服务器地址/sys/版本号/event/接口编码/post。示例:https:/ MQTT 接口要求 MQTT接口符合以下要求:a)加密方式:传输加密采用 tls 证书加密方式;b)认证方式:使用预约共享停车平台分配的 MQTT 客户端 ID(clientId,标识每个 MQTT 连接需要唯一 ID)和密码登录消息中间件;c)服务质量(QoS):使用默认的 QoS 等级 0;d)当使用 MQTT 协议传输数据时:1)上行符合以下要求:请求 Topic:/sys/版本号/event/接口编码/post;响应 Topic:/sy
21、s/版本号/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。DB4
22、403/T 3152023 7 7.3.2 安全认证接口 7.3.2.1 登录 安全认证接口的登录应符合以下要求:a)接口编码:login;b)场景:停车库(场)管理系统或停车管理平台请求登录预约共享停车平台,平台验证用户标识,生成 Token 返回;c)数据属性:请求数据属性定义见表 4,应答数据属性定义见表 5。表4 请求数据属性定义 属性 名称 数据类型 字符长度 必须 说明 userId 用户唯一标识 String 32 是 password 用户密码 String 64 是 不使用明文,采用 SHA1 对原用户密码加上盐值 salt 签名后的值 表5 应答数据属性定义 属性 名称 数
23、据类型 字符长度 必须 说明 code 消息码 Int 否 发生错误时为必填,编码见表 C.2 message 消息详细 String 255 否 业务异常信息 scope 范围 String 50 否 请求的业务范围,默认值 basic tokenType 鉴权 token 类型 String 50 是 默认值 bearer expiresIn 有效时间 Int 是 accessToken 的有效时间,单位:秒 accessToken 权限 Token String 255 是 Oauth 2.0 鉴权参数 refreshToken 刷新 Token String 255 是 Oauth 2
24、.0 鉴权参数 7.3.2.2 刷新 Token 安全认证接口的刷新应符合以下要求:a)接口编码:refreshToken;b)场景:accessToken 快过期时,停车库(场)管理系统或停车管理平台通过调用此接口,重新获取可用 token。accessToken 有效时间按照 7.3.2.1 返回字段 expiresIn 的值;c)数据属性:请求数据属性定义见表 6,应答数据属性定义见表 7。表6 请求数据属性定义 属性 名称 数据类型 字符长度 必须 说明 userId 用户唯一标识 String 32 是 预约共享停车平台分配 password 用户密码 String 64 是 不使用
25、明文,采用 SHA1 对原用户密码加上盐值 salt 签名后的值 refreshToken 刷新 Token String 是 DB4403/T 3152023 8 表7 应答数据属性定义 属性 名称 数据类型 字符长度 必须 说明 id 业务 ID Uuid 32 是 code 消息码 Int 否 发生错误时为必填,编码见表 C.2 message 消息详细 String 255 否 业务异常信息 tokenType 鉴权 token 类型 String 50 是 默认值 bearer expiresIn 有效时间 Int 是 accessToken 的有效时间,单位:秒 accessTok
- 配套讲稿:
如PPT文件的首页显示word图标,表示该PPT已包含配套word讲稿。双击word图标可打开word文档。
- 特殊限制:
部分文档作品中含有的国旗、国徽等图片,仅作为作品整体效果示例展示,禁止商用。设计者仅对作品中独创性部分享有著作权。
- 关 键 词:
- DB4403T 315-2023 停车库场预约共享数据接口规范 DB4403 315 2023 车库 预约 共享 数据 接口 规范
1、咨信平台为文档C2C交易模式,即用户上传的文档直接被用户下载,收益归上传人(含作者)所有;本站仅是提供信息存储空间和展示预览,仅对用户上传内容的表现方式做保护处理,对上载内容不做任何修改或编辑。所展示的作品文档包括内容和图片全部来源于网络用户和作者上传投稿,我们不确定上传用户享有完全著作权,根据《信息网络传播权保护条例》,如果侵犯了您的版权、权益或隐私,请联系我们,核实后会尽快下架及时删除,并可随时和客服了解处理情况,尊重保护知识产权我们共同努力。
2、文档的总页数、文档格式和文档大小以系统显示为准(内容中显示的页数不一定正确),网站客服只以系统显示的页数、文件格式、文档大小作为仲裁依据,平台无法对文档的真实性、完整性、权威性、准确性、专业性及其观点立场做任何保证或承诺,下载前须认真查看,确认无误后再购买,务必慎重购买;若有违法违纪将进行移交司法处理,若涉侵权平台将进行基本处罚并下架。
3、本站所有内容均由用户上传,付费前请自行鉴别,如您付费,意味着您已接受本站规则且自行承担风险,本站不进行额外附加服务,虚拟产品一经售出概不退款(未进行购买下载可退充值款),文档一经付费(服务费)、不意味着购买了该文档的版权,仅供个人/单位学习、研究之用,不得用于商业用途,未经授权,严禁复制、发行、汇编、翻译或者网络传播等,侵权必究。
4、如你看到网页展示的文档有www.zixin.com.cn水印,是因预览和防盗链等技术需要对页面进行转换压缩成图而已,我们并不对上传的文档进行任何编辑或修改,文档下载后都不会有水印标识(原文档上传前个别存留的除外),下载后原文更清晰;试题试卷类文档,如果标题没有明确说明有答案则都视为没有答案,请知晓;PPT和DOC文档可被视为“模板”,允许上传人保留章节、目录结构的情况下删减部份的内容;PDF文档不管是原文档转换或图片扫描而得,本站不作要求视为允许,下载前自行私信或留言给上传者【se****n5】。
5、本文档所展示的图片、画像、字体、音乐的版权可能需版权方额外授权,请谨慎使用;网站提供的党政主题相关内容(国旗、国徽、党徽--等)目的在于配合国家政策宣传,仅限个人学习分享使用,禁止用于任何广告和商用目的。
6、文档遇到问题,请及时私信或留言给本站上传会员【se****n5】,需本站解决可联系【 微信客服】、【 QQ客服】,若有其他问题请点击或扫码反馈【 服务填表】;文档侵犯商业秘密、侵犯著作权、侵犯人身权等,请点击“【 版权申诉】”(推荐),意见反馈和侵权处理邮箱:1219186828@qq.com;也可以拔打客服电话:4008-655-100;投诉/维权电话:4009-655-100。