DB5301/T 96-2023 智慧电梯 数据规范

ICS91.140.90

CCSQ78

5301

昆明市地方标准

DB5301/T96—2023

智慧电梯数据规范

2023-10-01发布2023-11-01实施

昆明市市场监督管理局发布

DB5301/T96—2023

目次

前言.................................................................................Ⅱ

1范围...............................................................................1

2规范性引用文件.....................................................................1

3术语和定义.........................................................................1

4数据类型及格式.....................................................................1

5数据集要求.........................................................................2

6数据接口要求.......................................................................2

接口类别.......................................................................2

接口协议类型...................................................................2

接口交换格式...................................................................2

接口返回参数...................................................................2

接口输入参数...................................................................2

数据接口（API）应用示例........................................................3

附录A（规范性）电梯数据集...........................................................4

A.1电梯基础信息...................................................................4

A.2电梯施工信息...................................................................7

A.3垂直电梯运行状态信息...........................................................8

A.4垂直电梯故障状态信息...........................................................8

A.5自动扶梯运行状态信息...........................................................9

A.6自动扶梯故障状态信息...........................................................9

A.7自动人行道运行状态信息........................................................10

A.8自动人行道故障状态信息........................................................10

附录B（规范性）数据项值域代码表....................................................12

B.1电梯品种信息值域代码表........................................................12

B.2垂直电梯状态信息值域代码表....................................................13

B.3自动扶梯与自动人行道状态信息值域代码表........................................14

附录C（资料性）数据接口（API）应用示例.............................................15

参考文献.............................................................................16

I

DB5301/T96—2023

前言

本文件按照GB/T1.1—2020《标准化工作导则第1部分：标准化文件的结构和起草规则》的规定

起草。

请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别专利的责任。

本文件由昆明市市场监督管理局提出并归口。

本文件起草单位：昆明电梯行业协会、云南金质信息技术服务有限公司、云南省特种设备安全检测

研究院、云南省智能与数字经济协会、日立（中国）电梯有限公司云南分公司、通力（电梯）有限公司

昆明分公司、云南嘉乐达电梯工程有限公司、杭州岁丰信息技术有限公司、昆明昆奥电梯有限公司、云

南广网天茂科技有限公司、昆明达克电梯有限公司。

本文件主要起草人：刀瑜、朱波、郭文光、魏明、谭春红、蒋兰东、方建明、董科、朱金水、史建

康、李坤、万峰、王家忠、张华、艾斌、冯文波、孙宴鹏。

Ⅱ

DB5301/T96—2023

智慧电梯数据规范

1范围

本文件规定了电梯数据的数据类型及格式、数据集、数据接口的要求。

本文件适用于电梯监督管理系统与企业电梯运维管理系统之间的信息资源共享交换。

2规范性引用文件

下列文件中的内容通过文中的规范性引用而构成本文件必不可少的条款。其中，注日期的引用文件，

仅该日期对应的版本适用于本文件；不注日期的引用文件，其最新版本（包括所有的修改单）适用于本

文件。

GB/T7024-2008电梯、自动扶梯、自动人行道术语

GB/T7588.1-2020电梯制造与安装安全规范第1部分：乘客电梯和载货电梯

GB16899-2011自动扶梯和自动人行道的制造与安装安全规范

GB/T24476-2017电梯、自动扶梯和自动人行道物联网的技术规范

GB/T24479-2009火灾情况下的电梯特性

TSG08-2017特种设备使用管理规则

DB53/T64云南省县级以下行政区划代码

《质检总局关于修订<特种设备目录>的公告》（2014年第114号）

3术语和定义

GB16899-2011、GB/T7024-2008和GB/T24476-2017界定的术语和定义适用于本文件。

4数据类型及格式

电梯数据的数据类型及格式应符合表1的要求。

表1数据类型及格式

数据类型类型代码取值方式

字符型C通过单个或多个中文文字、字母、数字和特殊字符等组合表达的值的类型

数值型N通过从“0”到“9”数字形式表达的值的类型（非业务要求不使用0开头）

布尔型Btrue为真，false为假

日期型YYYY-MM-DD或YYYY-MM通过YYYY-MM-DD或YYYY-MM的形式表达的值的类型UTC/GMT+8.00(东八区)

时间型hh:mm:ss通过hh:mm:ss的形式表达的值的类型UTC/GMT+8.00(东八区)

日期时间型YYYY-MM-DDhh:mm:ss通过YYYY-MM-DDhh:mm:ss的形式表达的值的类型UTC/GMT+8.00(东八区)

1

DB5301/T96—2023

