DB4501_T 0012—2023南宁市地方标准《停车场（库）联网接入技术要求》.docx

ICS 03.220.20;35.240.60CCS R 854501 南宁市地方标准DB4501/T 00122023停车场（库）联网接入技术要求Technical requirements of parking lot networking access2023 - 06 - 25 发布2023 - 07 - 28 实施南宁市市场监督管理局发 布目次前言II1 范围32 规范性引用文件33 术语和定义34 联网接入流程45 接入方式要求66 联网接入基本要求67 数据接入要求78 接口要求8附录 A（资料性） 请求返回值说明表18参考文献19前言本文件按照GB/T 1.12020标准化工作导则 第1部分：标准化文件的结构和起草规则的规定起草。 本文件的某些内容可能涉及专利。本文件的发布机构不承担识别这些专利的责任。本文件由南宁市公安局提出、归口并宣贯。 本文件起草单位：南宁市公安局交通警察支队、中国移动通信集团广西有限公司、成都旋极历通信息技术有限公司。 本文件主要起草人：林俊旭、韦东明、王灏、覃作金、孙云燕、陈霆、许翔、王睿、张炜、苏林、杨虎跃、李程、韦勇、叶明、楚昌福、罗凯伦、朱作飞、周桂俊。 本文件在实施过程中如有建议或疑问，归口单位负责解释及分析处理。意见和建议反馈渠道如下： 归口单位（南宁市公安局）： 通讯地址：南宁市青秀区厢竹大道46号； 联系电话：[phone]； 电子邮箱：289633013。 主要起草单位（南宁市公安局交通警察支队）： 通讯地址：南宁市青秀区贤宾路3号； 联系电话：[phone]； 电子邮箱：ssdd3181182。 停车场（库）联网接入技术要求1 范围本文件界定了停车场（库）联网接入的术语和定义，规定了联网接入流程、接入方式要求、联网接入基本要求、数据接入要求和接口要求。 本文件适用于南宁市内的机动车停车场（库）的联网接入。 2 规范性引用文件本文件没有规范性引用文件。 3 术语和定义下列术语和定义适用于本文件。 3.1停车场(库) parking lot来源: GB/T 51149-2016，2.0.1，有修改 3.2大数据平台 big data platform主管部门建设的停车信息汇聚和管理平台，是停车场（库）联网接入的对象。 3.3管理责任单位 management unit对停车场（库）负有直接管理责任的企事业单位或个体，是停车场（库）进行联网接入的责任主体。 3.4停车场服务平台 parking lot service platform主管部门建设的供管理责任单位填报停车场（库）信息、提交联网接入申请、完成数据上报、实现联网信息查询和享受相关服务的平台。 3.5联网接入 internet access管理责任单位按照本文件要求，将停车场（库）数据上报到大数据平台。 3.6参 数 parameters停车场（库）数据上报大数据平台需要的唯一配对数据。 3.7静态数据 static data停车场（库）名称、地址、经度、纬度、联系方式、停车场类型、泊位总数、入口数量、出口数量、收费标准。 供机动车停放的场所及地上、地下构筑物。一般由出入口、停车位、通道及附属设施组成。 3.8动态数据 dynamic data停车场（库）剩余泊位数据、进出车辆数据、车辆欠费数据、图片数据。 3.9车 道 lane停车场（库）提供机动车进出场的通道。 4 联网接入流程4.1 一般流程管理责任单位申请联网接入的流程分为以下4步： a) 注册服务平台账号； b) 填报停车场（库）基础信息； c) 大数据平台校核； d) 联网接入申请。 停车场（库）联网接入一般流程见图1。 图1 停车场（库）联网接入一般流程图 4.2 注册服务平台账号注册服务平台账号的流程见图2。 图2 注册服务平台账号流程图 4.3 填报停车场（库）基础信息管理责任单位填报停车场（库）基础信息，信息应包括停车场（库）名称、地址、经纬度、泊位数、出入口、车场图片等。流程见图3。 图3 填报停车场（库）基础信息流程图4.4 大数据平台校核校核第二步管理责任单位提交内容的完整性、准确性。大数据平台校核流程见图4。 图4 大数据平台校核流程图4.5 联网接入申请管理责任单位联网接入申请流程见图5。 图5 联网接入申请流程图 5 接入方式要求接入方式要求见表1。 表1 接入方式要求表内容 要求 网络接口协议 http/https（POST 方式） 字符编码格式 UTF-8 数据格式 json 格式（请求和返回均采用） 数据加密 RSA 不对称加密 数据密钥 公钥由大数据平台提供，私钥管理责任单位自行保留 签名算法 国密加密（64 位大写） 签名密钥 由大数据平台提供 （联网接入申请通过后登录服务平台可获取，见 4.5） 签名方式 见 7.3 接入号 由大数据平台提供（联网接入申请通过后登录服务平台可获取，见 4.5） 6 联网接入基本要求6.1 基本约束要求联网接入基本约束要求如下： a) 停车场（库）应有互联网且停车场（库）设备满足联网要求，互联网带宽不应低于 20M； b) 管理责任单位应完成联网接入申请。 6.2 上传内容要求6.2.1 停车场（库）余位上报要求停车场（库）每一次上报车辆入场或车辆出场数据的同时，应上报停车场（库）剩余车位信息。 6.2.2 车辆入场和出场图片要求具体如下： a) 像素应为 100K200K； b) 分辨率应为 24 位真彩图像，分辨率不低于 960*540； c) 内容要素应包含机动车前部（或后部）全貌、号牌、颜色、车型、环境位置等； d) 每张图片应叠加水印信息，内容应包括车辆出场时间、入场时间、号牌、车牌颜色等内容。 6.3 数据上传连续性要求具体如下： a) 停车场（库）应至少每 10 分钟向大数据平台发送一次信号数据，连续缺失 3 次的，大数据平台下发告警信息（见 8.3.1）； b) 若停车场（库）设备停用，应立即上报停用信息（见 8.2.4）。 7.3 业务参数加密方式业务参数加密方式如下： a) 所有业务参数组成 json 串； b) 使用 RSA 公钥(由大数据平台提供)对上述 json 串进行加密，获得一个加密字符串； c) 使用上行通用参数中 parameter 作为 key，加密字符串作为 value，组成新的 json。 7.4 通用签名参数签名方式上行通用参数+签名密钥signKey，按照key=value&key=value格式组成字符串，获得通用签名参数。 示例：openCode=alpha&serialNum=123&signKey=abc×tamp=20201122085957 使用国密算法将通用签名参数进行加密，应使用64位大写算法，获得的加密串为当次通用签名参数的签名。 7.5 流水号生成规则请求流水号serialNum一共32位，单独标识每一次请求，每次请求的流水号应不同。流水号生成规则见表3。 7 数据接入要求7.1 一般要求数据接入的数据参数类型如下： a) 上行通用参数：即数据接入请求参数，见表 2； b) 业务参数：即实际需要接入的数据参数，见表 5表 17； c) 通用签名参数：即上行通用参数签名密钥； d) 返回参数：即大数据平台返回给请求方的数据，见表 4。 7.2 上行通用参数要求上行通用参数要求见表2。 表2 上行通用参数要求表请求链接：由大平台按实际情况提供 http/https 请求地址网络协议：http/https，POST 方式 请求类型：application/json;charset=utf-8 上行通用参数 数据类型 长度限定 是否应填 说明 openCode string 64 是 联网接入申请通过后登录服务平台可获取，见 4.5 timeStamp string 14 是 yyyyMMddHHmmss，当前时间戳 serialNum string 32 是 请求流水号，全数字，接入方自定义，生成规则见 7.5 parameter string 不限 是 加密业务参数串，加密方式见 7.3 sign string 64 是 签名，签名方式见 7.4 表3 流水号生成规则表第 1-11 位 第 12-25 位 第 26-32 位 停车场编号 当前时间戳(yyyyMMddHHmmss) 7 位随机数(1000000-9999999) 7.6 返回参数返回参数见表4。 表4 返回参数表返回参数 数据类型 长度限定 是否应填 说明 resultCode string 8 是 见附录 A resultMsg string 128 是 见附录 A sysTime string 14 是 平台当前的系统时间戳，可用于系统时间校准(yyyyMMddHHmmss) data T / 否 实际返回业务参数 7.7 接入参数管理每个停车场（库）应有一套独立的接入参数，包括停车场编号、接入号、加密公钥、签名私钥。具体关系见图6。 注： 管理责任单位针对每个停车场（库）单独发起联网接入申请；停车场（库）取消或者停用后，接入号即失效。 图6 接入参数与停车场（库）对应关系图8 接口要求8.1 一般规定8.1.1 上报数据按照上报要求分为应报项和宜报项，按数据变化频率分为静态数据和动态数据。应报项为应进行上报的数据；宜报项为管理责任单位根据实际情况选择性上报的数据。 8.1.2 应报项包括“停车场（库）基础信息表”、“车道基础信息表”、“设备基础信息表”、“信号数据表”“车辆入场数据表”、“车辆出场数据表”、“图片数据上传表”。其中，“停车场（库） 基础信息”、“车道基础信息”、“设备基础信息”为静态数据；“信号数据”、“车辆入场数据”、“车辆出场数据”、“图片数据”为动态数据。 8.1.3 宜报项包括“车道和设备停用信息表”、“缴费信息表”、“欠费信息表”、“欠费催缴信息表”、“查询车辆欠费信息表”、“数据校对表”、“业务编码下载表”、“系统校时表”。其中，“车道和设备停用信息”为静态数据；“缴费信息”、“欠费信息”、“欠费催缴信息”、“查询车辆欠费信息”为动态数据。 8.2 静态数据上报8.2.1 停车场（库）基础信息见表 5。 表5 停车场（库）基础信息表请求链接：由大数据平台按实际情况提供 http/https 请求地址网络协议：http/https，POST 方式 请求类型：application/json;charset=utf-8 适用范围：所有机动车停车场（库） 请求地址：http:/ip:port/internet/parklotReport 业务参数 数据类型 长度限定 是否应填 说明 parklotCode string 32 是 网接入申请通过后登录服务平台可获取，见 4.5 parklotName string 256 是 停车场（库）名称 address string 512 是 停车场（库）地址 lng string 16 是 经度 lat string 16 是 纬度 contactName string 32 否 联系人姓名 contactPhone string 32 否 联系人电话 parklotType int / 是 停车场类型(1-公共停车场 2-专用停车场 3-道路停车位) berthCount int / 是 泊位总数 inCount int / 是 入口数量 outCount int / 是 出口数量 high int / 否 最低限高(单位：厘米) equipCount int / 否 设备总数(道路停车泊位根据实际情况上报) feeScale string 256 否 收费标准(文字描述) 返回内容 返回参数 / / / 参见 7.6 注1：公共停车场，是指根据规划独立建设或者公共建筑配套建设的，以及在城市道路以外临时占地设置的供社会公众停放车辆的场所。 注2：专用停车场，是指为特定对象提供车辆停放的场所。 注3：道路停车位，是指依法在城市道路上设置的供车辆临时停放的车位，包括车行道停车位和人行道停车位。 8.2.2 车道基础信息见表 6。 表6 车道基础信息表请求链接：由大数据平台按实际情况提供 http/https 请求地址网络协议：http/https，POST 方式 请求类型：application/json;charset=utf-8 适用范围：道路停车位之外的所有机动车停车场（库） 请求地址：http:/ip:port/internet/laneReport 请求参数 业务参数 数据类型 长度限定 是否应填 说明 parklotCode string 32 是 联网接入申请通过后登录服务平台可获取，见 4.5 laneCode string 32 是 车道编号(同一个停车场（库）内唯一) laneName string 64 是 车道名称 laneType int / 是 车道类型(1-入口 2-出口 3-同进同出) 返回内容 返回参数 / / / 参见 7.6 8.2.3 设备基础信息见表 7。 表7 设备基础信息表请求链接：由大数据平台按实际情况提供 http/https 请求地址网络协议：http/https，POST 方式 请求类型：application/json;charset=utf-8 适用范围：道路停车位之外的所有机动车停车场（库） 请求地址：http:/ip:port/internet/equipReport 业务参数 数据类型 长度限定 是否应填 说明 parklotCode string 32 是 联网接入申请通过后登录服务平台可获取，见 4.5 laneCode string 32 是 车道编号 equipCode string 32 是 设备编号(同车道内唯一) equipName string 64 否 设备名称 equipType int / 是 设备类型 (1-相机 2-道闸 3-监控 4-工控机 0-其他) factory string 32 否 厂家(字典编号) 返回内容 返回参数 / / / 参见 7.6 8.2.4 车道和设备停用信息见表 8。 表8 车道和设备停用信息表请求链接：由大数据平台按实际情况提供 http/https 请求地址网络协议：http/https，POST 方式 请求类型：application/json；charset=utf-8 适用范围：道路停车位之外的所有机动车停车场（库） 请求地址：http:/ip:port/internet/updateLaneOrEquip 业务参数 数据类型 长度限定 是否应填 说明 parklotCode string 32 是 联网接入申请通过后登录服务平台可获取，见 4.5 type int / 是 类型(1-车道 2-设备) code string 32 是 编号(type=1 时为车道编号， type=2 时为设备编号) 返回内容 返回参数 / / / 参见 7.6 8.3.1 信号数据见表 9。 表9 信号数据表 8.3 动态数据上报概述：每个设备每 10 分钟上传一次信号数据，丢失 3 次数据的设备，视为异常请求链接：由大数据平台按实际情况提供 http/https 请求地址 网络协议：http/https，POST 方式 请求类型：application/json;charset=utf-8 适用范围：道路停车位之外的所有机动车停车场（库） 请求地址：http:/ip:port/internet/heartBeatReport 业务参数 数据类型 长度限定 是否应填 说明 parklotCode string 32 是 联网接入申请通过后登录服务平台可获取，见 4.5 laneCode string 32 是 车道编号 equipCode string 32 是 设备编号 返回内容 返回参数 / / / 参见 7.6 8.3.2 车辆入场数据见表 10。 表10 车辆入场数据表概述：所有车辆都应上报，且应实时 请求链接：由大数据平台按实际情况提供 http/https 请求地址网络协议：http/https，POST 方式 请求类型：application/json;charset=utf-8 适用范围：所有机动车停车场（库）(道路停车位若只有停车记录，则入场过车记录编号为停车记录+A) 请求地址：http:/ip:port/internet/carIn 业务参数 数据类型 长度限定 是否应填 说明 parklotCode string 32 是 联网接入申请通过后登录服务平台可获取，见 4.5 recordCode string 32 是 接入方过车记录唯一编号 laneCode string 32 是 车道号 plate string 16 是 车牌号（无牌车上传“无牌车”统一字样） plateColor int / 是 车牌颜色(0-蓝色 1-黄色 2-黑色 3-白色 4-绿色 5-黄绿色) passTime string 14 是 过车时间(yyyyMMddHHmmss) picCode string 64 是 过车图片编号 remain int / 是 入场后余位信息 normal int / 是 是否正常上报(1-正常上报 0-校验后补报) 返回内容 返回参数 / / / 参见 7.6 8.3.3 车辆出场数据见表 11。 表11 车辆出场数据表概述：所有车辆都要上报，且应实时，平台会统计上报实时率 请求链接：由大数据平台按实际情况提供 http/https 请求地址网络协议：http/https，POST 方式 请求类型：application/json;charset=utf-8 适用范围：所有机动车停车场（库）(道路停车位若只有停车记录，则出场过车记录编号为停车记录+B) 请求地址：http:/ip:port/internet/carOut 业务参数 数据类型 长度限定 是否应填 说明 parklotCode string 32 是 联网接入申请通过后登录服务平台可获取，见 4.5 recordCode string 32 是 接入方过车记录唯一编号 inRecordCode string 32 是 对应的入场记录唯一编号 laneCode string 32 是 车道号 plate string 16 是 车牌号 plateColor int / 是 车牌颜色(0-蓝色 1-黄色 2-黑色 3-白色 4-绿色 5-黄绿色) passTime string 14 是 过车时间(yyyyMMddHHmmss) 表11 车辆出场数据表（续）业务参数 数据类型 长度限定 是否应填 说明 picCode string 64 是 过车图片编号 shouldPay int / 是 应收金额(单位：分) actualPay int / 是 实收金额(单位：分)敏感信息可为 0 outType int / 是 离场类型(1-缴费离场 2-欠费离场) remain int / 是 出场后余位信息 normal int / 是 是否正常上报(1-正常上报 0-校验后补报) plate string 16 是 车牌号 返回内容 返回参数 / / / 参见 7.6 8.3.4 缴费信息见表 12。 表12 缴费信息表概述：上报车辆真实缴费记录(欠费离场不需要上报) ，且应实时，平台会统计上报实时率请求链接：由大数据平台按实际情况提供 http/https 请求地址 网络协议：http/https，POST 方式 请求类型：application/json;charset=utf-8 适用范围：所有机动车停车场（库） 请求地址：http:/ip:port/internet/carPayRecord 业务参数 数据类型 长度限定 是否应填 说明 parklotCode string 32 是 联网接入申请通过后登录服务平台可获取，见 4.5 recordCode string 32 是 接入方缴费记录唯一编号 inRecordCode string 32 否 接入方入场记录唯一编号 outRecordCode string 32 是 接入方出场纪录唯一编号 roadType int / 是 0-道路停车泊位 1-非道路停车泊位停车场（库） plate string 16 是 车牌号 plateColor int / 是 车牌颜色(0-蓝色 1-黄色 2-黑色 3-白色 4-绿色 5-黄绿色) shouldPay int / 是 应收金额(单位：分) actualPay int / 是 实收金额(单位：分) payTime string 14 是 支付时间(yyyyMMddHHmmss) payType int / 是 支付方式(0-现金 1-支付宝 2-微信 3-ETC 4-银联 5-市民卡 6-月卡 7-优惠券 8-数字人民币 9-其他) openRecord string 128 否 三方支付订单编号(支付宝、微信等三方的支付编号) recordType int / 是 缴费类型(1-正常缴费 2-欠费补缴) normal int / 是 是否正常上报(1-正常上报 0-校验后补报) arrearCodes array / 否 欠费编号主节点，若 recordType=2，则需上报对应的欠费记录编号 返回内容 返回参数 / / / 参见 7.6 8.3.6 欠费催缴信息见表 14。 表14 欠费催缴信息表 8.3.5 欠费信息见表 13。 表13 欠费信息表概述：欠费离场的车辆上报欠费信息 请求链接：由大数据平台按实际情况提供 http/https 请求地址网络协议：http/https，POST 方式 请求类型：application/json;charset=utf-8 适用范围：道路停车位 请求地址：http:/ip:port/internet/arrearReport 业务参数 数据类型 长度限定 是否应填 说明 parklotCode string 32 是 联网接入申请通过后登录服务平台可获取，见 4.5 recordCode string 32 是 接入方欠费记录唯一编号 inRecordCode string 32 否 接入方入场记录唯一编号 outRecordCode string 32 是 接入方出场记录唯一编号 plate string 16 是 车牌号 plateColor int / 是 车牌颜色(0-蓝色 1-黄色 2-黑色 3-白色 4-绿色 5-黄绿色) arrearTime string 14 是 欠费离场时间(yyyyMMddHHmmss) shouldPay int / 是 应收金额(单位：分) arrearFee int / 是 欠费金额(单位：分) 返回内容 返回参数 / / / 参见 7.6 概述：道路停车泊位运营方,向欠费车主进行催缴的信息上报 请求链接：由大数据平台按实际情况提供 http/https 请求地址网络协议：http/https，POST 方式 请求类型：application/json;charset=utf-8 适用范围：道路停车位 请求地址：http:/ip:port/internet/arrearUrge 业务参数 数据类型 长度限定 是否应填 说明 parklotCode string 32 是 联网接入申请通过后登录服务平台可获取，见 4.5 recordCode string 32 是 接入方欠费记录唯一编号 plate string 16 是 车牌号 plateColor int / 是 车牌颜色(0-蓝色 1-黄色 2-黑色 3-白色 4-绿色 5-黄绿色) urgeTime string 14 是 催缴时间(yyyyMMddHHmmss) 返回内容 返回参数 / / / 参见 7.6 8.3.7 图片数据上传见表 15。 表15 图片数据上传表概述：过车图片数据上传 请求链接：由大数据平台按实际情况提供 http/https 请求地址网络协议：http/https，POST 方式 请求类型：application/json;charset=utf-8 适用范围：所有机动车停车场（库） 请求地址：http:/ip:port/internet/picReport 业务参数 数据类型 长度限定 是否应填 说明 parklotCode string 32 是 联网接入申请通过后登录服务平台可获取，见 4.5 fileName string 100 是 文件名 fileSize string 50 是 文件大小(xxK 或xxM) fileType string 5 是 文件类型(png、jpg 等) base64 string / 是 文件 BASE64 码 passTime string 14 是 出入场过车时间 返回内容 返回参数 / / / 参见 7.6 picCode string 64 是 图片编号 8.3.8 查询车辆欠费信息见表 16。 表16 查询车辆欠费信息表概述：查询车辆欠费信息 请求链接：由大数据平台按实际情况提供 http/https 请求地址网络协议：http/https，POST 方式 请求类型：content-type=multipart/form-data 适用范围：适用于道路停车位之外的所有机动车停车场（库） 请求地址：http:/ip:port/internet/queryArearInfo 业务参数 数据类型 长度限定 是否应填 说明 parklotCode string 32 是 联网接入申请通过后登录服务平台可获取，见 4.5 plate string 16 是 车牌号 plateColor int / 是 车牌颜色(0-蓝色 1-黄色 2-黑色 3-白色 4-绿色 5-黄绿色) 返回内容 返回参数 / / / 参见 7.6 arearCount int / 是 该车辆当前欠费次数 arrearFee int / 是 该车辆当前欠费金额(单位：分) star int / 是 车辆星级 bind int / 是 是否平台注册绑定车辆(1-是 0-否) 8.4 其他接口8.4.1 数据校对见表 17。 表17 数据校对表概述：每日凌晨 2 点至 4 点申请一次前一日数据校对 请求链接：由大数据平台按实际情况提供 http/https 请求地址网络协议：http/https，POST 方式 请求类型：content-type=multipart/form-data 适用范围：所有机动车停车场（库） 请求地址：http:/ip:port/internet/other/dataCheck 业务参数 数据类型 长度限定 是否应填 说明 parklotCode string 32 是 联网接入申请通过后登录服务平台可获取， 见 4.5 checkDate string 8 是 申请校对某日的数据(yyyyMMdd) inRecordCount int / 是 入场数据总数 outRecordCount int / 是 出场数据总数 payRecordCount int / 是 缴费数据总数 arrearRecordCount int / 是 欠费数据总数 picCount int / 是 上传图片总数 返回内容 返回参数 / / / 参见 7.6 inResult int / 是 入场数据总数是否正确(1-正确 2-错误) outResult int / 是 出场数据总数是否正确(1-正确 2-错误) payResult int / 是 缴费数据总数是否正确(1-正确 2-错误) arrearResult int / 是 欠费数据总数是否正确（1-正确 2-错误) (非道路停车泊位默认为 1) picResult int / 是 图片总数是否正确(1-正确 2-错误) 8.4.3 系统校时见表 19。 表19 系统校时表 8.4.2 业务编码下载见表 18。 表18 业务编码下载表请求地址：http:/ip:port/internet/other/businessCodeDown 概述：数据校对后，若有某项数据有出入，需请求下载数据主键进行核对请求链接：由大数据平台按实际情况提供 http/https 请求地址 网络协议：http/http