全国诚招合伙人

咨询热线:0371—61312101

智慧用电-智慧消防-智慧电力物联网全系列产品 携手力安 共创财富

智慧消防智能管控平台对接指南-浙江省火灾智能防控系统标准

智慧消防智能管控平台

对接指南

 

                              V1.3.0

 

 

 

 

浙江省消防总队

2019.4.8

 

 

 

 

目录

1.概述... 3

1.1编写目的... 3

1.2文档简述... 3

1.3规范性引用文件... 3

1.4术语和定义... 4

1.4.1消防远程监控系统... 4

1.4.2智慧用电系统... 4

1.4.3智慧用水系统... 5

1.4.4智能预警系统... 5

1.4.5智能充电桩系统... 6

1.4.6单位自主管理系统... 7

1.4.7其它名词... 7

1.5 缩略语... 7

2. 接口交换项简要说明... 7

2.1 全局说明... 7

2.1.1 一般要求... 7

2.1.2 对接流程图示... 8

2.1社会单位基本信息... 8

2.2运营服务公司... 9

2.3设备信息... 9

2.4部件信息... 9

2.5实时报警信息... 10

3. 对接格式与方法... 10

3.1对接格式... 10

3.2智慧消防智能管控平台向各平台采集数据... 11

3.3各平台向智慧消防智能管控平台报送数据... 12

4. 对接接口详细内容... 14

4.1智慧消防智能管控平台向各平台采集数据... 14

4.1.1单位(或者站点、或者建筑)信息... 14

4.1.2运营服务公司... 16

4.1.3设备信息... 18

4.1.4设备部件信息... 21

4.2 各平台向智能管控平台上报或推送信息... 23

4.2.1报警信息(实时)... 23

5. 字典表... 24

5.1社会单位类型【字典】... 24

5.2区域维表【字典】... 25

5.3平台开发公司【字典】... 25

5.4告警类型【字典】... 25

5.5设备类型【字典】... 27

5.6部件类型【字典】... 27

 

1.概述

1.1编写目的

编写本文档的目的在于确定智慧消防智能管控平台与各智慧消防服务平台的数据对接方法,以及在对接过程中双方所需遵循的规范、内容和协议等。

本文档同样可为其它智慧消防平台数据互通提供参考。

1.2文档简述

本文档包含:

 

l  第一部分规定了各类智能防控系统定义;

l  第二部分提供了平台数据互通的接口内容概述;

l  第三部分规定了对接的主要方法和格式;

l  第四部分规定了数据互通的详细内容;

l  第五部分提供了全文档涉及的字典表。

 

1.3 规范性引用文件

下列文件对于本文件的应用是必不可少的。凡是注日期的引用文件,仅注日期的版本适用于本文件。凡是不注日期的引用文件,其*新版本(包括所有的修改单)适用于本文件。

GB/T 8566-2007 信息技术软件生存周期过程

GB/T 22240-2008信息安全技术信息系统安全等级保护基本要求

GB/T 26875.3-2011城市消防远程监控系统 3部分:报警传输网络通信协议

GB/T 26875.4-2011 城市消防远程监控系统 4部分:基本数据项

GB/T 26875.8-2015 城市消防远程监控系统 8部分:监控中心对外数据交换协议

GB 50440 城市消防远程监控系统技术规范

RFC 2616 超文本传输协议(Hypertext Transfer Protocol-HTTP/1.1)

RFC 2818 超文本传输安全协议(HTTP Over TLS)

RFC 3629 ISO 10646的转换格式(UTF-8a transformation format of ISO 10646)

