DBJ04-T 504-2025 停车设施运营平台数据接入标准

山西省工程建设地方标准停车设施运营平台数据接入标准YDataacccssstandardsforparkingfacilityoperationYplatform5045042025批准部门:山西省住房和城乡建设厅施行日期:2026年1月施行日期:2026年1月1日前言根据《山西省住房和城乡建设厅关于印发〈2022年工程建设地方标准制(修)订计划〉的通知》(晋建科字(2022152标准编制组经过深入调查研究、认真总结实践经验,参考国家及省外有关标准,并在广泛征求意见的基础上,结合我省实际,制定本标准。i本标准共分6章,主要技术内容包括:1.总则;2.术语;3.基本规定;4.系统架构;5.通用规定;6.接口数据规定。i本标准由山西省住房和城乡建设厅负责管理,由山西静态交通建设运营有限公司负责具体技术内容解释。在执行过程中如有意见和建议请反馈给山西静态交通建设运营有限公司(地址:山西省太原市小店区坞城路41号学府商务楼7层,邮箱:1772918086@)。本标准主编单位:山西静态交通建设运营有限公司本标准参编单位山西捷顺信息科技有限公司山西红遍天智能科技有限公司解广安本标准主要起草人员:杨峰斌李妮闫伟陈亚素李晓强赵鹏亮解广安冯欣弓一凡李端白少华赵海胜李伟民路广通段洋张贵平祁雷许永飞曾志燕本标准主要审查人员:张旭升韩乾霍丽霞倪仕水秦明琪王锐张华萍351总则22术语2233基本规定333数据质量规定33.23信息安全规定3.2345系统架构455系统整体架构54.25数据接口清单4.255通用规定5数据传输规定5.2传输安全规定5.25.3公共参数5.35.4请求返回规定5.4接口数据规定静态数据规定动态数据规定其他数据规定附录A(规范性)请求返回值说明表附录A本标准用词说明引用标准名录条文说明2122contents2Terms1Generalprovisions2TermsBasicRequirement33BasicRequirement333DataQualityRegulations3DatasecurityRegulationsInformation33.2yVsecurityRegulationsInformation33.245systemArchitecture45overall5systemArchitectureoverall5List4.25DataInterfaceList4.25Data5GeneralRules5DataTransmissionRegulations5.2TransmissionsecurityRegulations5.25.3commonparametersInterfaceDataRegulationsstaticDataRegulationsDynamicDataDynamicDataotherDataRegulationsAppendixA(Normative)RequestReturnvalueDescriptionTableListofQuotedstandards 20Explanationofprovisions 为了规范山西省停车设施运营平台的数据接入,统一全省城镇停车场(库)的停车数据,促进本省城镇公共停车场(库)运营平台的健康发展,制定本标准。1.0.2本标准适用于山西省行政区域内所有停车设施运营平台、机械车库运营平台、停车场(库)管理系统、路内停车管理系统的数据联网接入。1.0.3停车设施运营平台数据接入除应符合本标准外,尚应符合国家、行业和山西省现行有关标准的规定。2术语2.0.1停车设施运营平台parkingfacilityoperationplatform用于对道路停车泊位或停车场(库)进行统一停车设施接入、停车场运营、停车数据监控、运维管理,并向社会大众提供车位信息查询、停车缴费等服务的系统。2.0.22.0.2机械车库运营平台mechanicalgaragEOperationplatform对机械车库使用状态等信息进行采集、处理、存储、管理和服务的运营监控平台。2.0.3停车场(库)parkinglot(garage)用于停放和储存机动车车辆的露天场地或地上、地下的建构筑物或停车设施。一般分为停车场、停车库和停车楼三种类型。2.0.4路内停车泊位on-streetparking在道路路内用交通标线施划的供汽车停放的区域。2.0.5停车场(库)管理系统parkinglot(garage)managementsystem部署在各停车场本地,具有停车场(库)停车信息的采集、存储、传输、发布、管理、控制设备等能与所属停车设施运营平台进行数据交互的系统,以下简称为停车场(库)系统"。2.0.6路内停车管理系统on-streetparkingmanagementsystem具备路内停车相关基础信息、图像和视频数据的收集、存储、处理、发布等管理功能,以及停车费用的支付等应用功能,并可对设备和路内停车泊位远程管控的停车管理系统。2.0.7第三方停车运营平台thirdpartyparkingoperationplatform用于对路内停车泊位或路外停车场进行统一运营、监控、运维管理,并向社会大众提供停车缴费等服务的系统或平台。23基本规定3.1数据质量规定3.1.1停车设施运营平台应具备差错重传机制和数据缓存的功能,由于传输网络故障因素导致与机械车库运营平台、停车场(库)管理系统、路内停车管理系统、第三方停车运营平台(以下统称为"外部系统或平台")的停车信息未能及时同步时,应在网络恢复后进行数据重传,保证停车信息业务闭环且可靠不丢失。3.1.2停车设施运营平台与外部系统或平台的本地数据发生变化后,传输同步的时延不应超过5s。3.1.3车辆入场记录和车辆出场记录应完整传输并每日核对。车辆入场记录和车辆出场记录误差不应大于1%。Y3.1.4同一停车场、同一车辆人场流水号唯一,且不可重复传输。Y3.1.5同一停车场、同一车辆入场流水号与离场流水号应保持一致,保障进出记录完全匹配。3.1.6停车设施运营平台与外部系统或平台联网调试结束后,平台联网在线率应不低于3.1.7停车设施运营平台获取的时间应保持统一标准,采用UTC+8时间,平台应定期同步NTP/PTP公网时间源,保证与UTC+8时间无误差。3.1.8停车设施运营平台数据接入应符合现行国家标准《公共停车场(库)信息联网通用技术要求》GB/T29745的有关规定。3.2信息安全规定3.2.1停车设施运营平台应符合现行国家标准《信息安全技术网络34安全等级保护基本要求》GB/T22239的有关规定。3.2.2停车设施运营平台应按照现行国家标准《信息安全技术网络3.2.3停车设施运营平台应符合《停车库(场)安全管理系统技术要求》GA/T761中规定的数据安全要求,保护用户信息安全。3.2.4停车设施运营平台应建立动态密钥生成与管理机制,以增强数据传输和存储的安全性。在数据交互过程中,应采用临时密钥进行加密解密操作,避免使用固定的敏感信息作为参数直接传递,防止密钥泄露带来的安全隐患。3.2.5停车设施运营平台使用的加解密算法和密钥管理机制应符合国家相关规定和标准要求,加密算法应优先采用国密算法。安全等级保护定级指南》GB3.2.3停车设施运营平台应符合《停车库(场)安全管理系统技术要求》GA/T761中规定的数据安全要求,保护用户信息安全。3.2.4停车设施运营平台应建立动态密钥生成与管理机制,以增强数据传输和存储的安全性。在数据交互过程中,应采用临时密钥进行加密解密操作,避免使用固定的敏感信息作为参数直接传递,防止密钥泄露带来的安全隐患。3.2.5停车设施运营平台使用的加解密算法和密钥管理机制应符合国家相关规定和标准要求,加密算法应优先采用国密算法。54系统架构注:1上行:外部系统或平台作为发起方,推送数据给停车设施运营平台的数据方向。2下行:停车设施运营平台作为发起方,推送数据给外部系统或平台的数据方向。5通用规定5.1数据传输规定5.1.1数据传输一般流程应按下列步骤进行:停车设施运营平台数据接入应符合现行国家标准GB/T9387.1的有关规定,关于会话连接的要求,一般需要经过平台认证、请求和应答三个步骤。5.1.2数据传输接口应符合下列规定:1提供给外部系统或平台的数据传输采用应用层HTTP(s)协2每个接口的URL均采用如下格式定义:http(s):I域名]parking'v[版本号接口名称]1)域名:各停车设施运营平台的运营商所属域名;2)版本号:代表接口版本号,系统升级期间,新旧版本可共存,待所有接入方都切换到新接口,旧接口即可下线;3)接口名称:所请求调用接口的名称,具体接口名称见:6.1、6.2、6.3的规定。:3为保证各接口的功能明确清晰,每个URL只允许对应一种功能。5.1.3数据传输接口适用范围应包括下列内容:所有数据接口均适用于停车设施运营平台、机械车库运营平台、停车场(库)管理系统、路内停车管理系统、第三方停车运营平台。5.2传输安全规定5.2.1平台认证模式应满足下列要求:1平台认证模式应支持分布式认证模式或中心交换认证模式,6以满足不同场景下的安全需求,具体结构参见图5.2.12分布式认证模式由各平台运营商之间进行鉴权认证,具体认证方式由运营商协商确定。3中心交换认证模式由统一的认证服务方提供鉴权认证服务,具体认证方式由各运营商和认证服务方共同确定。图5.2.1平台认证模式5.2.2平台认证方法应符合下列规定:1平台认证宜结合身份认证和访问控制,1平台认证宜结合身份认证和访问控制,相关流程如图5.2.2所示身份认证可采取用户名口令认证、密钥认证或数字证书认证等方式进行;访问控制可采取IP访问控制、时间访问控制等多种手段结合。2认证成功后,服务方签发不超过7天有效期的临时密钥或认证信息,客户端每次请求时须携带临时密钥,服务方验证通过后返3密钥或认证信息失效、丢失时须重新认证。分布式认证规定由各运营方协商确定。图5.2.2图平台认证流程5.2.3数据加解密应符合下列规定:1所有数据不可明文传输,为保证数据传输的安全,并适应技术和标准的发展,数据传输过程中应采取加解密措施。2所有数据传输应具备动态更新、分级保护和审计追溯能力,同时提供防错、容错、合法性校验等机制。5.2.4为保障接口安全调用,5.2.4为保障接口安全调用,所有请求接口都需要携带签名,请求接收方需根据请求参数,对签名进行验证,拒绝签名不合法的请求。签名的加密算法由各停车设施运营平台运营商之间协商确定。5.3公共参数5.3.1公共参数是指用于标识用户和接口鉴权目的的参数。公共参数清单应符合表5.3.1规定。通用参数数据类型说明headstring是请求头,通用参数数据类型说明headstring是请求头,包含请求的公共参数bodystring请求体,包含具体请求的业务参数accessId32访问标识,由平台生成分配给外部系统或平台的唯一接入编号sting是签名的加密算法,如SHA256string255是请求参数签名结果,具体加密算法由各停车设施运营平台运营商之间协商确定-iu.'-iu.'是是rr5.3.2head详细参数应符合表5.3.2规定。5.3.2表5.3.2head详细参数表通用参数数据类型长度限定是否必填说明string64是请求消息来源timestamplong13是时间戳,采用UTC+8unix毫秒级时间戳。系统请求最大时间误差为5minversionstring32是版本号,默认1.05.4请求返回规定5.4.1请求返回参数应遵循统一的格式,确保数据交互的准确性和可读性,请求返回参数应符合表5.4.1规定。表5.4.1请求返回参数表通用参数数据类型是否必填说明headstring是请求头,包含请求的公共参数bodystring是符合表5.4.2规定。通用参数数据类型是否必填codeint是msgstring是result通用参数数据类型是否必填codeint是msgstring是resultstringw说明w说明6接口数据规定6.1静态数据规定6.1.1静态数据为停车场运行过程中产生的基础数据,停车场基础信息接口应符合表6.1.1规定。表6.1.1停车场基础信息表请求方法:POST业务参数数据类型长度限定说明thirdparkingcodestring第三方停车场编码,接口请求方定义string停车场名称parkingpropertyint是停车场性质:1路内停车场2路外停车场parkingType是停车场类型:1公共停车场;2配建停车场;3临时停车场;4其他停车场int是服务类型:1商业;2住宅;3医院;4园区;5交通枢纽;6行政机关;7学校;8其他contactsstring20否联系人contactphonestring20否联系电话provinceldint10是省份行政区划编码,详见GB/T2260GB/T10114cityIdint10是城市行政区划编码,详见GB/T2260GB/T10114districtIdint10是城区行政区划编码,详见GB/T2260GB/T10114streetIdint10是街道行政区划编码,可传默认值0,详见GB/T2260、GB/T10114",.是",.是是是wi.wi.是是续表6.1.1业务参数数据类型长度限定是否必填说明addressstring255是停车场地址longitudestring20是停车场经度,采用GCJ-02坐标系latitudestring20是停车场纬度,停车场纬度,采用GCJ-02int6是总车位数int6是int6是int6是int1是int1预约状态ri可预约2不可预约int5否int是是否支持车位长租:1支持2不支持int是否支持无感支付1支持;2不支持parkingurl"s,-"s,-是车场图片url,多张图片用英文逗号间隔'是'是营业时间:示例8:00-20:00int-否共享状态:1可共享;2不可共享int1否充电状态:1支持充电;2不支持充电string255是收费标准描述int6是提前缴费免费离场时间:单位为分钟reservationparamList否预约参数reservecancelint6否每日可取消X次预约reserveBreakint6否每月可违约X次预约typeint1是操作类型:1新增,2修改,3删除othersobject否扩展参数,若有其他约定可在此传值续表6.1.1reservationparam参数业务参数数据类型长度限定是否必填说明reserveTimeint6否预约保留时长单位分钟reserveFeeint6否返回参数业务参数数据类型说明codeintI11sgstringresultobjectparkingcodestring接口服务方停车场编码:接口请求方请求接口,接口服务方返回对应的服务方停车场编码,以实现不同平台间的停车场信息映射6.1.2设备基础信息接口应符合表6.1.2规定。表6.1.2设备基础信息表请求协议:-http/https请求方法::请求参数业务参数业务参数数据类型长度限定是否必填说明deviceIdstring60是设备IDdeviceNamestring60是设备名称parkingcodestring45是接口服务方停车场编码,系统中唯一string45是停车场名称channelcodestring60否通道编号,路外停车场必传续表6.1.2业务参数数据类型长度限定是否必填说明channelNamestring60否通道名称,路外停车场必传int3否设备品类IDstring50否manufacturerstring50是productModelstring50是int3是地址;3MAC地址;4串口设备标识ID地址;3MAC地址;4串口/RS485identifyvaluestring60是设备标识值:设备标识ID对应的值onlinestateint6是是设备在线状态1在线;2离线subDeviceldList否子设备string50否关联车位号:路内停车泊位必传typeint是操作类型:1新增;2修改;3删除others否扩展参数,若有其他约定可在此传值数据类型说明codeint状态0:成功,其他应符合本标准附录A的有关规定msgstring描述6.2动态数据规定6.2.1动态数据为停车场运行过程中产生的实时数据和状态数据。车辆入场信息接口应符合表6.2.1规定。所有车辆都要传输,且必须保持实时。表6.2.1车辆入场信息请求方法:POST请求地址:域名]/parking/v[版本号]/traffic请求参数业务参数数据类型长度限定是否必填说明uidstring60是车辆到达流水号:停车场编号+入口通道编号+时间戳 (YYYYMMddHHmmss)inIdstring60是string50是车牌号码parkingcodestring45是inGatecodestring否入口通道编号,路内停车管理系统不传inGateNamestring否否入口通道名称,路内停车管理系统不传inoperatorcodestring否操作员编号否操作员类型:1岗亭收费员;2远程值守人员;3路内收费员;4车场管理员;5其他intint是车位总数int6是开放车位数int6是剩余开放车位数inTimestring20是到达时间(格式:yyyy-MM-ddHH:mm:ss)parkingTypeint1是停车类型:1临时车;2固定车3月租车;4特殊车platecolorint1是车牌颜色:1蓝色;2黄色;3白色;4黑色;5绿色;6临牌;7其他string20是上传时间(格式:yyyy-MM-ddHH:mm:ss)inurlstring255是入场图照片url续表6.2.1业务参数数据类型长度限定是否必填说明parkingstateint1是车辆进出状态:1在场;2场外othersobject否扩展参数,若有其他约定可在此传值返回参数业务参数数据类型说明codeint状态0:成功,其他应符合本标准附录A的有关规定msgstring6.2.2车辆出场信息接口应符合表6.2.2规定。所有车辆都要传输·6.2.2车辆出场信息接口应符合表6.2.2规定。所有车辆都要传输·请求地址:http(s):T域名]/parking/v[版本号]/trafficcarRecord/caroutRecord请求地址:http(s):T域名]/parking/v[版本号]/trafficcarRecord/caroutRecord业务参数说明uidstring是车辆到达流水号:停车场编号+入口编号+时间戳 60是车辆离开记录idstring50是车牌号码,无牌车传输虚拟车牌号,未检测出号牌填parkingcodestring45是接口服务方停车场编码,系统中唯一inGatecodestring50否入口通道编号,路内停车管理系统不传inGateNamestring50否入口通道名称,路内停车管理系统不传outGatecodestring50否出口通道编号,路内停车管理系统不传outGateNamestring50否出口通道名称,路内停车管理系统不传续表6.2.2业务参数数据类型长度限定是否必填说明string否操作员编号operatorTypeint否操作员类型:1岗亭收费员;2远程值守人员;3路内收费员;4车场管理员;5其他int是int是开放举位数int是inTimestring是到达时间(格式:yyyy-MM-ddHH:mm:ss)outTimestring离开时间;(格式:yyyy-MM-longTimestring否parkingTypeint停车类型:临时车2固定车;3月租车;4特殊车platecolorint是车牌颜色:1蓝色;2黄色;3白色;4黑色;5绿色;6临牌;7其他是上传时间(格式:yyyy-MM-ddHH:mm:ss)是出场图照片urlint否计费金额(单位:分)int否应收金额(单位:分)int否车辆进出状态:1在场;2场外othersobject否扩展参数,若有其他约定可在此传值返回参数业务参数数据类型说明codeint状态0:成功,其他应符合本标准附录A的有关规定string描述否否6.3其他数据规定6.3.1停车场余位数据校对接口应符合表6.3.1规定。接口调用频率由各停车设施运营平台运营商之间协商确定。表6.3.1停车场余位数据校对表请求方法:请求参数业务参数数据类型长度限定是否必填parkingcodestring45是接口服务方停车场编码,系统中唯一int6leftNumberint6.是是othersobject扩展参数,若有其他约定可返参数业务参数数据类型说明codeintint状态0:成功,其他应符合本标准附录A的有关规定I11sgstring描述附录A(规范性)请求返回值说明表A.0.1概述本附录用于指导停车设施运营平台在接入开发过程对返回参数的结果对照。A.0.1请求返回值说明表中文描述code中文描述codemsgCODE_SUCCESSCODE_HTTP_REQUEST_ERROR非法参数请求超时过大请求url不存在,请检查accessId不存在签名为空加解密异常CODE_APL_CLIENT_FALLBACKAPI接口返回异常参数缺失CODE_CONTENT_TYPE_EXCEPTIONcontent-Type/Accept不合法CODE_BODY_ILLEGAL请求body不合法,格式应为JSONCODE_CIPHER_EXCEPTION加解密异常CODE_PARKING_CODE_NOT_FOUND停车场编码不存在CODE_PARKING_CODE_IS_EXIST停车场编码已存在CODE_GET_PARKING_LIST_EXCEPTION获取停车场列表异常CODE_CODE_PARAMETER_MISSING本标准用词说明11为便于在执行本标准条文时区别对待,对要求严格程度不同的用词说明如下:1)表示很严格,非这样做不可的:正面词采用正面词采用su必须",反面词采用su严禁";2)表示严格,在正常情况下均应这样做的:正面词采用"应",反面词采用不应"或"不得";3)表示允许稍有选择,在条件许可时首先应这样做的:正面词采用"宜",反面词采用不宜";的4)表示有选择,在一定条件下可以这样做的,采用"可"。2条文中指明按其他有关标准执行的写法为:"应符合的规定"或规定"或"应按引用标准名录《信息安全技术信息系统通用安全技术要求》GB/T20271《信息安全技术网络安全等级保护基本要求》GB/T22239《信息安全技术网络安全等级保护定级指南》GB/T22240《公共停车场(库)信息联网通用技术要求》GB/T29745《智慧城市智慧停车第2部分:数据要求》GB/T42442.22024《智慧城市智慧停车第3部分:平台技术要求》GB/T42442.3《城市道路路内停车管理设施应用指南》GA/T1271201S《停车服务与管理信息系统通用技术条件》GA/T《电动汽车充换电服务信息交换》T/CEC102.1《互联网数据中心和互联网接入服务信息安全管理系统技术要求》YD/T2248 2023《停车场(库)联网接入技术要求》DB4501/T 2023山西省工程建设地方标准停车设施运营平台数据接入标准DBJ04/T5042025条文说明251总则253基本规定3.1数据质量规定3.227信息安全规定3.2274系统架构4系统整体架构4.2数据接口清单4.25通用规定5数据传输规定5.2传输安全规定5.25.3公共参数5.3315.4请求返回规定315.432接口数据规定3232静态数据规定3232动态数据规定3232其他数据规定3223251.0.1本条说明本标准编制的目的。为规范城镇公共停车场管理系统的建设,确定重点区域停车场管理系统搭建的技术依据,需合理确定数据接口的建设要求、功能要求、数据传输等要求。规范停车场数据接入标准,有利于提高城市交通精细化管理水平,缓解停车供需矛盾,加强政府相关项目管理和监督,提高决策科学化和建设项目管理水平,实现山西省静态交通行业的数据互联互通,助力城市治理,制定本标准。1.0.2本条说明了本标准编制的适用范围。本标准所称城市指山西省行政区域的城镇,包括城市和建制镇,并且明确只是停放机动车的公共停车场(库),本标准所称机械车库运营平台、停车场(库)管理系统、路内停车管理系统、第三方停车运营平台,统称为外部系统或平台。1.0.3本条说明了本标准与国家、行业及地方标准现行有关标准的关系。3基本规定3.1数据质量规定3.1.1对停车设施运营平台(下称平台")数据传输的完整性质量提出要求,规定了平台应具备的差错重传机制和数据缓存的功能。差错重传是差错控制中的一种基本策略,指接口调用方检测到数据错误后,通过反馈机制要求接口服务方重新传输数据的一种机制。、成都市地方标准DB5101/T对平台的数据传输时效性提出指标规定,传输同步时延控制在5S的推荐值参考现行国家标准GB/T42442.22024、行业内广东省地方标准DB44/T2275、成都市地方标准DB5101/T54.22019,综合考虑用户体验与系统成本。Y3.1.3对平台的数据传输准确性提出指标规定,误差(停车设施运营平台入场记录+离场记录)(外部系统或平台入场记录+离场记录)],推荐值参考现行国家标准GB/T42442.22024及威海市地方标准DB3710/T2022023Y3.1.43.1.5对平台数据传输的唯一性、匹配性提出进一步规定,保证数据传输的完整可用。,总时间为统计周期3.1.6对平台与外部系统或平台的联网在线率提出规定,平台联网在线率=(平台在线通信时长总时间),总时间为统计周期内的总时长,平台在线通信时长为统计周期内外部系统与平台保持数据通信的时长。推荐值参考现行国家标准GB/T42442.2-2024及威海市地方标准DB3710/T2022023。3.1.7对平台的数据传输提出时间标准定义,避免由于时间标准不一致导致传输的时间数据出现误差的问题。3.1.8对平台应符合的其他标准提出规定。263.2信息安全规定3.2.1~3.2.3对停车设施运营平台提出应符合的国家及行业信息安全相关的标准规定要求。3.2.4对平台的数据传输安全密钥管理提出规定要求,如使用固定或静态的密钥或管理机制,存在密钥泄露导致信息不安全的风险2.5对平台的数据传输使用的安全算法提出规定要求9应优先采用国密算法。4系统架构4.1系统整体架构4.1.1规定了停车设施运营平台与机械车库运营平台、停车场库)管理系统、路内停车管理系统、第三方停车运营平台(以下统称为外部系统或平台")的数据交互架构图。停车设施运营平台与外部系统或平台之间的数据交互是双向的,停车设施运营平台既可以作为发起方,推送数据给外部系统或平台,也可以作为接收方,接收外部系统或平台推送的数据。4.2数据接口清单4.2.1规定了停车设施运营平台需要技术对接的数据接口清单,并规定了接口支持的协议及数据方向。下列缩略语的解释适用于本标准文件。API:应用程序编程接口(ApplicationprogrammingInterface)ID:唯一标识编码(uniqueidentificationcode);:轻量级数据交换格式(JavascriptobjectNotation);HTTPS:超文本传输安全协议(HypertextTransferprotocolsecure)URL:统一资源定位符(uniformResourceLocator)JPG:面向连续色调静止图像的一种压缩标准,即JPEG(JointPOST:HTTPS协议中的数据请求方法UTF-8:针对unicode的可变长度字符编码(8位元,universalcharacterset/unicodeTransformationFormat)UTC+8:比世界协调时间(UTC)快8小时的东八区(UTC+08:00)时间NTP:使计算机时间同步化的网络时钟协议(NetworkTimeprotocol)PTP:使计算机时间同步化的高精度时间同步协议(precision5通用规定5.1数据传输规