Get all Bluetooth Fixtures by Floor¶
The API returns the sensor location for all BLE sensors 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. The API also returns the sensor Product code.
Request¶
GET https://{em_ip_address_or_hostname}/ems/api/org/fixture/blefixture/list/floor/{floor_id}
Parameters¶
Request¶
| Parameter | Description |
|---|---|
em_ip_address_or_hostname | Manage’s IP address or hostname |
floor_id | Floor identifier. Use the Get All Floors API, or in EM, select Facility > Floor > in the left panel, and click the Settings tab to obtain the Floor ID. |
Response¶
| Parameter | Description |
|---|---|
id | Sensor identifier. |
name | Sensor name. For example, Sensorxxxxxx. |
x-axis | Scaled reference of the distance measured in the horizontal dimension from the lower-left corner of the uploaded floor plan. |
y-axis | Scaled reference of the distance measured in the vertical dimension from the lower-left corner of the uploaded floor plan. |
groupid | Profile group identifier. The ID of the profile associated with the fixture. |
macAddress | MAC address. |
bleMode | Represents the Bluetooth Low Energy (BLE) mode of the fixture. Possible values: OFF/ON |
modelNo | Sensor product code. For product codes, refer to the list of Sensors and Product codes in the Spec Sheets. |
Sample Request¶
Using the Floor ID '1' returned by the Get All Floors API, send a request to Manage to return the x- and y-axis of the scaled-down distance from the lower-left corner of the floor plan for all BLE sensors on Floor 1.
GET https://{em_ip_address_or_hostname}/ems/api/org/fixture/blefixture/list/floor/1
Sample Response¶
{
"fixture": [
{
"id": "361",
"name": "Sensor00c017",
"xaxis": "966",
"yaxis": "391",
"groupid": "185",
"modelNo": "SU-4E-01",
"macaddress": "00:c0:17",
"bleMode": "OFF"
},
{
"id": "1364",
"name": "Sensor0629dd",
"xaxis": "270",
"yaxis": "90",
"groupid": "196",
"modelNo": "SU-4E-01",
"macaddress": "06:29:dd",
"bleMode": "OFF"
},
{
"id": "835",
"name": "Sensor013ec0",
"xaxis": "756",
"yaxis": "462",
"groupid": "55",
"modelNo": "SU-4E-01",
"macaddress": "01:3e:c0",
"bleMode": "OFF"
}
]
}