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"     
    }
  ]
}