This API is supported for Manage 4.4 release and above.
This API returns the total energy consumption in watt-hour for all fixtures on the floor. The energy consumption data can be retrieved for up to forty-five (45) days. The energy data returned is pre-aggregated in fifteen (15) minute intervals (96 records per day) to make it easier for you to adhere to most measurement and verification (M&V) reporting standards.
Request
GET https://{em_ip_address_or_hostname}/ems/api/org/facility/v2/facilityEnergyStatsOfFloor/15min/floor/{floorID}/{from_date}/{to_date}?page={page}
Parameters
Request | |
em_ip_address or hostname | The Manage IP address or hostname. |
floorID | Floor identifier. Use the Get All Floors API to obtain the floor_id, or in EM, select Facility > Floor in the left panel, and click the Settings tab. |
from_date | Start date to display energy consumption data. Format: (yyyyMMddHHmmss). year/month/day/hour/minutes/seconds. |
to_date | End date to stop displaying energy consumption data. Format: (yyyyMMDDHHmmss). year/month/day/hour/minutes/seconds. |
page | The requested page number. Each page displays 96 records corresponding to 24 hours of energy consumption data. For example, when a user requests 30 days of energy consumption data, the 15th page will have the energy consumption details for the 15th day of the requested period. |
Response | |
id | Floor Identifier. |
name | Floor name. |
intervalStart | Time from when data is retrieved (YYYY-MM-DDTHHLMM:SS{+/-GMT}) |
baseEnergy | Displays the baseline energy consumption in watt-hour of the fixtures. The difference between 'baseEnergy' and 'energy' is 'savedEnergy'. Base energy is the amount of energy the fixtures will consume if their dimLevel was 100% for the entire period; 'energy' will never be greater than 'baseEnergy'. |
energy | The energy consumed by all fixtures in watt-hour on the floor for the period. |
savedEnergy |
The energy saved by the fixtures in watt-hour on the floor for the period. savedEnergy = baseEnergy - energy |
occSavings | Fixture energy savings from baseline when lights are switched off due to vacancy. |
ambientSavings | Fixture energy savings from baseline when lights are dimmed due to available ambient daylight. |
manualSavings | Fixture energy savings from baseline when lights are manually controlled. |
Sample Code
Using the Floor ID '1' returned by the Get All Floors API, request the aggregate energy consumption for fixtures on the floor from 5:30am on Feb. 12, 2019 to 5:30am on Feb. 19, 2019. The sample response shows details returned for fixtures on the floor for the specified time period for page 2 (Feb. 13, 5:30am to Feb. 14, 5:30am).
GET https://192.80.3.2/ems/api/org/facility/v2/facilityEnergyStatsoffloor/15min/floor/1/20190212053000/20190219053000?page=2 |
Comments
Article is closed for comments.