geofence.tag.cloud

The geofence.tag.cloud command is used to generate a geofences tag cloud. Filtering by tags and/or keys will generate a tag cloud containing the different tags associated to the request params (tags/keys). For more detail use cases, see thing.tag.cloud.

TR50 Request

{
  "cmd": {
    "command": "geofence.tag.cloud",
    "params": {
      "tags": ["tag1", "tag2"],
      "keys": ["mygeofence1", "mygeofence2"]
    }
  }
}

Request Parameters

Name	Type	Required	Description
tags	Array		An array of tags. The result will be limited to the tags associated with geofences that already have the indicated tags.
keys	Array		An array of geofence keys. The result will be limited to the tags associated with geofences identified by the specified geofence keys.

TR50 Response

If the command is sent successfully a success message and the tag cloud object is returned. Otherwise, an error and error message will be returned.

{
  "cmd": {
    "success": true,
    "params": {
      "result": [
        {
          "tag3": 2
        },
        {
          "tag4": 1
        }
      ]
    }
  }
}

Response Parameters

Name	Type	Description
result	Array	An array of objects. Each object will list the tags count associated to the input tags and/or keys. In the above example, 2 things has tag3 along with tag1 or tag2 and along with mygeofence1 or mygeofence2, and 1 thing have tag4 along with tag1 or tag2 and along with mygeofence1 or mygeofence2.