Get All Plugloads by Floor

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 
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 
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. 
groupid: Profile group identifier. The ID of the profile associated with the plugload.
Ignore the remaining parameters displayed

Sample Code

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

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
{
  "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",
      ..
    }
  ]
}

 

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

Comments

Article is closed for comments.