Geozones

Geozones are Managed Objects in the Cumulocity domain model, identifiable as a geozone by the c8y_IsGeozone fragment.

A Geozone is a Managed Object. Geozones are childAssets of Clients.

Geozone Managed Object properties

Additionally to the default Managed Object fragments, a Geozone Managed Object looks as following:

{
  "name": "<geozone name>",
  "guid": "<unique uuid, generate for example here: https://www.uuidgenerator.net/>",
  "type": "kpn_Geozone",
  "c8y_IsForAssetTracking": {},
  "c8y_IsGeozone": {},
  "geoJSON": {
    "features": [
      {
        "geometry": {
          "coordinates": [
            [
              [4.489977, 51.917174],
			  [4.516802, 51.913333],
			  [4.477836, 51.900043],
			  ...
            ]
          ],
          "type": "Polygon"
        },
        "type": "Feature"
      }
    ],
    "type": "FeatureCollection"
  }
}
  • Keep in mind, latitude and longitude are in the order [LONGITUDE,LATITUDE]in the coordinates array.

  • Latitude and longitude are float values.

  • keep in mind the guid value should be unique for each Geozone!

Relations

A Geozone is a child asset of a Client. Clients can be created through the web interface.

Below is an API call example that references an existing Geozone Managed Object with an existing Client Managed Object.

POST /inventory/managedObjects/<assetId>/childAssets HTTP/1.1
Host: <tenantName>.kpnthings.com
Authorization: Basic <token>
Content-Type: application/json
{
  "managedObject": {
    "id": "<geozoneId>"
  }
}

Last updated