RFC 4627 JSON格式定义(The application/json Media Type for JavaScript Object Notation (JSON)

GB/T 2260-2007 中华人民共和国行政区划代码

GB/T10114-2003县以下行政区划代码编制规则

1.4术语和定义

1.4.1消防远程监控系统

消防远程监控系统是由监控中心、用户信息传输装置、数据通信网络和管理软件等组成的综合性应用系统,系统综合运用物联网、地理信息、数字视频监控等技术手段,实现对联网单位火灾报警、监管、故障等多种信号进行实时监测,提高火灾报警的及时性和可靠性,实现对消防设施的网络化集中管理,对重要场所和高危单位的报警处置实行定位跟踪,提高消防监督执法的针对性和有效性,并应用平台提供的消控室值班人员查岗机制,督促社会单位提高自身消防安全管理水平。

消防远程监控系统

1-1本文档中消防远程监控系统的设备和部件等简要说明和示意

1.4.2智慧用电系统

智慧用电系统,由传感器及传感终端装置、传感传输装置及系统平台组成,传感器安装在电气线路和用电设备上,实现实时发现漏电、过载等安全隐患,并即时向管理人员发送预警信息等,可以指导企业单位自主开展隐患治理,消除潜在的电气安全隐患。

智慧用电系统1.4.2

1-2本文档中智慧用电系统的设备和部件等简要说明和示意

 

1.4.3智慧用水系统

智慧用水系统由液压、液位传感器、物联网采集终端和系统平台组成。能实时获取室内外消火栓中的水压和消防水池、水箱的液位信息,并能通过网络进行数据监测和报警。

智慧用水系统

1-3本文档中智慧用水系统的设备和部件等简要说明和示意

1.4.4智能预警系统

智能预警系统由无线烟感、无线声光、无线手报、无线智能网关控制器和运营平台组成。系统具备无线烟感触发蜂鸣器报警、人员手机APP报警、应急中心报警、联动声光报警等四项预警功能,可精.确定位报警位置,实现设备电压欠压、探头、声光等故障诊断与信息报告、大数据分析等功能。

智能预警系统

1-4本文档中智能预警系统的设备和部件等简要说明和示意

1.4.5智能充电桩系统

电动自行车智能充电桩系统由智能充电桩、主机、通讯设备、服务端和移动客户端应用系统,采用了多级防过流、防短路、防漏电、防雷、防过充、限流、防雨、高温报警、充电实时监控、异常自动判断自动断电、充满自动断电等安全保护措施;提供电动车车主、充电车辆、充电电量、区域分布等大数据,实现事前预防、事中监控,事后补救的人防、技防和物防三防大融合。

智能充电桩系统

1-5本文档中智能充电桩系统的设备和部件等简要说明和示意

1.4.6单位自主管理系统

单位自主管理系统通过信息化手段为单位提供消防内部安全管理工具,实现消防安全基础档案管理、消防巡查、日常检查、单位智慧消防物联网设备报警和处置等。并可实现单位消防安全教育、单位消防安全预案管理和消防演练、消防安全群众举报、消防监督管理和消防维保监测管理等功能。

1.4.7其它名词

平台开发公司:本文中指智慧消防应用的软件平台开发公司。

运营服务公司:本文中指智慧消防应用和*终用户签署销售和服务合同,履行设备安装、售后服务的公司。运营服务公司可能和平台开发公司为同一家公司,但也存在为第三方公司或平台开发公司下属子公司。

设备(部件)生产公司:本文中指这类硬件设备的制造、生产厂家。

1.5 缩略语

下列缩略语适用于本文件。

HTTP:超文本传输协议(Hypertext Transfer Protocol)

HTTPS:超文本传输安全协议(HTTP Over TLS)

REST:表述性状态转移(Representational State Transfer)

URI:统一资源标识符(Uniform Resource Identifier)

URL:统一资源定位符(Uniform Resource Locator)

JSON:JavaScript 对象表示法( JavaScript Object Notation)

MQ:消息队列(Message Queue

2. 接口交换项简要说明

2.1 全局说明

2.1.1 一般要求

l  本文档中提供的技术对接方法使用的字符集采用RFC 3629的相关数据规定,数据统一使用(UTF-8)。

l  本文档中提供的对接方法以HTTPHTTPS协议作为底层承载协议。采用HTTP协议时,应满足RFC 2616的规定;采用HTTPS协议时,应满足RFC 2818的规定。

2.1.2 对接流程图示

对接流程

2-1对接主要步骤示意图

2.1社会单位基本信息

智慧消防智能管控平台获取各平台社会单位基本信息接口要求如下:

1) 接口名称:pt1_1

2) 协议:http/https

3) 调用参数:输入{创建开始时间,创建结束时间,更新开始时间,更新结束时间,社会单位(站点、建筑物)唯.一主键}

4) 返回:{社会单位(站点、建筑物)主键,社会单位(站点、建筑物)名称,所属运营服务公司编码(id),详细地址,纬度,经度,区域编码,设备数,所属平台厂商code}

 

说明:社会单位基本信息智慧消防设备安装所在的社会单位名称,如某某公司。如某些场景下无法提供社会单位基本信息,可提供该建筑物名称,如某某大厦、某某出租房。也可以提供场所站点名称:如某某路口、某某停车场。

运营服务公司即提供智慧消防运营服务的公司。如某某消防安全公司。运营服务公司提供智慧消防运营服务,如设备报警处理、日常维护等工作。参见文档2.2章节。

