DB4401∕T 133—2021 公共停车场管理系统数据联网技术规范(广州市).pdf

ICS 35.020CCS L 70DB4401广州市地方标准DB4401/T 1332021公共停车场管理系统数据联网技术规范Technical specification of the public parking management systemdata networking2021-12 -15 发布2021-12-31 实施广州市市场监督管理局发 布DB4401/T 1332021I目次前言. 1 范围.12 规范性引用文件.13 术语和定义.14 技术要求.14.1 数据内容.14.2 协议框架.24.3 身份认证.25 停车场状态信息数据采集.25.1 停车场状态信息上传.35.2 停车场状态信息上传的应答.66 停车位状态信息数据采集.66.1 停车位状态信息上传.66.2 停车位状态信息上传的应答.67 车辆入场信息数据采集.77.1 车辆入场记录上传.77.2 车辆入场记录上传的应答.78 车辆出场信息数据采集.88.1 车辆出场记录上传.88.2 车辆入场记录上传的应答.99 停车场空位信息数据采集.99.1 停车场空位信息记录上传.99.2 停车场空位信息上传的应答.1010 道路泊位信息数据采集.1010.1 道路泊位路段状态信息上传.1010.2 道路泊位车辆出入场记录上传.1210.3 道路泊位实时状态记录上传.1311 用户登录.1411.1 登录.1411.2 登录的应答.1412 停车位预约共享服务.1512.1 登录.1512.2 服务预授权.15DB4401/T 1332021II12.3 订单数据上传.1613 系统要求.1713.1 功能模块配置要求.1713.2 网络传输要求.17DB4401/T 1332021III前言本文件按照 GB/T 1.12020标准化工作导则 第 1 部分：标准化文件的结构和起草规则的规定起草。本文件由广州市交通运输局提出并归口。本文件起草单位：广州市交通运输局、广州交信投科技股份有限公司、广州市停车场行业协会、广东安居宝智能控制系统有限公司、广州悦停网络科技有限公司、广州卡趴网络科技有限公司本文件主要起草人：周光武、喻伟、谢仙明、梁海鸥、叶成威、冯义升、卢小琼、黄小金、冯志东、盘小龙。DB4401/T 13320211公共停车场管理系统数据联网技术规范1范围本文件规定了公共停车场管理系统数据联网的术语和定义、技术要求、停车场状态信息数据采集、停车位状态信息数据采集、车辆出入场信息数据采集、车辆出场信息数据采集、停车场空位信息数据采集、道路泊位信息数据采集、用户登录、停车位预约共享服务和系统要求相关的数据传输规范。本文件适用于广州市行政区域内公共停车场管理系统和广州停车场行业管理系统的数据联网， 其它停车场管理系统可参照使用。2规范性引用文件下列文件中的内容通过文中的规范性引用而构成本文件必不可少的条款。 其中， 注日期的引用文件，仅该日期对应的版本适用于本文件。不注日期的引用文件，其最新版本（包括所有的修改单）适用于本文件。GB 180302005 信息技术 中文编码字符集3术语和定义下列术语和定义适用于本文件。3.1公共停车场public parking在城市道路外， 为社会公众提供停车服务的场所， 包括独立建设的公共停车场和建设工程配建的作为公共服务设施的公共停车场。3.2公共停车场管理系统public parking management system对停车场中的进出口车道、 内部停车位进行管理以及按照标准收费的计算机管理系统， 包括但不限于提供预约停车服务的管理系统。3.3广州停车场行业管理系统Guangzhou parking industry management system广州市级停车行业信息管理系统， 建立了停车场基础数据库， 主要功能包括为经营性停车场提供备案业务、采集停车场停车数据、实时公布经营性停车泊位信息等。3.4城市道路临时泊位temporary parking spaces on city roads利用政府管理的城市道路设置供机动车临时停放场所的道路停车泊位。4技术要求4.1数据内容DB4401/T 133202124.1.1公共停车场管理系统上传的数据应包含以下四种内容：a） 停车场状态信息定时上传，包括停车场收费标准数据等信息；b） 停车位状态信息定时上传，根据车场或设备供应商条件选择性传输；c） 车辆出入场信息即时上传，包括车辆识别等信息。d） 停车场空位信息定时上传，包括当前剩余空位等信息。4.1.2道路泊位管理系统上传的数据应包含以下三种内容：a） 路段状态信息定时上传，包括路段收费标准数据等信息；b） 车辆出入场信息即时上传，包括车辆识别等信息；c） 路段实时状态信息上传，包括停车位占用状态等信息。4.2协议框架4.2.1通信协议通信协议应符合下列要求：a） 通信采用HTTP协议；b） 请求方式采用结构化数据（JSON）进行传递；c） 汉字编码采用GB 180302005字符集。4.2.2格式说明4.2.2.1公共请求参数是用于标识用户和接口鉴权目的的参数，如非必要，在每个接口单独的接口文档中不再对这些参数进行说明，但每次请求均需要携带这些参数，才能正常发起请求。公共请求参数见表 1。表 1 公共请求参数名称类型描述Authorizationstring访问令牌，所有需要身份认证的接口都需要在请求头中携带本参数。4.2.2.2通用响应是指每次请求的响应结果中，都会包含的字段集合。通用响应参数见表 2。表 2通用响应参数名称类型描述resultObject返回数据successBoolean请求处理状态errorObject异常或错误4.3身份认证4.3.1公共停车场管理系统上传数据前应经过广州停车场行业管理系统的身份认证， 确认合法身份后，才能发送停车位状态信息、车辆入场信息、车辆出场信息（含停车场收费数据信息）。4.3.2身份认证过程允许用户使用平台分配的用户名和密码来申请一个令牌，用于后续的接口访问。5停车场状态信息数据采集DB4401/T 133202135.1停车场状态信息上传停车场状态信息上传请求参数见表3。表 3停车场状态信息上传请求参数名称类型描述必选ParkIDlong备案 ID（停车场管理系统中该停车场的备案 ID）是Namestring(256)名称是Addr(Address)string(256)地址（详细到门牌号）是Regionstring(12)行政区是RegionCodestring(8)行政区代码是Streetstring(128)所属街道是StreetCodestring(16)所属街道代码是Propertystring(128)停车场产权方是Munit(Management Units)string(128)停车场管理单位（全称）是Typeinteger类型（注）是Noen(Number ofentrances)integer入口数是Noex(Number of exits)integer出口数是Spaceinteger总停车位是Nosps(Number of Specialparking Spaces)integer专用停车位数量（不可向公众提供服务的停车位）是Noaps(Number ofAvailable parkingSpaces)integer可用停车位数量（可向公众提供服务的停车位）是CSpace(Charging Space)integer新能源专用停车位数量是FCPile(Fast ChargingPile)integer充电桩数量（快充）是SCPile(Slow ChargingPile)integer充电桩数量（慢充）是Cstat(Charging Status)boolean当前是否可充电是DB4401/T 13320214表 3停车场状态信息上传请求参数（续）名称类型描述必选DSpace(Disabled parkingspaces)integer残疾人停车位数是MecPi(Mechanicalparking)Collection ofMecParking（见表 4 停车场机械车库结构信息）机械停车位信息否Coordsys(CoordinatesSystem)string(8)坐标系可选 WGS84、GCJ02、BD09，后续可扩展。建议使用GCJ02（高德）。是PortalsCollection ofPortalInfo（见表 5 停车场出入口结构信息）出入口位置（至少应包含一个入口位置）是Rstat(ReservationStatus)boolean当前是否可预约是RSpace(Reservation Space)integer可预约（共享）停车位数是OpeningHoursstring(256)营业时间是ROpeningHoursstring(256)预约（共享）开放时间是ChargingPeriodsCollection ofChargingPeriod（见表 6 停车场收费时段结构信息）收费时段和规则是ExtraPropertiesJSON扩展属性（使用结构化的 json 对象来拓展更多上传信息）否注：6 位数字，从左到右第 1 位数字为停车场服务对象类型：1 公共停车场、2 专用停车场；第 2 位数字为建筑性质类型：1 独立建设停车场、2 配建停车场、3 临时停车场；第 3 位数字为空间类型：1 地面、2 地下、3 两者均有；第 4 位数字为泊位类型：1 自走式、2 机械式、3 两者均有；第 5、6 位为服务功能：01 住宅、02 行政办公、03 工业、04 商业、05 商住混合、06 学校、07 医院、08 体育场、09 会议中心、10 各类场馆、11 公园景区、12 交通枢纽。（如：122105 表示 公共-配建-地下-自走式-商住混合 类型停车场）该字段后续可扩展。DB4401/T 13320215表 4停车场机械车库结构信息名称类型描述必选Mplnum(Mechanical parkinglot No.)string(128)机械车库编号是Mplname(Mechanical parkinglot Name)string(32)机械车库名称是Manufacturerstring(32)制造商是Spaceinteger总停车位是typestring(16)机械车库类型（升降横移、垂直升降等）是表 5停车场出入口结构信息名称类型描述必选addrstring(256)出入口地址（或名称）是coordinatesCollection ofdouble经纬度是typestring(12)类型（入口、出口、出入口）是streetstring(64)连接道路名称是表 6停车场收费时段结构信息名称类型描述必选Startinteger开始时间，距 0 点的分钟整数形式，如凌晨 2 点设置为 120是Endinteger截止时间，同上是RulesCollection ofChargingRule（见表 7）收费规则是表 7停车场收费规则结构信息名称类型描述必选DurStartinteger开始停车时长（分钟）是DurEndinteger截止停车时长（分钟），-1 为无限大是Pricedecimal number单位价格（元/计费跨度）是Spaninteger计费跨度（分钟），0 为每次是DB4401/T 133202165.2停车场状态信息上传的应答使用通用响应，返回停车场主键ID。6停车位状态信息数据采集6.1停车位状态信息上传停车位状态信息上传请求参数见表8。表 8停车位状态信息上传请求参数名称类型描述必选ParkIDlong停车场 ID（停车场管理系统备案 ID）是SpacesCollection ofSpaceInfo（见表 9）详细停车位信息是表 9停车位信息结构信息名称类型描述必选SpaceIDstring(128)停车位编号（停车位所在的分区分层信息需要在该字段体现）是Topr(Types of propertyrights)string(8)产权类型（个人、单位、其他）是Cableboolean是否是充电停车位是Rableboolean是否是可预约（共享）停车位是Ostatinteger占用状态0 未占用 1 占用该字段后续可扩展是Cstatinteger充电状态0 未充电 1 充电中该字段后续可扩展否Cpn(Charging pilenumber)string(64)充电桩编号否Rstatinteger预约（共享）状态0 未预约 1 已预约该字段后续可扩展否Lpnstring(32)停泊车牌号码否6.2停车位状态信息上传的应答DB4401/T 13320217使用通用响应。7车辆入场信息数据采集7.1车辆入场记录上传车辆入场记录上传请求参数见表10。表 10车辆入场记录上传请求参数名称类型描述必选ParkIDlong备案 ID（停车场管理系统中该停车场的备案 ID）是DataProviderIdstring(64)停车场主键 ID是Norps(Number of remainingparking spaces)integer剩余停车位是Noops(Number of occupiedparking spaces)integer已占用停车位是Nopsrafc(Number of parking spacesremaining available forcharging)integer剩余的可供充电停车位数量是Noopsafc(Number of occupiedparking spaces availablefor charging)integer已占用的可供充电停车位数量是Nopsrfr(Number of parking spacesremaining forreservations)integer剩余可供预约（共享）的停车位数量是Noopsfr(Number of occupiedparking spaces forreservations)integer已占用的可供预约（共享）的停车位数量是EntryTimeDate(string)入场时间是Lpn(License plate number)string(32)车牌号码(如系统记录了车牌的颜色信息， 需一并上传， 如：粤 A88888（蓝）)是EntryWaystring(16)入场方式（自动识别、取卡、人工等）否7.2车辆入场记录上传的应答DB4401/T 13320218使用通用响应。8车辆出场信息数据采集8.1车辆出场记录上传车辆出场记录上传请求参数见表11。表 11车辆出场记录上传请求参数名称类型描述必选ParkIDlong备案 ID（停车场管理系统中该停车场的备案 ID）是DataProviderIdstring(64)停车场主键 ID是SpaceIDstring(128)停泊的停车位编号否Norps(Number ofremaining parkingspaces)integer剩余停车位是Noops(Number of occupiedparking spaces)integer已占用停车位是Nopsrafc(Number of parkingspaces remainingavailable forcharging)integer剩余的可供充电停车位数量是Noopsafc(Number of occupiedparking spacesavailable forcharging)integer已占用的可供充电停车位数量是Nopsrfr(Number of parkingspaces remainingfor reservations)integer剩余可供预约（共享）的停车位数量是Noopsfr(Number of occupiedparking spaces forreservations)integer已占用的可供预约（共享）的停车位数量是EntryTimeDate(string)入场时间是ExitTimeDate(string)出场时间是DB4401/T 13320219表 11车辆出场记录上传请求参数（续）名称类型描述必选Durationdouble停车时长（分钟）否Lpn(License platenumber)string(32)车牌号码如系统记录了车牌的颜色信息，需一并上传，如：粤 A88888（蓝）是PayMethodstring(32)支付方式（现金、银行卡、羊城通、微信、支付宝、ETC、自发卡等）否ChargesTypestring(32)该次收费的执行方式（VIP、月保、临保等）是TotalCostdouble总费用（元）否8.2车辆入场记录上传的应答使用通用响应。9停车场空位信息数据采集9.1停车场空位信息记录上传停车场空位记录上传请求参数见表12。表 12停车场空位信息上传请求参数名称类型描述必选ParkIDlong备案 ID（停车场管理系统中该停车场的备案 ID）是DataProviderIdstring(64)停车场主键 ID是Norps(Number ofremaining parkingspaces)integer剩余停车位是Noops(Number of occupiedparking spaces)integer已占用停车位是Nopsrafc(Number of parkingspaces remainingavailable forcharging)integer剩余的可供充电停车位数量是DB4401/T 133202110表 12停车场空位信息上传请求参数（续）名称类型描述必选Noopsafc(Number of occupiedparking spacesavailable forcharging)integer已占用的可供充电停车位数量是Nopsrfr(Number of parkingspaces remainingfor reservations)integer剩余可供预约（共享）的停车位数量是Noopsfr(Number of occupiedparking spaces forreservations)integer已占用的可供预约（共享）的停车位数量是定时上传，要求每 30（可配置）分钟上传 1 次。9.2停车场空位信息上传的应答使用通用响应。10道路泊位信息数据采集10.1道路泊位路段状态信息上传10.1.1请求道路泊位路段状态信息上传请求参数见表13。表 13道路泊位路段状态信息上传请求参数名称类型描述必选ParkingRegisterRecordIdlong备案 ID（停车场管理系统中该路段的备案 ID）是ParkingCodestring(64)停车场（路段）编码是ParkingNamestring(128)停车场（路段）名称是ParkingAddressstring(256)地址是RoadStartstring(128)路段起始位置是RoadEndstring(128)路段终止位置是AreaNamestring(64)行政区是AreaCodestring(8)行政区代码是DB4401/T 133202111表 13道路泊位路段状态信息上传请求参数（续）名称类型描述必选Descriptionstring(512)备注说明否CompanyNamestring(128)停车场管理单位（全称）是CompanyAddressstring(256)注册地址否UnitCodestring(64)统一社会信用代码否LegalPersonstring(16)法定代表人否LegalTelephonestring(32)法定代表人联系电话否ContactPersonstring(16)联系人否ContactTelephonestring(32)联系人电话否Typeinteger类型（注）是Occupystring(16)单侧或双侧占用否OccupyLengthdouble占用长度否OccupyWidthdouble占用宽度否OccupyAreadouble占用面积否ParkingSpaceinteger总停车位是ParallelSpaceinteger平行式泊位否VerticalSpaceinteger垂直式泊位否TileSpaceinteger倾斜式泊位否ServiceTelephonestring(128)服务监督电话否JeevesNumberstring(32)占道证号否RoadNumberstring(32)道路编号否InitialOperationTimestring(64)初次营业日期否Noaps(Number of Availableparking Spaces)integer可用停车位数量（可向公众提供服务的停车位）是PowerChargingSpaceinteger新能源专用停车位数量是FCPile(Fast Charging Pile)integer充电桩数量（快充）否SCPile(Slow Charging Pile)integer充电桩数量（慢充）否Cstat(Charging Status)boolean当前是否可充电否DSpace(Disabled parking spaces)integer残疾人停车位数否DB4401/T 133202112表 13道路泊位路段状态信息上传请求参数（续）名称类型描述必选Coordsys(Coordinates System)string(8)坐标系可选 WGS84、GCJ02、BD09，后续可扩展。建议使用 GCJ02（高德）。否Longitudedouble经度是Latitudedouble纬度是Rstat(Reservation Status)boolean当前是否可预约否RSpace(Reservation Space)integer可预约（共享）停车位数否PaymentOptioninteger支付方式（0 全部 1 电子 2 现金）是ChargeModestring(32)收费模式（咪表、人工、线上支付或网点缴费）是ChargeTypestring(512)收费标准是AreaTypestring(16)地区分类（重点区域、非重点区域）是BusinessHourStartstring(128)开始营业时间是BusinessHourEndstring(128)结束营业时间是ROpeningHoursstring(128)预约（共享）开放时间否注：1 全天准停泊位2 专用泊位（21 残疾人机动轮椅车专用泊位、22 巡游出租车临停泊位、23 警车专用泊位）3 限时停放路段（31 夜间准停路段、32 短时准停区域路段、33 临停快走区域路段、34 限时临停区域路段）10.1.2道路泊位路段状态信息上传的应答使用通用响应。10.2道路泊位车辆出入场记录上传10.2.1请求道路泊位车辆出入场记录上传请求参数见表14。DB4401/T 133202113表 14道路泊位车辆出入场记录上传请求参数名称类型描述必选ParkingRegisterRecordIdlong备案 ID（停车场管理系统中该路段的备案 ID）是DataProviderRecordIdstring(64)停车场（路段）主键 ID是ParkingCodestring(32)停车场（路段）编码否ParkingAddressstring(256)停车场地址否EntryTimeDate(string)入场时间是ExitTimeDate(string)出场时间是Durationdouble停车时长（分钟）否PlateNumberstring(32)车牌号码是PlateColorstring(32)车牌颜色否Statusinteger0 离场 1 在场 2 出场未识别 -1 测试是PayMethodstring(32)支付方式（现金、银行卡、羊城通、微信、支付宝、ETC、自发卡等）否ChargesTypestring(32)该次收费的执行方式（VIP、月保、临保等）否TotalCostdouble总费用（元）是10.2.2道路泊位车辆出入场记录上传的应答使用通用响应。10.3道路泊位实时状态记录上传10.3.1请求道路泊位实时状态记录上传请求参数见表15。表 15道路泊位实时状态记录上传请求参数名称类型描述必选ParkingRegisterRecordIdlong备案 ID（停车场管理系统中该停车场的备案 ID）是DataProviderRecordIdstring(64)停车场（路段）主键 ID是ParkingCodestring(16)停车场（路段）编码否ParkingAddressstring(256)停车场地址否FreeSpaceinteger剩余停车位是TakenSpaceinteger已占用停车位是DB4401/T 133202114表 15道路泊位实时状态记录上传请求参数（续）名称类型描述必选Nopsrafc(Number of parking spacesremaining available forcharging)integer剩余的可供充电停车位数量否Noopsafc(Number of occupiedparking spaces availablefor charging)integer已占用的可供充电停车位数量否Nopsrfr(Number of parking spacesremaining forreservations)integer剩余可供预约（共享）的停车位数量否Noopsfr(Number of occupiedparking spaces forreservations)integer已占用的可供预约（共享）的停车位数量否10.3.2道路泊位实时状态记录上传的应答使用通用响应。11用户登录11.1登录登录请求参数见表16。表 16登录请求参数名称类型描述必选userNameOrEmailAddressstring(32)账户是passWordstring(32)密码是11.2登录的应答登录的应答响应参数见表17。DB4401/T 133202115表 17登录响应参数名称类型描述必选accessTokenstring访问令牌，用于后续接口的合法访问。是expireInSecondsInteger有效时长（秒）是userIdInteger用户 ID12停车位预约共享服务12.1登录12.1.1运营商应提供有效的appId和appSecret；12.1.2平台方通过appId和appSecret可通过登录接口获取到访问凭证accessToken ， 后续的预授权接口需在请求参数携带上accessToken参数；12.1.3accessToken应具有有效期限，接口返回数据中应包含有效期信息。12.1.4停车位预约共享服务登录请求参数见表18。表 18登录请求参数名称类型描述必选appIdstring(64)应用 ID是appSecretstring(64)应用密钥是12.1.5停车位预约共享服务登录响应参数见表19。表 19登录响应参数名称类型描述必选accessTokenstring访问凭证是expireInSecondsInt有效期时长（秒）是12.2服务预授权12.2.1平台方通过11.1节接口获取的accessToken参数，以及serviceCode（服务代码）等参数通过该接口获取到访问凭证preAuthCode，后续的停车位预约共享服务请求的接口需在请求参数携带上preAuthCode参数；12.2.2preAuthCode应具有有效期限，接口返回数据中应包含有效期信息。12.2.3服务预授权请求参数见表20。表 20预授权请求参数名称类型描述必选accessTokenstring(512)访问凭证是DB4401/T 133202116表 20预授权请求参数（续）名称类型描述必选serviceCodestring(32)服务代码001：车场信息查询002：订单信息查询101：共享停车位预约、租用（跳转至下单页）301：缴费入口（包括订单缴费和临停缴费等）是platformstring(32)应用平台WX_MINI：微信小程序H5：H5 页面WX_JSAPI：公众号ALIPAY_FUWU：支付宝生活号是datajson数据（参考表 20）否12.2.4服务预授权附加参数见表 21。表 21预授权附加参数名称类型描述必选parkIdstring(32)停车场编码（当不传递该参数时，应跳转或加载运营商所有车场）否phonestring(16)用户手机号码是platestring(32)车牌号码多个号码用英文逗号分隔否cardNostring(16)自发卡编号否orderNostring(128)订单编号否12.2.5服务预授权响应参数见表22。表 22预授权响应参数名称类型描述必选preAuthCodestring预授权码是urlsstring当应用平台需跳转 url 时，应返回此参数否expireInSecondsInt有效期时长（秒）是12.3订单数据上传12.3.1请求DB4401/T 133202117订单数据上传参数见表23。表 23订单数据上传请求参数名称类型描述必选outOrderNostring(128)订单编号是phonestring(16)用户手机号码否opParkIDstring(64)运营方停车场 ID是parkIDlong停车场 ID（停车场管理系统备案 ID）是parkNamestring(128)停车场名称是statInt订单状态是orderTypeInt订单类型是durationInt预约时长（分钟）是platestring(32)车牌号码是oAmountDouble订单金额否addTimeDate(string)订单创建时间是closeTimeDate(string)订单关闭时间否effeTimeDate(string)预约生效时间否inTimeDate(string)停车入场时间否outTimeDate(string)停车出场时间否12.3.2订单数据上传的应答使用通用响应。13系统要求13.1功能模块配置要求功能模块配置要求包括：a） 数据采集接口应设计为724h持续稳定工作，在正常运行时无须外部干预；b） 可配置停车位状态信息的上传时间间隔；c） 可根据停车场实际设备情况，配置是否上传停车位详情；d） 可根据停车场实际设备情况，配置是否上传车辆出场实时停车费用信息，若选择不上传实时停车费用，可配置用以替代费用信息的缺省值；e） 停车场空位信息数据应定时上传，可配置上传的时间间隔，默认为30分钟；f） 可查看数据采集功能模块发送以及接收日志。13.2网络传输要求网络传输要求包括：a） 从公共停车场管理系统发出数据到通信应用服务器接收到数据的平均时延10s；DB4401/T 133202118b） 从公共停车场管理系统发出数据到通信应用服务器接收到数据， 丢失数据包占所发送数据包的比率应0.2%；c） 从公共停车场管理系统发出数据到通信应用服务器接收到数据， 所收到错误数据包占所发送数据包的比率应0.2%。