Get Sensor Details by Floor API¶
Returns sensor details for all sensors on the floor for a given period at every five-minute interval. For example, sensor data is sent at every five-minute interval if the duration is from 10:00 am to 10:10 am. The API retrieves data for a maximum period of one hour.
Request¶
GET https://{em_ip_address_or_hostname}/ems/api/org/sensor/v2/stats/floor/{floor_id}/{from_date}/{to_date}
Parameters¶
Request¶
| Name | Description |
|---|---|
em_ip_address_or_hostname | The Enlighted Manage (EM) IP address or hostname. |
floor_id | Floor identifier. Use the Floor ID returned in the Get All Floors API, or in Manage, select Facility > Floor in the left panel, and click the Settings tab to obtain the Floor ID. |
from_date | Start date to display energy consumption data. Format: (yyyyMMddHHmm) year/month/day/hour/minutes |
to_date | End date to stop displaying energy consumption data. Format: (yyyyMMddHHmm) year/month/day/hour/minutes |
Response¶
| Name | Description |
|---|---|
Id | Fixture identifier (used as the primary identifier in other API calls) |
power | The average load of the fixture in watts for the last five-minute interval |
temperature | Temperature in Fahrenheit |
lightLevel | Ambient light level reading at the sensor (lux). See Ambient Status for details. NOTE: The unit level measurement of light striking the Enlighted Sensor lens is an approximation of Lux. |
avgDimLevel | Average fixture dim level represents light level where there is sufficient light for the occupants. If the sensor is not connected to any lighting fixture, the API call returns a value of -1. |
lastCommunicationtime | Time of last sensor communication (YYYY-MM-DD 24HH-MM) |
captureTime | Five-minute time duration represented as (yyyy-MM-dd HH:mm) year-month-day-hour-minutes |
Sample Request¶
Request sensor details for all sensors on the first floor with Floor ID ‘1’ from 10 am through 11:30 am on Feb. 12, 2019. Data will be sent at every five-minute interval, which will be 10:05 am and 10:10 am, and so on.
GET https://192.80.3.2/ems/api/org/sensor/v2/stats/floor/1/201902120100/201902120200
Sample Response¶
{
"sensor": [
{
"id": "28",
"power": "27.98",
"temperature": "78",
"lightLevel": "773",
"avgDimLevel": "85",
"lastCommunicationTime": "2019-02-12 10:12",
"captureTime": "2019-02-12 10:05"
},
{
"id": "29",
"power": "12.62",
"temperature": "74",
"lightLevel": "593",
"avgDimLevel": "85",
"lastCommunicationTime": "2019-02-12 10:12",
"captureTime": "2019-02-12 10:10"
},
],
"sensor": [
{
"id": "1327",
"power": "27.98",
"temperature": "74",
"lightLevel": "99",
"avgDimLevel": "85",
"lastCommunicationTime": "2019-02-12 10:12",
"captureTime": "2019-02-12 10:15"
},
{
"id": "1377",
"power": "12.62",
"temperature": "70",
"lightLevel": "462",
"avgDimLevel": "75",
"lastCommunicationTime": "2019-02-12 10:12",
"captureTime": "2019-02-12 10:20"
}
]
}