2.2运营服务公司

智慧消防智能管控平台获取各平台运营服务公司信息接口要求如下:

1) 接口名称:pt1_2

2) 接口协议:http/https

3) 接口调用参数:输入{创建开始时间,创建结束时间,更新开始时间,更新结束时间,运营服务公司唯.一主键}

4) 返回值:{运营公司ID,运营公司名称,运营公司编码,运营公司地址,联系人姓名,联系人电话}

2.3设备信息

智慧消防智能管控平台获取各平台设备信息接口要求如下

1) 接口名称:pt1_3

2) 接口协议:http/https

3) 接口调用参数:输入{创建开始时间,创建结束时间,更新开始时间,更新结束时间,设备唯.一主键}

4) 返回值:{设备id,设备名称,设备类型,地址,纬度,经度,运营服务公司,社会单位(站点或者建筑物)id,平台厂商code,安装日期,设备状态,设备生产公司或品牌,部件数量}

 

说明:远程监控平台的设备含义为用户信息传输装置。具体可参考1.4术语和定义。

2.4部件信息

智慧消防智能管控平台获取各平台部件信息接口要求如下

1) 接口名称:pt1_4

2) 接口协议:http/https

3) 接口调用参数:输入{创建开始时间,创建结束时间,更新开始时间,更新结束时间,设备部件唯.一主键}

4) 返回值:{设备部件id,设备部件名称,地址,设备部件关联的设备id,部件生产厂家或品牌,安装日期,设备部件状态,设备部件类型}

 

说明:远程监控平台的部件含义为用户信息传输装置连接的部件设备。具体可参考1.4术语和定义。

2.5实时报警信息

1) 接口名称:pt1_5

2) 接口协议:RabbitMq

3) 返回值:{报警编号id,设备id,社会单位(建筑、站点)主键,发生时间,报警信息json,报警类型(详见字典表:报警类型),设备部件id,平台厂商code}

4) 功能说明:

1)  设备发生告警时,即时向RabbitMq消息队列中推送告警信息

 

说明:1)报警信息由各平台向智慧消防智能管控平台主动推送。2)平台开发公司即各智慧消防平台的软件开发和提供公司。

3. 对接格式与方法

3.1对接格式

各接口返回数据字段都以驼峰格式命名

接口返回格式:

{

       code:0,   //Integer

       message:”code中文说明”, //String

data:返回数据 //Object

}

 

//分页列表时,data格式

data: {

pageNo: 1,    //当前页码

pageSize: 50, //每页条数

pageCount: 2, //总页数

              count:80,    //总条数

        list: [                 //数据列表

            {

 

            }

        ]

    }

 

3.2智慧消防智能管控平台向各平台采集数据

请求认证,接入数据系统提供用户名,密码及加密公钥获取认证token,智慧消防智能管控平台在之后的数据请求头中,通过携带token认证获取数据;获取公钥接口接口说明:

协议:

https

http请求方式:

Get

请求url

https://域名/ api/getPublicKey

功能说明:

获取公钥,此公钥用来加密密码,采用RSA加密算法,RSA/ECB/PKCS1Padding填充模式,密匙长度(模值)2048

 (rsa加密工具类)

返回结果示例:

{

       code:0,

       message:”获取成功”,

data:{

publicKey:”CPf+KadCgGJYRsosgsodB5Ob8eEMYzJpaRQusPEJC0mUWxm2NUsZmhxuksZuVWsCNxsOuDita922nM2y1wcUsxTHLrdIad+tlNYqqoWuUOBuGiDajG8jVu9jj4jKTpKa+hc+00pqggwYu7psRz3xiebE9HiPPUjNaiPK+aqlKSrGlXIGJOWvqJxeOxpb/oQ/x9fKQGXT04iewzNQLdQOm/foz3mOJGuvXAt3ulnjBHqBvA6p27a+7NWcfl9AorLV77rX95YZxliiOcEzWIcH0IDFI1PFEDOX/HxFJ7AYwtwoSgQ2Dy5GsJD6RwLA4hazdWzEkZQBzghZKeTEcMRm5A==”

}

}

