Get Area Energy Consumption

Returns the aggregate energy consumption in watt-hour for all devices in the area for the last 15 minutes. 

For example, if the request is between 10:05:00 and 10:19:59 am, energy data is sent for the period from 9:45 to 10:00 am. Likewise, if the request is between 10:20:00 and 10:34:59, data is sent for the period from 10:00 to 10:15 am. The data is aggregated from all fixtures in the area at 5-minute intervals and is rounded to the nearest last 15-minute interval set. 

Request

GET https://{em_ip_address_or_hostname}/ems/api/org/area/v1/energy/{area_id}

Parameters

Request 
em_ip_address or hostname The Manage (EM) IP address or hostname
area_id Area identifier. Use the Get All Areas  API, or in EM, select Facility > Floor > Area in the left panel, and click the Settings tab to get the Area ID.
Response 
energy-lighting Reports aggregate energy consumption in watt-hour for the last 15 minutes for all lighting fixtures in the area
energy-plugload Reports aggregate energy consumption in watt-hour for the last 15 minutes for all plugloads in the area 

Sample Code

For example, the  Get all Areas API returned two areas: Hardware area with ID ‘9’ and Software area with ID ‘27’. Send a request to the EM to return the watt-hour for all devices in the area for the last 15 minutes for Area ID '9'.

Get https://192.80.3.2/ems/api/org/area/v1/energy/9

HTTP/1.1 200 OK
Server: Apache-Coyote/1.1
Content-Type: application/json
Content-Length: 7582
Date: Sat, 21 Jul 2015 17:06:51 GMT
{
  "energy-lighting": "5580.96"
  "energy-plugload": "380.63"
}

 

Was this article helpful?
1 out of 1 found this helpful
Have more questions? Submit a request

Comments

Please sign in to leave a comment.