广州市公共建筑能耗监测系统接入接口技术文档.doc

PAGE16/NUMPAGES23

附件4

广州市公共建筑能耗监测系统

接入接口技术文档

目录

TOC\o1-3\h\z\u258991引言 3

313801.1编写目的 3

262431.2使用范围 3

293491.3术语 3

84762对接说明 5

53932.1接口对接 5

49532.2上报数据要求 5

167623开发规范 6

219773.1通信协议 6

121403.2通信安全 6

178744接口明细 6

91364.1接口调用 6

183264.1.1接口调用方式 6

3434.1.2接口认证 7

25374.1.3返回结果 10

72054.2推送分类分项能耗数据 11

146674.2.1请求参数： 11

79964.2.2返回结果： 12

190534.2.3代码示例 12

128585附录 13

321005.1能耗分类分项 13

61805.2广州行政区域代码 13

18795.3建筑类型 14

78955.4能耗单位 14

引言

编写目的

为实现《广州市公共建筑能耗监测系统》对监测建筑能耗数据采集的可接入性、及时性与安全性要求，依据现行国家相关标准，特编写本接口文档以供公共建筑所有者自行建设系统，按照标准接口接入市能耗监测系统。

使用范围

本文档适用对象为需要接入《广州市公共建筑能耗监测系统》进行能耗监测的建筑物，包括国家机关办公建筑、大型公共建筑等建筑。

术语

术语

术语释义

国家机关办公建筑和大型公共建筑

国家机关办公建筑是指从事国家管理和行使国家权力的机关的办公建筑，包括国家各级党委、政府、人大、政协、法院、检察院等机关的办公建筑；大型公共建筑是指除国家机关办公建筑之外的单体建筑面积2万平方米以上的公共建筑。

能耗监测系统

能耗监测系统是指通过对国家机关办公建筑和大型公共建筑安装分类和分项能耗计量装置，采用远程传输等手段及时采集能耗数据，实现重点建筑能耗的在线监测和动态分析功能的硬件系统和软件系统的统称。

分类能耗

分类能耗是指根据国家机关办公建筑和大型公共建筑消耗的主要能源种类划分进行采集和整理的能耗数据，如：电、燃气、水等。

分项能耗

分项能耗是指根据国家机关办公建筑和大型公共建筑消耗的各类能源的主要用途划分进行采集和整理的能耗数据，如：空调用电、动力用电、照明用电等。

对接说明

接口对接

1、开通对接建筑编码：需接入能耗监测系统的的公共建筑提供建筑基本信息给“市能耗监测系统”，市能耗监测系统给建筑开通系统对接建筑id。

2、能耗数据上报方式

直接推送分类分项能耗数据：公共建筑调通接口后，按分类分项推送本建筑的能耗数据。详见接口4.2推送分类分项能耗数据。

上报数据要求

1、上报分类分项能要求

最少要上报电力的4个分类分项的能耗数据，包括：01A00-照明插座用电；01B00-空调用电；01C00-动力用电；01D00-特殊用电。

2、上报能耗数据要求：

需按逐次、逐时或逐日方式上报各分类分项的增量能耗值。

1）如按逐次方式上报分类分项的能耗值，可以不需要上报逐时、逐日的分类分项能耗值。系统会自动汇总成逐时、逐日、逐月、逐年的分类分项能耗数据。逐次方式是指按每15分钟上报一次分类分项增量能耗数据，即每个小时的15分、30分、45分、0分钟时，推送当前时间所有分类分项的能耗数据到系统。

2）如按逐时方式上报分类分项的能耗值，可以不需要上报逐日的分类分项能耗值，系统会自动汇总成逐日、逐月、逐年的分类分项能耗数据。逐时方式是指每小时的0分上报一次各分类分项的增量能耗数据。

3）如按逐日方式上报分类分项的能耗值，系统会自动汇总成逐月、逐年的分类分项能耗数据。逐日方式是指每天的0时0分上报一次各分类分项的增量能耗数据。

4）最低要求按逐日方式上报增量能耗值。

开发规范

通信协议

采用HTTP方式请求，数据格式采用JSON，所有请求均为POST请求方式。

由“市能耗监测系统”提供接口地址，供建筑业主能耗应用系统调用。

接口未注明处均使用UTF-8编码。

请求参数均为字符串格式。

接口请求需进行认证，详见3.2通信安全一节。

通信安全

为保证数据传输过程中的数据真实性，我们需要对推送能耗数据接口进行认证，在认证成功后方能推送能耗数据到“市能耗监测系统”。“市能耗监测系统”会给每个接入建筑一个唯一建筑id。

安全认证数据传输机制如下：

建筑传输能耗数据时，需进行接口安全访问认证，所有接口需要生成token放入请求头部后才能正常请求。Token由标识id、密钥secret、时间戳和