登录(获取token

协议:

https

http请求方式:

post

请求url

https://域名/ api/login

参数

username:’用户名

password:’密码(通过上一接口获取的公钥,通过RSA加密)

功能说明:

通过此步骤获取token,在之后数据获取接口中通过token认证获取数据(tokenId放在hearder)

返回结果示例:

{

       code:0,  

message:”认证成功”,

data:{

       tokenId:”1C4F5B016C68B397A731625FA48FC2F1

}

}

3.3各平台向智慧消防智能管控平台报送数据

1,请求智慧消防提供接口,获取mq服务地址,账号和密码,及对应exchange名称

获取公钥接口接口说明:

协议:

https

http请求方式:

Get

请求url

https://域名/api/getPublicKey

功能说明:

获取公钥,此公钥用来加密密码,采用RSA加密算法,RSA/ECB/PKCS1Padding填充模式,密匙长度(模值)2048

 (rsa加密工具类)

返回结果示例:

{

    "code": 0,

    "message": "获取成功",

    "data": {

        "publicKey": "MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAnO6zs6U0xihzyHM/XXrFen2VJ0AysjAWCuc9sSswM6pSO0cHV+vxjpM6+nh5fuVaHd10yzeUqMwG3MwLqSWxkOky43Sl29CmDK1Grrrxh6tUru8Z8WHPzyZ2q82fZfen12X+dIszVJueuMyRgtgSHedjeRnivWGBeFPBFUwMOIMfyofzz43Vavhtm23mE5M9OGdjnLc45pkfxe7XiEl27kwZAlInT1cJw9iFGl8rgt4DVMlXpjFtLgy5fod1iOh8zNLMfvGv9gdGqIorzMhcXMjNG6IAlVITUenk2lutnUwE2YJH72YRTlUue8ASQfSD2kOU7WAA9XI4Enoc2SIP1wIDAQAB"

    }

}

登录(获取mq信息,获取信息为测试服务器信息,待测试通过后各厂商向平台申请,申请成功后将提供正式信息)

协议:

https

http请求方式:

post

请求url

https://域名/api/getMqInfo

参数

username:’用户名

password:’密码(通过上一接口获取的公钥,通过RSA加密)

返回结果示例:

{

    code:0,  

message:”认证成功”,

data:{

mqInfo:{

     host:”xxx.xxx.xxx.xxx”,  //服务地址,以正式公布或接口返回为准

port:5672   //端口

routingKey:”厂商编码.exchange*后一个字段.pubinfo”, //routingKey

exchange: {//告警exchange,各厂家根据告警类型,分别将告警信息推送到对应的队列中

    remoteMonitoring:“pubinfo.alarm.type.1”, //远程监控告警exchange

    wisdomWater:”pubinfo.alarm.type.2”,      //智慧用水告警exchange

    wisdomElectricity:”pubinfo.alarm.type.3”,//智慧用电告警exchange

    wisdomWarning:”pubinfo.alarm.type.4”,    //智能预警告警exchange

    chargingPile:”pubinfo.alarm.type.5”,     //智能充电桩告警exchange

    other:“pubinfo.alarm.type.99”,             //其他告警exchange

    test:“pubinfo.alarm.type.test”             //测试告警exchange

   },

username:”测试账号”,

password:”测试密码

}

}

}

2,各厂家按照智慧消防平台提供的对接规范开发,测试相应程序

3,联调测试

4,正式发布

5Mq信息如下(测试环境)

协议:

RabbitMq

服务地址及端口

xxx.xxx.xxx.xxx:5672(请通过接口获取IP

账号

pubinfoAlarm

密码

alarm13579

Exchange

pubinfo.alarm.type.test

功能说明

报警、处理信息推送mqexchange    字段类型见报警信息、处理信息说明,格式为json

 

4. 对接接口详细内容

4.1智慧消防智能管控平台向各平台采集数据

【公共】Params参数描述创建时间和更新时间的区间、列表的主键id

用于全量同步和增量同步数据及获取主键查询结果

创建时间和更新时间、主键id三个参数至少传一个,时间参数区间不得超过7

描述

字段名称

约束

类型

取值说明

创建开始时间

createDateB


Long

时间戳

创建结束时间

createDateE


Long

时间戳

更新开始时间

updateDateB


Long

时间戳

更新结束时间

updateDateE


Long

时间戳

主键id

Id


String

不同表取对应表字段主键

 

4.1.1单位(或者站点、或者建筑)信息

协议:

http/https

http请求方式:

post

请求url

https://域名/ api/getBuilding

功能说明:

获取建筑物信息接口

 

本接口涉及COMPANY_ID4.1.2运营服务单位的COMPANY_ID直接关联

描述

字段名称

数据类型

约束

取值说明

主键

BUILDING_ID

VARCHAR(32)

必填

社会单位(建筑物、站点)的唯.一主键

名称

BUILDING_NAME

VARCHAR(64)

必填

社会单位(建筑物、站点)的全称

所属运营服务公司编码(id

COMPANY_ID

VARCHAR(32)

必填

社会单位归属的运营服务公司

地址

ADDRESS

VARCHAR(200)

必填

详细的地址,可能需要用于设备转坐标地址

社会单位类型

BUILDING_TYPE

VARCHAR(8)

必填

(详见字典表:社会单位类型)

纬度

LAT

DECIMAL(12,6)

必填

纬度,保留小数点6位以上(高德坐标)

经度

LNG

DECIMAL(12,6)

必填

经度,保留小数点6位以上(高德坐标)

区域编码

REGION_CODE

VARCHAR(100)

必填

(详见字典表:区域维表)

设备数

DEVICE_NUM

INTEGER

必填

该社会单位点位下对应的设备总数

所属平台厂商code

PRODUCER_CODE

VARCHAR(32)

必填

参考(5.3平台开发公司【字典】)

4.1.1.1请求参数

创建时间、更新时间、主键id三个参数至少传一个参数(请求参数格式为:

application/x-www-form-urlencoded

描述

字段名称

约束

类型

取值说明

当前页码

pageNo


Integer

默认为 1

每页条数

pageSize


Integer

默认50,*大100

创建开始时间

createDateB


Long

时间戳(精.确到秒:S

创建结束时间

createDateE


Long

时间戳(精.确到秒:S

更新开始时间

updateDateB


Long

时间戳(精.确到秒:S

更新结束时间

updateDateE


Long

时间戳(精.确到秒:S

主键id

Id


String

不同表取对应表字段主键

4.1.1.2返回数据

成功示例:

{

       code:0,

       message:’获取成功

       data: {

pageNo: 1,    //当前页码

pageSize: 50, //每页条数

pageCount: 2, //总页数

              count:80,    //总条数

        list: [                 //数据列表

            {

              buildingId:’38daiofndejd2k3kdjj’,

                            buildingName:’A站点’,

                            companyId:’760’,

                            address:‘杭州市余杭区xx街道xx

                            buildingType:’700’,

                            lng:’120.392932’,

                            lat:’30.273892’,

              regionCode:'330100'

                                     deviceNum:20

                            producerCode:’780’

            }

                     …

        ]

    }

}

失败示例

{

code:1,

message:'获取数据异常',

data:null

}

其它失败结果可根据实际情况自行定义code类型为Integer

4.1.2运营服务公司

协议:

http/https

http请求方式:

post

请求url

https://域名/ api/getCompany

功能说明:

获取运营服务公司(单位)信息接口

 

描述

字段名称

类型

约束

取值说明

运营服务公司ID

COMPANY_ID

VARCHAR(32)

必填

运营服务公司的唯.一主键

运营服务公司名称

COMPANY_NAME

VARCHAR(128)

必填

运营服务公司全称

运营服务公司编码

COMPANY_CODE

VARCHAR(32)

必填

运营服务公司的管理编码

运营服务公司地址

ADDRESS

VARCHAR(128)

必填

单位详细地址

联系人姓名

CONTACT_NAME

VARCHAR(32)

必填

联系人

联系人电话

CONTACT_TEL

VARCHAR(32)

必填

联系人电话

 

4.1.2.1请求参数

创建时间、更新时间、主键id三个参数至少传一个参数(请求参数格式为:

application/x-www-form-urlencoded

 

描述

字段名称

约束

类型

取值说明

当前页码

pageNo


Integer

默认为 1

每页条数

pageSize


Integer

默认50,*大100

创建开始时间

createDateB


Long

时间戳(精.确到秒:S

创建结束时间

createDateE


Long

时间戳(精.确到秒:S

更新开始时间

updateDateB


Long

时间戳(精.确到秒:S

更新结束时间

updateDateE


Long

时间戳(精.确到秒:S

主键id

Id


String

不同表取对应表字段主键

4.1.2.2返回数据

成功示例:

{

       code:0,

       message:’获取成功

       data: {

pageNo: 1,    //当前页码

pageSize: 50, //每页条数

pageCount: 2, //总页数

              count:80, //总条数

        list: [              //数据列表

            {

                 companyId:’760,

                                               companyName:’xx科技公司,

                                   companyCode:’760’,

                                   address:‘杭州市余杭区xx街道xx

                                               contactName:’张三’,

                                   contactTel:’135xxxx3920’

            }

       …

        ]

    }

}

失败示例:

{

code:1,

message:'获取数据异常',

data:null

}

其它失败结果可根据实际情况自行定义(code类型为Integer

 

4.1.3设备信息

协议:

https/http

http请求方式:

post

请求url

https://域名/ api/getEquipment

功能说明:

获取设备信息

 

本接口涉及BUILDING_ID4.1.1单位的BUILDING_ID直接关联、COMPANY_ID4.1.2运营服务单位的COMPANY_ID直接关联

描述

字段名称

类型

约束

备注

设备id

DEVICE_ID

VARCHAR(32)

必填

设备的唯.一主键

设备名称

DEVICE_NAME

VARCHAR(64)

必填

设备的中文名称

设备类型

DEVICE_TYPE

VARCHAR(32)

必填

(详见字典表:设备类型)

地址

ADDRESS

VARCHAR(200)

必填

设备的详细安装地址,可能需要用于设备转坐标地址

纬度

LAT

DECIMAL(12,6)

必填

设备所在的经度,保留小数点6位以上(高德坐标)

经度

LNG

DECIMAL(12,6)

必填

设备所在的经度,保留小数点6位以上(高德坐标)

运营服务公司

COMPANY_ID

VARCHAR(32)

必填

设备的运营服务公司

社会单位(站点或者建筑物)

BUILDING_ID

VARCHAR(32)

必填

设备安装的建筑或桩点

平台厂商code

PRODUCER_CODE

VARCHAR(32)

必填

参考(5.3平台开发公司【字典】)

安装日期

INSTALL_DATE

DATETIME

必填

设备安装的日期

设备状态

DEVICE_STATUS

VARCHAR(32)

必填

1在线、2禁用、3离线)

设备生产公司或品牌

DEVICE_MANUFACTORY

VARCHAR(32)

必填

设备生产公司或品牌

部件数量

PARTS_NUM

INTEGER

必填

设备下对应的部件总数,(1、充电桩设备:即提供充电口数目

2、远程监控用户信息传输装置:即提供该远程监控系统下属部件总数

3、智慧用电:即提供下带传感设备数量

4、智慧用电设备:即提供下带传感设备数量

5、智能预警:NB独立式烟感填写1,网关主机类型请填写该网关主机下带的烟感、手报等数量)

 

4.1.3.1请求参数

创建时间、更新时间、主键id三个参数至少传一个参数(请求参数格式为:

application/x-www-form-urlencoded

描述

字段名称

约束

类型

取值说明

当前页码

pageNo


Integer

默认为 1

每页条数

pageSize


Integer

默认50,*大100

创建开始时间

createDateB


Long

时间戳(精.确到秒:S

创建结束时间

createDateE


Long

时间戳(精.确到秒:S

更新开始时间

updateDateB


Long

时间戳(精.确到秒:S

更新结束时间

updateDateE


Long

时间戳(精.确到秒:S

设备主键id

Id


String

不同表取对应表字段主键

4.1.3.2返回数据

成功示例:

{

       code:0,

       message:’获取成功

       data: {

pageNo: 1,    //当前页码

pageSize: 50, //每页条数

pageCount: 2, //总页数

        count:80,  //总条数

       list: [      //数据列表

           {

              deviceId:’1’,

deviceName:’xx监控设备’,

deviceType:’700’,

address:’杭州市西湖区’,

lat:’30.293323’,

lng:’120.382832’,

companyId:’8389’

buildingId:’ 892983’,

producerCode:’670’,

installDate:’2018-08-01‘,

deviceStatus:’1’,

deviceManufactory:’222’

              partsNum:20

           }

        …

       ]

    }

}失败示例:

{

code:1,

message:'获取数据异常',

data:null

}

其它失败结果可根据实际情况自行定义(code类型为Integer

 

4.1.4设备部件信息

设备部件概念的请参考1.4术语和定义章节

协议:

https/http

http请求方式:

post

请求url

https://域名/ api/getParts

功能说明:

获取部件信息

 

本接口涉及DEVICE_ID4.1.3设备信息的DEVICE_ID直接关联

描述

字段名称

类型

约束

备注

设备部件id

PARTS_ID

VARCHAR(32)

必填

设备部件的唯.一主键

设备部件名称

PARTS   _NAME

VARCHAR(64)

必填

设备部件的中文名称

地址

ADDRESS

VARCHAR(200)

必填

该地址默认和设备安装地址一样,如不同请填写

设备id

DEVICE_ID

VARCHAR(32)

必填

设备部件关联的设备id

部件生产厂家或品牌

PARTS_MANUFACTORY

VARCHAR(32)

必填

部件的硬件制造商或品牌

安装日期

INSTALL_DATE

DATETIME

必填

设备安装的日期

设备部件状态

PARTS_STATUS

VARCHAR(32)

必填

1正常、10报警、20故障、99其它)

设备部件类型

PARTS_TYPE

VARCHAR(32)

必填

参考字典表5.6

同时请注意部件类型和应用系统类型有对应关系。

类型编码 2XXX:  智慧用水

3XXX:智慧用电

4XXX:智能预警

5XXX:智能充电桩

1-1999:远程监控(参考国标)

 

4.1.4.1请求参数

创建时间、更新时间、主键id三个参数至少传一个参数(请求参数格式为:

application/x-www-form-urlencoded

描述

字段名称

约束

类型

取值说明

当前页码

pageNo


Integer

默认为 1

每页条数

pageSize


Integer

默认50,*大100

创建开始时间

createDateB


Long

时间戳(精.确到秒:S

创建结束时间

createDateE


Long

时间戳(精.确到秒:S

更新开始时间

updateDateB


Long

时间戳(精.确到秒:S

更新结束时间

updateDateE


Long

时间戳(精.确到秒:S

设备主键id

Id


String

不同表取对应表字段主键

 

4.1.4.2返回数据

成功示例:

{

       code:0,

       message:’获取成功

       data:{

       pageNo: 1,    //当前页码

pageSize: 50, //每页条数

pageCount: 2, //总页数

       count:80, //总条数

      list: [{

partsId:’1’,

partsName:’xx探测器’,

address:’杭州市西湖区’,

deviceId:’8389’

partsManufactory:’海湾’,

installDate:’2018-08-01‘,

partsStatus:’10’,

partsType:'3001'

      }

    ...

   ]

}

}失败示例:

{

code:1,

message:'获取数据异常',

data:null

}

其它失败结果可根据实际情况自行定义(code类型为Integer

 

4.2 各平台向智能管控平台上报或推送信息

4.2.1报警信息(实时)

发生警告时,通过mq推送到消防智能管控平台

本接口涉及BUILDING_ID4.1.1单位的BUILDING_ID直接关联、DEVICE_ID4.1.3设备信息的DEVICE_ID直接关联、PARTS_ID4.1.4设备部件信息的PARTS_ID直接关联

字段描述

字段

类型

约束

备注

告警编号id

ALARM_EVENT_ID

VARCHAR(32)

必填

本次设备告警的唯.一主键编码id

设备id

DEVICE_ID

VARCHAR(32)

必填

设备唯.一主键(参见设备基础信息接口字段)

社会单位(建筑、站点)主键

BUILDING_ID

VARCHAR(32)

必填

社会单位(站点、建筑物)的唯.一主键

发生时间

HAPPEN_TIME

DATETIME

必填

告警发生时间(格式:2018-07-18   12:12:12

报警信息json

ALARM_CONTENT

VARCHAR(1000)

必填

告警详情,可自由定义数量,至少一组

告警类型

ALARM_TYPE

VARCHAR(2)

必填

(详见字典表:告警类型)

设备部件id

PARTS_ID

VARCHAR(32)

必填

实际发生告警的设备部件

平台厂商编码

PRODUCER_CODE

VARCHAR(32)

必填

平台开发公司(和平台方申请,将提供编码)

 

推送格式:

{

"alarmEventId":"1548227253000",

"deviceId":"399L00762",

"buildingId":"579HZ007",

"happenTime":"2019-01-23 15:07:32",

"alarmContent":

{"电压过压":"400V","电流过载":""},

"alarmType":"401",

"partsId":"1",

"producerCode":"640"

}

 

5. 字典表

5.1社会单位类型【字典】

单位/建筑类型

单位/建筑物类型名称

building_type_id

building_type_name

1

长途汽车客运站、火车站、地铁站、机场、客运码头

2

公共供水单位

3

瓶装燃气储配单位

4

瓶装燃气供应站

5

寄递企业

6

物流企业

7

加油站

8

宾馆、旅馆

9

民宿、农家乐

10

商业综合体

11

出租房(企业员工集体宿舍)

12

学校、幼儿园

13

网吧

14

娱乐场所

15

工矿企业

16

劳动密集型企业

17

建筑工地

18

高层建筑

19

住宅小区(老旧小区)、居民楼

20

教育培训机构

21

医院、养老院

22

商场、市场

23

食品生产加工小作坊

24

中央厨房、集体用餐配送单位、特大型、大型餐饮单位

25

网络餐饮、小餐饮店

26

农贸市场

999

其他

 

5.2区域维表【字典】

区域为表【字典表】定期根据行政区域变化进行调整,详细字典表请参见

附件1:区域为表字典表。

5.3平台开发公司【字典】

向智慧消防智能管控平台申请

平台厂商编码

平台厂商名称

code

name





 

5.4告警类型【字典】

设备类型id

设备类型名称

报警类型

报警类型名称

报警类型父类

device_type

device_type_name

alarm_type_code

alarm_type_name

parent_id

1,2,3,4,5,

五大类

74

火警报警

0

71

告警报警

0

72

隐患报警

0

73

其它报警

0

1

远程监控

101

自动报警

74

102

(用户信息传输装置手动报警按钮)手动报警

74

109

其它报警

74

121

监管信号

72

122

设施故障

72

123

屏蔽故障

72

124

设备离线

72

190

复位信号

73

191

反馈信号

73

192

启动

73

199

其它

73

2

智慧用水

201

水位异常

71

202

水压异常

71

204

电量过低

72

299

其它

73

3

智慧用电

301

温度过高

71

302

电流异常

71

303

电压异常

71

304

剩余电流

71

399

其它

73

4

智能预警

401

烟雾报警

74

402

温度报警

74

403

气体报警

74

404

电量过低

72

499

其它

73

5

充电桩

501

温度异常

71

502

功率过载

71

503

电压异常

71

504

电流异常

71

599

其它

73

5.5设备类型【字典】

设备类型id

设备类型名称

device_type

device_type_name

1

远程监控

2

智慧用水

3

智慧用电

4

智能预警

5

智能充电桩

99

其它

 

5.6部件类型【字典】

部件类型id

部件类型名称


part_type

part_type_name


3001

温度传感器


3002

电流互感器(电流传感器)


3003

剩余电流互感器(剩余电流传感器)


3004

电压传感器


3005

电弧探测器


4001

独立式烟雾探测器


4002

独立式可燃气体探测器


4003

独立式温感探测器


4004

独立式手动报警器


2001

液位变送器(液位传感器)


2002

压力变送器(压力传感器)


5001

标准充电口


9999

其它部件


1001

远程监控默认部件


1

火灾报警控制器

10

可燃气体探测器

11

点型可燃气体探测器

12

独立式可燃气体探测器

13

线型可燃气体探测器


16

电气火灾监控报警器


17

剩余电流式电气火灾监控探测器


18

测温式电气火灾监控探测器


21

探测回路


22

火灾显示盘


23

手动火灾报警按钮


24

消火栓按钮


25

火灾探测器


30

感温火灾探测器


31

点型感温火灾探测器


32

点型感温火灾探测器(s)


33

点型感温火灾探测器(R)


34

线型感温火灾探测器


35

线型感温火灾探测器(S)


36

线型感温火灾探测器(R)


37

光纤感温火灾探测器


38

预留


39

预留


40

感烟火灾探测器


41

点型离子感烟火灾探测器


42

点型光电感烟火灾探测器


43

线型光束感烟火灾探测器


44

吸气式感烟火灾探测器


50

复合式火灾探测器


51

复合式感烟感温火灾探测器


52

复合式感光感温火灾探测器


53

复合式感光感烟火灾探测器


60

预留


61

紫外火焰探测器


62

红外火焰探测器


69

感光火灾探测器


74

气体探测器


78

图像摄像方式火灾探测器


79

感声火灾探测器


80

预留


8l

气体灭火控制器


82

消防电气控制装置


83

消防控制室图形显示装置


84

模块


85

输入模块


86

输出模块


87

输入/输出模块


88

中继模块


91

消防水泵


92

消防水箱


95

喷淋泵


96

水流指示器


97

信号阀


98

报警阀


99

压力开关


100

预留


101

阀驱动装置


102

防火门


103

防火阀


104

通风空调


105

泡沫液泵


106

管网电磁阀


111

防烟排烟风机


112

预留


113

排烟防火阀


114

常闭送风口


115

排烟口


116

电控挡烟垂壁


117

防火卷帘控制器


118

防火门监控器


121

警报装置






 浙江省火灾智能防控系统标准

浙江智慧消防平台对接指南 智慧消防智能管控平台对接指南 浙江省火灾智能防控系统标准 智慧消防标准

相关文章

百科知识问答

推荐产品

联系我们

156-3892-8010

1906984964

:xp@gdliontech.cn

:9:30-22:30

QR code