1、 ICS 35.100 CCS L 79 34 安徽省地方标准 DB 34/T 41412022 电梯应急救援平台数据接口规范 Data interface specification for elevator emergency rescue platform 2022-03-29 发布 2022-04-29 实施 安徽省市场监督管理局 发 布 DB 34/T 41412022 前言 本文件按照GB/T 1.12020标准化工作导则 第1部分:标准化文件的结构和起草规则的规定起草。请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别专利的责任。本文件由安徽省特种设备检测院提出。本文
2、件由安徽省市场监督管理局归口。本文件起草单位:安徽省特种设备检测院、科大国创云网科技有限公司。本文件主要起草人:莫诚生、赵龙、许迪、许佳伟、严伟、姚刚、王启龙、熊钰才、汪源、许路夷。I DB 34/T 41412022 电梯应急救援平台数据接口规范 1 范围 本文件规定了电梯应急救援平台的数据交换架构、接口基本规定、接口协议清单及内容。本文件适用于省电梯应急救援管理平台(以下简称“省电梯平台”)与各地市或区县电梯应急救援管理平台(以下简称“地方电梯平台”)之间的数据交换。2 规范性引用文件 本文件没有规范性引用文件。3 术语和定义 下列术语和定义适用于本文件。3.1 使用单位 elevator
3、 user 新安装未移交业主的电梯,项目建设单位是使用单位;委托物业服务单位管理的电梯,物业单位是使用单位;产权单位自行管理的电梯,产权单位是使用单位。来源:TSG 08-2017,2.1.2 3.2 网格 grid 电梯应急救援的管理模式,一般救援响应分为三级:第一级响应由电梯签约维保单位实施;第二级由电梯应急救援机构实施;第三级由119、110等公共救援机构或外部救援专家实施。3.3 电梯唯一标识 the unique identification of elevator 用于电梯应急救援定位的唯一编码。3.4 JSON JavaScript对象简谱((JavaScript Object
4、Notation),是一种轻量级的数据交换格式。3.5 JavaScript 一种具有函数优先的轻量级、解释型或即时编译型的网页编程语言。3.6 HTTP 超文本传输协议(Hyper Text Transfer Protocol),是一种请求-响应协议。4 数据交换架构 1 DB 34/T 41412022 省电梯平台负责统一开发数据接口并进行维护更新,各地方电梯平台按照数据接口规范要求实现数据下载和上传,以完成平台间数据的互联互通。数据交换架构如图1所示:图1 数据交换架构图 5 接口基本规定 接口协议类型 5.1 数据接口协议统一采用HTTP协议,接口请求方式为POST请求,采用同步方式进
5、行。接口交换格式 5.2 接口交换格式采用JSON传输数据,具备通用性和可扩展性。接口协议内容 5.3 关于接口规范的数据清单应符合附录A的规定。2 DB 34/T 41412022 附录A (规范性)电梯应急救援平台数据接口规范 A.1 省电梯平台对外提供服务的数据接口 A.1.1 数据字典接口服务 A.1.1.1 接口方法及说明 接口标识符:Dict。接口说明:用于获取省电梯平台内的数据字典信息。A.1.1.2 接口输入参数及说明 省电梯平台提供的数据字典接口的输入参数及说明见表A.1。表A.1 省电梯平台数据字典接口输入参数及说明 输入参数名 类型 非空 参数描述 type String
6、 是 字典类型,传入不同的 type 值获取不同的数据字典。电梯类别:EQU_TYPE;电梯品种:EQU_KIND;救援类型:MT_TYPE;故障类型:FALT_TYPE;AREA_CODE:区域字典。Page Int 否 页数(默认为 1)Rows Int 否 每页显示数(默认为 10)A.1.1.3 接口返回参数及说明 省电梯平台提供的数据字典接口的返回参数及说明见表A.2。表A.2 省电梯平台数据字典接口返回参数及说明 返回参数 类型 非空 字段描述 Data Label String 是 数据字段编码 Value String 是 数据值 Type String 是 字段类型 Desc
7、ription String 是 数据字段描述 ParentValue String 否 父级字段数据值 A.1.2 电梯设备信息接口 A.1.2.1 接口方法及说明 接口标识符:DtList。接口说明:本接口用于获取电梯基础信息数据。A.1.2.2 接口输入参数及说明 电梯基础信息接口的输入参数及说明见表A.3。3 DB 34/T 41412022 表A.3 电梯基础信息接口输入参数及说明 参数名 类型 非空 参数描述 EquDataSysID String 否 设备系统内 ID EquCardNo String 否 电梯唯一标识 EquCode String 否 设备代码 equregco
8、de String 否 设备注册代码 ProNo String 否 产品编号(出厂编号)UseCarNo String 否 使用证编号 equlocarecode String 否 设备所在地区(县)字段编码 MtorgName String 否 维保单位名称 UseOrgName String 否 使用单位名称 porgaoname String 否 制造单位名称 buiorgname String 否 安装单位名称 Page Int 否 页数(默认为 1)Rows Int 否 每页显示数(默认为 10)A.1.2.3 接口返回参数及说明 电梯基础信息返回参数及说明见表A.4。表A.4 电梯
9、基础信息接口返回参数及说明 返回参数 字段类型 非空 字段描述 Data EquDataSysID String 是 设备系统内 ID EquCardNo String 否 电梯唯一标识编号 EquCode String 是 设备代码 EquRegCode String 是 设备注册代码 EquClaCode String 是 设备种类编码 EquKindCode String 是 设备类别编码 EquVart String 是 设备品种编码 EquipName String 是 设备名称 EquipModel String 是 设备型号 ProNo String 是 产品编号(出厂编号)Us
10、eCarNo String 是 使用证编号 IssuecerDate String 是 最新发证日期(yyyy-MM-dd)RegOrgCode String 是 注册登记机构名称 4 DB 34/T 41412022 表 A.4 电梯基础信息接口返回参数及说明(续)返回参数 字段类型 非空 字段描述 Data RegNo String 是 登记表编号 EquLogCode String 是 设备注册字段编码 LoginState String 是 注册状态 UseStatus String 是 使用状态 IsInsurance String 否 是否购置保险 EquLocareCode St
11、ring 是 设备所在地区(县)字段编码 EquLocareName String 是 设备所在地区(县)名称 EquLocareInfo String 是 设备详细地址 EquOrgNo String 是 设备单位内部编号 MtorgName String 是 维保单位名称 MtOrgLinman String 是 维保单位联系人 MtOrgLintel String 是 维保单位联系电话 MtPrgAdd String 是 维保单位地址 MtDeadLine String 是 维保合同截止时间(yyyy-MM-dd)UseOrgName String 是 使用单位名称 UseOrgAdd
12、String 是 使用单位地址 EconoTypeCode String 是 单位经济类型 UseOrgLinman String 是 使用单位联系人 UseOrgLintel String 是 使用单位联系电话 EquUseDate String 是 设备投用日期(yyyy-MM-dd)porgaoname String 是 制造单位名称 BuiOrgName String 是 安装单位名称 EqubuiapDate String 是 设备安装日期(yyyy-MM-dd)lastInspectorgname String 是 最新检验机构名称 lastInspecttype String 是
13、 最近检验类型 LastInspecttime String 是 最近检验日期(yyyy-MM-dd)LastInspectresult String 是 最近检验结论 LocationInfo String 是 坐标系及地理信息描述等,其形式以逗号作为分隔符,如“WGS84”,坐标系有:WGS84、CGCS2000、西安 80、北京 54、其他 Longitude String 是 所在经度 Latitude String 是 所在维度 MainStrForm String 否 主体结构形式 ManageMode String 否 管理方式 EleMoveSpeed Float 否 电梯运行
14、速度 Eleratingload Float 否 电梯额定载荷 5 DB 34/T 41412022 表A.4 电梯基础信息接口返回参数及说明(续)返回参数 字段类型 非空 字段描述 Data Elefloor String 否 电梯层站 Eleheight Float 否 电梯提升高度(m)Tracangtype String 否 曳引机型号 Tracangleafacnumber String 否 曳引机出厂编号 ElectType String 否 电动机型号 ElectLeafacNumber String 否 电动机出厂编号 ElectRoPower Float 否 电动机功率(MW
15、)ConscrType String 否 控制屏型号 ContscrCode String 否 控制屏出厂编号 RestSpeedType String 否 限速器型号 RestSpleafacNumber String 否 限速器出厂编号 Ladincangle Float 否 扶梯倾斜角()Rundlebreadth Float 否 梯级宽度(m)ElewalkDistance Float 否 电梯走行距离(m)EleStadeNumber Int 否 电梯站数 EleFloorNumber Int 否 电梯层数 EleDoorNumber Int 否 电梯门数 RatedSpeed Fl
16、oat 否 额定速度 BlastProofFormLevel String 否 防爆等级 BlastProofForm String 否 防爆形式 SeneRunMode String 否 节能运行方式 ContrMode String 否 控制方式 StartMode String 否 启动方式 Passennumb Int 否 乘客人数 RoomLength Float 否 机房长(m)RoomHeight Float 否 机房高(m)RoomWidth Float 否 机房宽(m)roomform String 否 机房形式 BinLength Float 否 轿箱长(m)BinHeight Float 否 轿箱高(m)BinWidth Float 否 轿箱宽(m)DoorPattern String 否 门型式 Balaquot String 否 平衡系数 DragMode String 否 拖动方式 PullPower Float 否 拖动功率(MW)FireControlForm String 否 消防形式 Ropewrapmode String 否 曳引绳绕绳方式 6 D