BEMS智能楼宇能耗管理系统REST接口初稿与数据查询示例

需积分: 0 0 下载量 176 浏览量 更新于2024-08-04 收藏 24KB DOCX 举报
BEMS智能楼宇能耗管理系统Web-Service接口文档(初稿)详细介绍了该系统如何通过RESTful架构为楼宇内的各类设备提供服务。系统基于IP地址(如180.84.33.71)和特定端口号(如8080)构建统一的URL,如`http://180.84.33.71:8080/bems_v2/rest/meterService/1`,用于发起HTTP请求。 该文档涵盖了两个主要功能模块:仪表基本信息查询和仪表分析数据查询。在基本信息查询中,例如,要获取编号为20120002的电表在2010年1月至3月的周用量,可以发送GET请求到`http://localhost:8888/bems_v2/rest/deviceDataAnalysis/query`,并附带设备类型(ammeter)、设备ID和时间范围参数。如果需要查询多个电表的数据,只需在URL中添加多个`id`参数。 分析数据查询允许用户按月份查询水表能耗情况,如查询2011年编号为20000004的水表月度能耗,可以通过`http://localhost:8888/bems_v2/rest/deviceDataAnalysis/querymonth`发起请求,并指定设备类型(meter)、ID和查询的年份。系统响应通常以JSON格式返回数据,如示例中的`{month:[1.365375439596388,0.9070259982980318,...]}`,包含了具体能耗数值。 值得注意的是,由于系统处于开发阶段,web-service接口可能还不完整且会随着项目的推进而增加。开发者或用户在实际使用时应关注接口的更新和文档的同步,以确保与系统的兼容性。 总结来说,这份文档是BEMS智能楼宇能耗管理系统的核心技术细节,对于理解如何通过Web-Service与系统交互、获取能耗数据以及跟踪接口的增删改查至关重要。在项目开发和集成阶段,这份文档提供了明确的指南,有助于提升系统的可扩展性和易用性。