Get All Fixtures by Area¶
The API returns the location for all fixtures in an area on a floor. An area is a grouping of sensors or fixtures on a floor. The data is returned as X, Y coordinates of the measured and scaled-down distance from the lower-left corner of the uploaded floor plan.
Request¶
GET https://{em_ip_address_or_hostname}/ems/api/org/fixture/v1/location/list/area/{area_id}
Parameters¶
Request¶
| Name | Description |
|---|---|
em_ip_address_or_hostname | The Enlighted Manage (EM) IP address or hostname |
area_id | Area identifier. Use the Area ID returned in the Get All Areas API, or in EM, select Facility > Floor > Area in the left panel, and click the Settings tab to obtain the Area ID. |
Response¶
| Name | Description |
|---|---|
id | Sensor identifier. |
name | Sensor name. For example, Sensorxxxxxx. |
xaxis | Scaled measurement of distance in the horizontal dimension from the lower-left corner of the uploaded floor plan. |
yaxis | Scaled measurement of distance in the vertical dimension from the lower-left corner of the uploaded floor plan. |
macaddress | Sensor's MAC address. NOTE: Manage does not store leading zeros when saving or returning MAC/SNAP addresses. For example, "00:c0:17" will be stored as "0:c0:17”. |
groupid | Light Profile identifier. The ID of the profile associated with the fixture. |
Sample Request¶
Request the x- and y-axis coordinates for all sensors in the area with ID ‘9’.
GET https://192.80.3.2/ems/api/org/fixture/v1/location/list/area/9
Sample Response¶
{
"fixture": [
{
"id": "361",
"name": "Sensor00c017",
"xaxis": "966",
"yaxis": "391",
"macaddress": "0:c0:17",
"groupid": "185"
},
{
"id": "1364",
"name": "Sensor0629dd",
"xaxis": "270",
"yaxis": "90",
"macaddress": "6:29:dd",
"groupid": "196"
},
{
"id": "835",
"name": "Sensor013ec0",
"xaxis": "756",
"yaxis": "462",
"macaddress": "1:3e:c0",
"groupid": "55"
}
]
}