Get All Fixtures by Area

The API returns the location for all fixtures in an area 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 
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 get the Area ID.
Response 
id Sensor identifier
name Sensor name. For example, Sensorxxxxxx
xaxis Scaled reference of the distance measured 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: The Manage system removes leading zeros when storing and returning MAC/SNAP addresses, resulting in truncation. For example, "00:c0:17" becomes "0:c0:17" in our system.
groupid Profile group identifier. The ID of the profile associated with the fixture.

Sample Code

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

HTTP/1.1 200 OK
Server: Apache-Coyote/1.1
Content-Type: application/xml
Content-Length: 7582
Date: Sat, 21 Jul 2015 17:06:51 GMT
 {
  "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",
      ..
    }
  ]

 

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

Comments

Article is closed for comments.