DB5301-T59-2021-智慧停车联网技术要求及管理规范-昆明市

ICS91.140.90CCSQ78DB5301昆明市地方标准DB5301/T59—2021智慧停车联网技术要求及管理规范2021-04-20实施昆明市市场监督管理局发布DB5301/T59—2021目  次前言.....................................................................................................................................................................III1范围.....................................................................................................................................................................12规范性引用文件.................................................................................................................................................13术语和定义.........................................................................................................................................................14技术要求.............................................................................................................................................................24.1基本规定.....................................................................................................................................................24.2平台功能.....................................................................................................................................................24.3接口清单.....................................................................................................................................................24.4交互方式.....................................................................................................................................................34.5基础数据清单.............................................................................................................................................44.6公共数据清单.............................................................................................................................................45上下行接口.........................................................................................................................................................55.1上行接口.....................................................................................................................................................55.2下行接口.....................................................................................................................................................96管理要求...........................................................................................................................................................11IDB5301/T59—2021前  言本文件按照GB/T1.1—2021《标准化工作导则第1部分：标准化文件的结构和起草规则》给出的规则起草。本文件由昆明市交通运输局提出并归口。本文件起草单位：深圳市城市交通规划设计研究中心股份有限公司、云南省设计院集团有限公司、云南省城乡规划设计研究院、云南正元安泰建设工程设计咨询有限公司、昆明有色冶金设计研究院股份公司、昆明理工大学、昆明市智慧停车建设运营有限公司、云南昆船数码科技有限公司、云南昆船智能装备有限公司。本文件主要起草人员：何毅刚、游苇、李昊、甘甜、杨芳、李林澳、高威巍、周小亮、唐翀、苏镜荣、毛应萍、蒋雨薇、张开基、高云雯、艾茗、曹祥、胥劲、周容、杨荣伟、赫平、刘勇、周伟、冯婷婷、帅春燕、张智勇、卯彦、黄艇、何彦东、秦颖、姜荣奇、王志德、杨海河。IIIDB5301/T59—2021智慧停车联网技术要求及管理规范12范围本文件对智慧停车联网的术语与定义、技术要求、上下行接口和管理要求做出了规定。本文件适用于符合《昆明市机动车停车场管理办法》要求的机动车停车场信息联网接入及管理。规范性引用文件下列文件中的内容通过文中的规范性引用而构成本文件必不可少的条款。其中，注日期的引用文件，仅该日期对应的版本适用于本文件；不注日期的引用文件，其最新版本（包括所有的修改单）适用于本文件。GB/T25068.1信息技术安全技术IT网络安全第1部分：网络安全管理GB/T29745公共停车场（库）信息联网通用技术要求YD/TYD/T2248互联网数据中心和互联网接入服务信息安全管理系统技术要求2405互联网数据中心和互联网接入服务信息安全管理系统接口规范《昆明市机动车停车场管理办法》（昆明市人民政府令〔2019〕第150号）3智慧停车联网各类机动车停车设施（包含经营性、非经营性停车场及道路临时停车泊位）将停车信息接入智慧停用于整合机动车停车信息资源，按照本文件完成停车数据的接入、存储、处理、交换和分发功能，是面向政府各部门和社会公众进行停车泊位信息发布、行业监管、规划、提供泊位查找、预约、共享等每一个机动车停车场或路内临时停车泊位管理单位的信息管理系统即为联网接入信息平台的一个1DB5301/T59—2021信息平台下发数据给接入单元的接口。3.6过车记录接入单元记录的由进出停车场车辆的车牌号、出入场时间、场内泊位编号、出入口编号、抓拍图片等内容组成的数据信息。4技术要求基本规定数据通信接口传输方式采用TCP、HTTP协议传输。通用信息安全和网络安全应符合GB/T25068.1、YD/T2248、YD/T2405的规定。4.1.2基本信息数据采集准确率应大于99%，更新周期应不低于7天；动态信息数据采集准确率应大于95%，更新周期应不高于20s。4.1.3接入单元输入传输应满足以下要求：a)传输格式要求：JSON；b)c)d)编码格式要求：UTF-8；业务字段命名规范要求：小驼峰形式(如：deviceld)；产生的数据平均延时≤10s，丢包率≤0.2%、误码率≤0.2%；e)实时连接信息平台，当网络连接断开时，应报警提醒；f)支持网络异常情况下的数据补传功能；数据传输过程中应对数据进行加密。4.1.4信息平台下发数据信息采用TCP方式进行通信，接入单元应定时向信息平台通过心跳线维持连接。信息平台终结点(IP：PORT)在正式应用前由平台方提供。接入单元与信息平台对接完成后，应进行对接系统测试，做好测试记录。包括但不限于：a)对联网接口内容逐项进行功能测试；b)对联网接口程序进行性能测试，保障接口程序无间断运行；信息平台具备资源数据管理和统计、信息资源目录以及备案信息管理等机动车停车资源管理功4.2.2信息平台负责采集停车场信息，并对采集的数据进行存储、处理、统计分析，通过移动终端应用、网站等多种方式为政府、停车场经营者、公众提供信息服务。2DB5301/T59—2021表1接口清单编号1请求方向接口名称停车场登录支持协议TCP方向上行上行上行上行上行上行上行上行上行上行上行下行下行下行下行下行实现要求2停车场剩余泊位数上报停车场过车记录上报充电桩信息上报无感支付请求HTTPHTTPHTTPHTTPHTTPHTTPHTTPHTTPHTTPHTTPTCP345接入单元上传至信息平台6错峰共享泊位开通/取消预订泊位开通/取消协同追缴开通/取消电子支付请求78910111213141516车辆无感状态查询电子支付对账连接状态检查共享泊位订单下发预订泊位订单下发车主签约/解约状态下发支付结果下发TCP信息平台下传至接入单元TCPTCPTCP4.4交互方式4.4.1上行接口采用HTTP方式进行交互，各接入单元通过HTTP协议调用信息平台接口上传数据。b)首先组成待签名字符串。待签名字符串组成规则为：待验签的所有请求参数按从a到z的字典顺序排列，如首字母相同，按第二个字母排列，以此类推。排序完成后按将所有键值对以“&”c)其次将接入单元签名密钥增加“&”附加到待签名字符串后，按指定签名算法进行运算。假设待签名字符串为strToSign，商户密钥为merkey，算法为sha256，对strToSign&merkey进行sha256签名运算获得签名结果byte数组，将byte数组转换为16进制即为最终的签名结果。示例："param1":"value1","param2":"value2","dateTime":"20160622182921"}3DB5301/T59—2021}d)待签名字符串（不包含接入单元密钥）为：dateTime=20160622182921¶m1=value1¶m2=value24.4.2下行接口采用TCP方式进行交互。接入单元系统上线时，需要请求登录到信息平台，连接成功后向平台发送认证信息；认证成功后，信息平台保留一条长连接线路与接入单元系统连接，通过长连接将数据下发至各接入单元。4.5基础数据清单基础数据清单适用于本文件中所有的数据接口。基础数据清单见表2。表2基础数据清单类型名称长度（字符长度）基础类型(json)描述StringLongN8StringNumberNumberBooleanNumberNumberNumberString字符串长整型Int4整型BooleanFloat1布尔型浮点型4DoubleDecimalDate8双精度浮点1610198高精度浮点日期格式“yyyy-MM-dd”日期时间格式“yyyy-MM-ddHH:mm:ss"时间格式“HH:mm:ss”时间戳1970-01-0100:00:00起的秒数全球唯一IDDateTimeTimeString数据类型TimestampString根据接口不同请求数据不同"sign":"3535346546be81f014d9beb8098765",4DB5301/T59—2021“verison”:"charset":"data":[{"1.0","UTF-8","id":"ff8080814d9be81f014d9beb81090003","placeCode":"A001","parkCode":"p001","placeType":"1","areaName":"A区","floor":"负1楼","rStatus":0}]}4.6.2应答数据清单应答数据清单适用于本文件中的所有上行数据接口。应答数据清单见表4。表4应答数据清单参数类型是否必填描述charsetversionsign报文签名，对reqData内的数据进行签名响应数据rspDatacodeString是200：请求处理成功；其它：请求处理失败处理结果返回码的描述信息单条数据返回messagesignalData5属性5.1.2接入单元以固定的时间间隔向信息平台发送泊位信息表。泊位信息见表6。5DB5301/T59—2021表6泊位信息表属性名称类型长度必须是说明parkCodeinSpace停车场编号己占泊位数量空闲泊位数量总泊位数StringInt64是restSpacetotalSpacetimestampInt是Int是上报时间戳Timestamp是5.1.3接入单元将过车记录上传至信息平台。过车记录信息见表7。表7过车记录信息表属性名称数据类型StringStringint长度64必须是说明orderNocarPlatecarTypedirection订单编号车牌号唯一订单编号20是车辆类型方向否小型车、大型车、非机动车入场、出场String2064是入场通道编号inGateIdString否inPassTimeinPassPic入场时间入场图片出场通道编号dateTimeString是否入场图片Base64编码出场图片Base64编码outGateIdString64否是否是否否为路内临时泊位时必填以分钟为单位Int以元为单位，保留两位小数，出场时必填以元为单位，保留两位小数以元为单位，保留两位小数，，出场时必填以元为单位，保留两位小数，，出场时必填以元为单位，保留两位小数，，出场时必填“SETTLE”：已完成对账,现金、微信、支付宝、无感支付等，出场时必填6DB5301/T59—2021表7（续）属性名称车辆出入场身份数据类型长度必须说明carStatusString20是是共享车辆，预约车辆等是否为实时数据isImmediatelyint1：实时数据，2断网续传数据5.1.4接入单元将充电桩信息上传至信息平台。充电桩信息见表8。表8充电桩使用状态参数名称停车场编号充电桩总量可用充电桩泊位数时间戳数据类型StringInt长度644是否必填描述parkCode是是是是chargeTotalchargeInSpacetimestampInt4Timestamp5.1.5接入单元可选择信息平台申请无感支付服务。无感支付信息见表9。表9无感支付信息表参数名称停车场编号停车时长数据类型String长度是否必填描述parkCodeparkTimebillAmountpayAmountorderNo64是是是是是是否是是int（以分钟为单位）String2555.1.6接入单元可选择向信息平台申请电子支付，信息平台接收到电子支付请求后生成支付二维码，供车主扫码支付。电子支付请求信息见表10。属性parkCodecarPlateamountcarportNoorderNogateIdStringString过车时上传的记录编号，供对账使用String5.1.7接入单元可选择将共享泊位申请信息上传至信息平台，通过信息平台实现泊位共享。共享泊位7DB5301/T59—2021表11共享泊位开通/取消信息表参数名称数据类型长度是否必填描述productTypeparkCode服务编码StringString2064是是固定传值SHARE停车场编号price价格Bigdecimal是保留两位小数Month:月Quarter：季度Year:年interval可用时段String2020是validDateType可用时间类型String是工作日、周末、节假日等validTimeStartvalidTimeEndcanBuyTimeStartcanBuyTimeEndcarportNo可用时段开始时间可用时段接收时间可销售开始时间可销售结束时间泊位号DateTimeDateTimeDateTimeDateTimeString是是是是是服务可用开始时间服务可用结束时间2020当为多个泊位时使用逗号隔开ADD:新增type操作类型String是UPDATE:更新CANCEL:取消accountNo收款账户StringString6464否否用于收取共享收入分成微信、支付宝、银行等accountType5.1.8接入单元可选择将预订泊位申请信息上传至信息平台，通过信息平台实现泊位预定。预定泊位参数productTypeparkCodeprice工作日、周末、节假日等服务可用开始时间服务可用结束时间8DB5301/T59—2021表12（续）参数名称泊位号数据类型长度是否必填描述预约指定泊位时必填，当为多个泊位时使用逗号隔开。carportNoStringint20否是bookCarportkNo可供预约的泊位数量ADD:开通type操作类型收款账户StringString2064是否UPDATE:更新CANCEL:取消accountNo用于收取预约收入分成accountTyperemark收款账户类型备注信息StringString64否否255额外描述信息5.1.9接入单元可选择将车辆无感签约状态查询信息上传至信息平台。车辆无感签约状态查询信息见表13。表13车辆无感签约状态查询属性名称停车场编号车牌数据类型String长度64必须是说明parkCodecarPlateString20是5.1.10接入单元可选择将协同追缴信息上传至信息平台，通过信息平台实现协同追缴。协同追缴开通说明当需要查询某张查询车量的账单请求时需要车场请求电子支付订单编号示例2020-12-075.2.1信息平台以固定时间间隔向接入单元下发连接状态检查信息。停车场连接状态检查信息见表9DB5301/T59—2021表16停车场连接状态检查信息表属性名称类型Uuid长度64必须是说明parkCode停车场编号消息类型messageTypeString20是固定值PING5.2.2车主选择在信息平台开通电子支付服务时，信息平台将支付结果信息下发至接入单元。支付结果下发信息见表17。表17支付结果下发信息表属性parkCodecarPlate名称停车场编号车牌号数据类型String长度64必须是是是否是是否是是说明String20orderNo订单编号过车记录编号支付渠道支付金额优惠金额支付订单编号支付时间String64请求计费的订单编号passRecodeNopayChannelaccountString64String24微信、支付宝、银行卡等BigdecimalBigdecimalStringdiscountAmtpayOrderIdpayTime64供对账使用Datetime5.2.3车主选择在信息平台开通共享泊位服务时，信息平台将共享泊位订单信息下发至接入单元。共String645.2.4车主选择在信息平台开通预订泊位服务时，信息平台将预订泊位订单信息下发至接入单元。预10DB5301/T59—2021表19（续）属性beginDateendDatecarPlatepa