表1数据类型及格式（续）

数据类型类型代码取值方式

二进制流BY图象、音频、WC、RM、AVI、MPEG等二进制流文件（文件最大限制为≤40M）

示例1：数据类型后加一位数字表示定长格式。如：C6表示该指标是一个6位定长的字符，N6表示6位定长的数值型

数据。

示例2：数据类型后加“x..y”表示从最小到最大长度的格式。如：C1..10表示该指标是一个最短1位、最长10位的

字符型格式;N..6表示该指标是一个最长6位的数值型数据。

示例3：数据类型后加“..ul”表示字符的长度不确定。如：C..ul表示该指标是一个长度不确定的字符。

示例4：数值型(N）后加“x,y”表示小数位。如：N..17,2是一个最长17位、小数点后两位的一个数值。

示例5：二进制流（BY)后加具体的媒体格式（包括但不限于）。比如：BY-JPEG表示该指标是一个“JPEG”格式的文件。

5数据集要求

电梯数据的数据集包括电梯基本信息、电梯施工信息、电梯运行状态信息和故障信息。

所列数据集的数据格式应符附录A要求。

6数据接口要求

接口类别

通过统一Restful接口提供服务。

接口协议类型

数据接口协议统一采用HTTPS/HTTP协议,接口请求方式统一采用POST/GET，采用同步方式进行。

接口交换格式

接口交换格式的请求数据以及响应数据采用JSON格式，字符编码采用UTF-8。

接口返回参数

接口返回参数见表2。

表2接口返回参数

返回参数名称数据说明类型范围参数说明

code是Int接口调用返回码200：请求响应成功

message否String成功提示或者错误提示信息

data否String业务响应数据

接口输入参数

6.5.1电梯基础信息交换接口的输入参数，应符合附录A中表A.1对数据的要求。

6.5.2电梯施工信息交换接口的输入参数，应符合附录A中表A.2对数据的要求。

6.5.3电梯运行状态信息交换接口的输入参数，应符合附录A中表A.3、A.5、A.7对数据的要求。

6.5.4电梯故障信息交换接口的输入参数，应符合附录A中表A.4、A.6、A.8对数据的要求。

2

DB5301/T96—2023

数据接口（API）应用示例

数据接口（API）应用示例见附录C中的表C.1。

3

DB5301/T96—2023

附录A

（规范性）

电梯数据集

A.1电梯基础信息

电梯基础信息的数据项及其数据类型、数据格式、值域、计量单位应符合表A.1的要求。

表A.1电梯基础信息

序号数据项名称类型及格式数据说明值域计量单位备注

1设备代码C..20必填电梯设备的代码（电梯设备唯一标识代码）按TSG08-2017特种设备使用管理

规则编码

2使用登记证编号C..20必填电梯注册登记时由管理部门给出的设备使用登记编号

3电梯品种C..30必填电梯按照其基本属性对应的分类所列代码进行编码，故障类型，使用附录B中

B.1给出的代码

4设备型号C..50必填由电梯制造单位定义的产品型号

5出厂编号C..50必填电梯产品合格证上标示的电梯编号

6电梯内部编号C..30选填由电梯使用单位赋予电梯的编号，如：1号梯、3号楼2梯...

7电梯使用场所N..20选填电梯适用场所的类别(1：公共聚集场所、2：交通枢纽、3：商业区、4：住宅

区、5：厂区、6：酒店、99：其他)

8电梯使用所在行政区划C..50必填电梯所在区域（地市/区县-乡镇/办事处-社区），行政区划编码应符合DB53/T

64的要求

9电梯使用所在地址C..200必填电梯实际使用地址（某市某路某号某栋楼某单元）

10电梯所在位置经度N..20,15选填设备所在地的绝对经度位置（应符合GCJ-02坐标系规范要求）

11电梯所在位置纬度N..20,15选填设备所在地的绝对纬度位置（应符合GCJ-02坐标系规范要求）

12电梯使用注册登记日期YYYY-MM选填电梯使用首次注册登记的日期

4

DB5301/T96—2023

表A.1（续）

序号数据项名称类型及格式数据说明值域计量单位备注

电梯安装单位C..50必填电梯安装单位的名称

电梯安

13电梯安装统一社会信用代码C..18选填电梯安装单位的统一社会信用代码

装信息

电梯出厂日期YYYY-MM必填电梯产品合格证上标示的日期

电梯改造单位C..50选填电梯改造单位的名称

电梯改

14电梯改造单位统一社会信用代码C..18选填电梯改造单位的统一社会信用代码

造信息