Get All Plugloads by Floor API¶
The API returns plugload location for all plugloads 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 Plugload ID that is returned is used as the primary identifier in other API calls.
Request¶
GET https://{em_ip_address_or_hostname}/ems/api/org/plugload/v1/location/list/floor/{floor_id}/1
Parameters¶
Request¶
| Name | Description |
|---|---|
em_ip_address_or_hostname | The Manage IP address or hostname. |
floor_id | Floor identifier. Use the Floor ID returned in 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¶
| Name | Description |
|---|---|
id | Plugload identifier (used as the primary identifier in other API calls). |
name | Plugload name. For example, plugloadxxxxxx |
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 | Plugload 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 | Profile group identifier. The ID of the profile associated with the plugload. |
| Ignore the remaining parameters displayed |
Sample Request¶
Use the Floor ID '1' returned by the Get All Floors API to return the x- and y-axis of the scaled-down distance from the lower-left corner of the floor plan for all plugloads on Floor 1.
GET https://192.80.3.2/ems/api/org/plugload/v1/location/list/floor/1/1
Sample Response¶
{
"plugload": [
{
"id": "361",
"name": "Plugload00c017",
"status": "0",
"xaxis": "966",
"yaxis": "391",
"macaddress": "0:c0:17",
"groupid": "185",
...
},
{
"id": "364",
"name": "Plugload0629dd",
"status": "1",
"xaxis": "270",
"yaxis": "90",
"macaddress": "6:29:dd",
"groupid": "196",
...
},
{
"id": "835",
"name": "Plugload013ec0",
"status": "0",
"xaxis": "756",
"yaxis": "462",
"macaddress": "1:3e:c0",
"groupid": "55",
...
}
]
}