2022智慧停车联网技术要求及管理规范

智慧停车联网技术要求及管理规范目  次前言 III范围 1规范性引用文件 1术语和定义 1技术要求 2基本规定 2平台功能 2接口清单 2交互方式 3基础数据清单 4公共数据清单 4上下行接口 5上行接口 5下行接口 9管理要求 11I智慧停车联网技术要求及管理规范范围本文件对智慧停车联网的术语与定义、技术要求、上下行接口和管理要求做出了规定。本文件适用于符合《机动车停车场管理办法》要求的机动车停车场信息联网接入及管理。规范性引用文件（包括所有的修改单适用于本文件。GB/T25068.1 信息技术安全技术IT网络安全第1部分：网络安全管理GB/T29745公共停车场（库）信息联网通用技术要求YD/T2248互联网数据中心和互联网接入服务信息安全管理系统技术要求YD/T2405互联网数据中心和互联网接入服务信息安全管理系统接口规范《机动车停车场管理办法》（人民政府令〔2019〕第150号）术语和定义下列术语和定义适用于本文件。3.1智慧停车联网各类机动车停车设施（包含经营性、非经营性停车场及道路临时停车泊位）将停车信息接入智慧停车信息平台。3.2智慧停车信息平台用于整合机动车停车信息资源，按照本文件完成停车数据的接入、存储、处理、交换和分发功能，3.3接入单元每一个机动车停车场或路内临时停车泊位管理单位的信息管理系统即为联网接入信息平台的一个接入单元。3.4上行接口接入单元向信息平台上传数据的接口。3.5下行接口1信息平台下发数据给接入单元的接口。3.6过车记录接入单元记录的由进出停车场车辆的车牌号、出入场时间、场内泊位编号、出入口编号、抓拍图片等内容组成的数据信息。技术要求基本规定TCP、HTTP25068.1、YD/T2248、YD/T24059979520s。接入单元输入传输应满足以下要求：传输格式要求：JSON；编码格式要求：UTF-8；业务字段命名规范要求：小驼峰形式(如：deviceld)；产生的数据平均延时≤10s，丢包率≤0.2%、误码率≤0.2%；实时连接信息平台，当网络连接断开时，应报警提醒；支持网络异常情况下的数据补传功能；数据传输过程中应对数据进行加密。TCP接入单元与信息平台对接完成后，应进行对接系统测试，做好测试记录。包括但不限于：对联网接口内容逐项进行功能测试；对联网接口程序进行性能测试，保障接口程序无间断运行；对程序中断时的数据回传功能进行测试。平台功能信息平台具备资源数据管理和统计、信息资源目录以及备案信息管理等机动车停车资源管理功能，应满足对机动车停车信息的汇聚和存储，并支持停车管理与服务。信息平台负责采集停车场信息，并对采集的数据进行存储、处理、统计分析，通过移动终端应用、网站等多种方式为政府、停车场经营者、公众提供信息服务。接口清单接入单元的接口清单见表1。2表1接口清单编号请求方向接口名称支持协议方向实现要求1接入单元上传至信息平台停车场登录TCP上行2停车场剩余泊位数上报HTTP上行3停车场过车记录上报HTTP上行4充电桩信息上报HTTP上行5无感支付请求HTTP上行6错峰共享泊位开通/取消HTTP上行7预订泊位开通/取消HTTP上行8协同追缴开通/取消HTTP上行9电子支付请求HTTP上行10车辆无感状态查询HTTP上行11电子支付对账HTTP上行12信息平台下传至接入单元连接状态检查TCP下行13共享泊位订单下发TCP下行14预订泊位订单下发TCP下行15车主签约/解约状态下发TCP下行16支付结果下发TCP下行交互方式HTTPHTTP协议调用信息平台接口上传数据。各接入单元上传数据时，上传的信息中应包含签名信息，签名算法如下：为支持参数扩展，接入单元应使用算法将待签名参数排序，不宜硬拼接参数顺序；az&”符号拼接：param1=value1¶m2=value2&……其次将接入单元签名密钥增加“&”附加到待签名字符串后，按指定签名算法进行运算。假设strToSignmerkeysha256strToSign&merkeybytebyte16示例：{"version":"1.0","charset":"UTF-8","sign":"ABCDAEEDDDFA","reqData":{"param1":"value1","param2":"value2","dateTime":"20160622182921"}3}待签名字符串（不包含接入单元密钥）为：dateTime=20160622182921¶m1=value1¶m2=value2TCP基础数据清单基础数据清单适用于本文件中所有的数据接口。基础数据清单见表2。表2基础数据清单类型名称长度（字符长度）基础类型(json)描述StringNString字符串Long8Number长整型Int4Number整型Boolean1Boolean布尔型Float4Number浮点型Double8Number双精度浮点Decimal16Number高精度浮点Date10String日期格式“yyyy-MM-dd”DateTime19String日期时间格式“yyyy-MM-ddHH:mm:ss"Time8String时间格式“HH:mm:ss”Timestamp4Number时间戳1970-01-0100:00:00起的秒数Uuid32String全球唯一IDOjbectNObject对象ListNArray数组公共数据清单请求数据清单请求数据清单适用于本文件中的所有上行接口。请求数据清单见表3。表3请求数据清单属性名称数据类型长度必须说明timestamp时间戳Timestamp是charset参数编码String是固定为“UTF-8”sign签名String是vesion版本号String是1.0data请求数据List<Object>是根据接口不同请求数据不同示例：{"timestamp":125555556621,"sign":"3535346546be81f014d9beb8098765",4“verison”: "1.0","charset": "data":[{"id":"ff8080814d9be81f014d9beb81090003","placeCode":"A001","parkCode":"p001","placeType":"1","areaName":"A区","floor":"负1楼","rStatus":0}]}应答数据清单应答数据清单适用于本文件中的所有上行数据接口。应答数据清单见表4。表4应答数据清单参数类型是否必填描述charsetString是参数编码，固定为“UTF-8”versionString是1.0signString是报文签名，对reqData内的数据进行签名rspDataString是响应数据codeString是处理结果返回码，其它：请求处理失败messageString是处理结果返回码的描述信息signalDataobject是单条数据返回上下行接口上行接口5。表5停车场登录信息表属性名称数据类型长度必须说明parkCode停车场编号String64是6。5表6泊位信息表属性名称类型长度必须说明parkCode停车场编号String64是inSpace己占泊位数量Int是restSpace空闲泊位数量Int是totalSpace总泊位数Int是timestamp上报时间戳Timestamp是7。表7过车记录信息表属性名称数据类型长度必须说明orderNo订单编号String64是唯一订单编号carPlate车牌号String20是carType车辆类型int否小型车、大型车、非机动车direction方向String20是入场、出场inGateId入场通道编号String64否inPassTime入场时间dateTime是inPassPic入场图片String否入场图片Base64编码outGateId出场通道编号String64否outPassTime出场时间dateTime是outPassPic出场图片String否出场图片Base64编码parkCode停车场编号String64是carportNo泊位号String64否为路内临时泊位时必填parkTime停车时长Int否以分钟为单位billAmount应收金额bigdecimal否以元为单位，保留两位小数，出场时必填couponAmount优惠金额bigdecimal否以元为单位，保留两位小数payAmount实收金额bigdecimal否以元为单位，保留两位小数，，出场时必填payOffline现金收费金额bigdecimal否以元为单位，保留两位小数，，出场时必填payOnline电子收费金额bigdecimal否以元为单位，保留两位小数，，出场时必填tradeStatus订单状态String20是“IN_PARK”：在场“PRE_CREATE”：预付费“NO_COMPLETE”:“欠费离场”“CREATE”：完成支付离场,“SETTLE”：已完成对账,“INVALID”:作废payTime支付时间dateTime否payChannel支付渠道String20否现金、微信、支付宝、无感支付等，出场时必填noPassowordChannel无感支付渠道String20否当payChannel为“NOPARSSWORD”时必填6表7（续）属性名称数据类型长度必须说明carStatus车辆出入场身份String20是共享车辆，预约车辆等isImmediately是否为实时数据int是1：实时数据，2断网续传数据8。表8充电桩使用状态参数名称数据类型长度是否必填描述parkCode停车场编号String64是chargeTotal充电桩总量Int4是chargeInSpace可用充电桩泊位数Int4是timestamp时间戳Timestamp是9。表9无感支付信息表参数名称数据类型长度是否必填描述parkCode停车场编号String64是parkTime停车时长int是（以分钟为单位）billAmount应收金额bigdecimal是payAmount实际需要支付金额bigdecimal是orderNo客户订单编号String64是carPlate车牌号String20是parkName停车场名称String255否InPassTime车辆入场时间DateTime是outPassTime车辆出场时间DateTime是remark备注信息String255需要特殊说明的信息接入单元可选择向信息平台申请电子支付，信息平台接收到电子支付请求后生成支付二维码，10。表10电子支付请求信息表属性名称数据类型长度必须说明parkCode停车场编号String64是carPlate车牌号String10是amount需要支付的金额Bigdecimal是保留两位小数carportNo泊位编号String20否orderNo订单编号String64是过车时上传的记录编号，供对账使用gateId车道编号String64否接入单元可选择将共享泊位申请信息上传至信息平台，通过信息平台实现泊位共享。共享泊位开通/11。7表11共享泊位开通/取消信息表参数名称数据类型长度是否必填描述productType服务编码String20是固定传值SHAREparkCode停车场编号String64是price价格Bigdecimal是保留两位小数interval可用时段String20是Month:月Quarter：季度Year:年validDateType可用时间类型String20是工作日、周末、节假日等validTimeStart可用时段开始时间DateTime是服务可用开始时间validTimeEnd可用时段接收时间DateTime是服务可用结束时间canBuyTimeStart可销售开始时间DateTime是canBuyTimeEnd可销售结束时间DateTime是carportNo泊位号String20是当为多个泊位时使用逗号隔开type操作类型String20是ADD:新增UPDATE:更新CANCEL:取消accountNo收款账户String64否用于收取共享收入分成accountType收款账户类型String64否微信、支付宝、银行等carType车辆类型String20否大型车、小型车等remark备注信息String255否额外描述信息接入单元可选择将预订泊位申请信息上传至信息平台，通过信息平台实现泊位预定。预定泊位服务开通/12。表12预定泊位服务开通/取消信息表参数名称数据类型长度是否必填描述productType服务编码String10是固定传值BOOKparkCode停车场编号String64是price服务价格Bigdecimal是保留两位小数interval可用间隔String20是Month:月Quarter：季度Year:年validDateType可用时间类型String20是工作日、周末、节假日等validTimeStart可用时段开始时间DateTime是服务可用开始时间validTimeEnd可用时段接收时间DateTime是服务可用结束时间canBuyTimeStart可销售开始时间DateTime是canBuyTimeEnd可销售结束时间DateTime是8表12（续）参数名称数据类型长度是否必填描述carportNo泊位号String20否预约指定泊位时必填，当为多个泊位时使用逗号隔开。bookCarportkNo可供预约的泊位数量int是type操作类型String20是ADD:开通UPDATE:更新CANCEL:取消accountNo收款账户String64否用于收取预约收入分成accountType收款账户类型String64否remark备注信息String255否额外描述信息接入单元可选择将车辆无感签约状态查询信息上传至信息平台。车辆无感签约状态查询信息见13。表13车辆无感签约状态查询属性名称数据类型长度必须说明parkCode停车场编号String64是carPlate车牌String20是/取消信息见表14。表14协同追缴开通/取消信息表属性名称数据类型长度必须说明parkCode停车场编号String64是type业务类型String20是期望追缴、协同追缴等status状态String20是开通、取消接入单元可选择向信息平台申请电子支付信息对账信息。电子支付对账信息表15电子支付对账信息表属性名称类型长度必须说明parkCode停车场编号Uuid64是carPlate车牌String20否当需要查询某张查询车量的账单请求时需要orderNo订单编号String64否车场请求电子支付订单编号checkBillTime对账时间String20是示例2020-12-07下行接口信息平台以固定时间间隔向接入单元下发连接状态检查信息。停车场连接状态检查信息见表16。9表16停车场连接状态检查信息表属性名称类型长度必须说明parkCode停车场编号Uuid64是messageType消息类型String20是固定值PING车主选择在信息平台开通电子支付服务时，信息平台将支付结果信息下发至接入单元。支付结17。表17支付结果下发信息表属性名称数据类型长度必须说明parkCode停车场编号String64是carPlate车牌号String20是orderNo订单编号String64是请求计费的订单编号passRecodeNo过车记录编号String64否payChannel支付渠道String24是微信、支付宝、银行卡等account支付金额Bigdecimal是discountAmt优惠金额Bigdecimal否payOrderId支付订单编号String64是供对账使用payTime支付时间Datetime是车主选择在信息平台开通共享泊位服务时，信息平台将共享泊位订单信息下发至接入单元。共18。表18共享泊位订单下发信息表参数名称数据类型长度是否必填描述orderNo共享订单编号String64是parkCode停车场编号String64是carPlate车牌号String20是carportNo共享泊位编号String20是shareStartTime共享生效时间dateTime是shareEndTime共享结束时间dateTime是sharePay共享支付金额bigDecimal否保留两位小数state共享订单状态Int是1：开通；2取消车主选择在信息平台开通预订泊位服务时，信息平台将预订泊位订单信息下发至接入单元。预19。表19预定泊位订单下发信息表属性名称数据类型长度必须说明orderNo预订订单编号String64是唯一识别码parkCode停车场编号String64是garageCode车库编号String20否bookCode预订泊位编号String20否10表