Get All Plugloads by Area

The API returns plugload location for all plugloads in an area. 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/plugload/v1/location/list/area/{area_id}/1

Parameters

Request 
em_ip_address or hostname: The Manage 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: Plugload identifier.
name: Plugload name. Default plugload name is in the format 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

For example, the Get all Areas API returned two areas: Hardware area with ID ‘9’ and Software area with ID ‘27’. Request the EM for the x- and y- coordinates of the scaled-down distance of the floor plan for all plugloads in the area with area ID ‘9’.

Get https://192.80.3.2/ems/api/org/plugload/v1/location/list/area/9/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": "1364",
      "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.