Point

A Point corresponds to a user-defined “location” on the map, and is typically used in reporting summaries, or in the creation of alarms. Often referred to as POI.

URL Structure is:
https://api.trackunit.com/public/Point

GetPoint

Will list parameters on a specified point.

Parameters

NameData typeUnit of measurementNote
id *StringN/AUnique identifier

Errors

Error CodeDescription
pointNotFoundPoint with supplied “Id” was not found.

Columns

Refer to the following table for description of columns:

NameData typeUnit of measurementNullabilityNote
idStringN/AFALSEUnique identifier
nameStringN/AFALSE
noteStringN/ATRUE
iconStringN/ATRUE
locationLocationN/AFALSE
addressAddressN/ATRUE

Request (example)

{
    "id": "71067"
}

Response

{
  "list": [
    {
      "id": "71067",
      "name": "Region West",
      "note": "Company headquarters",
      "icon": "16x16/about.png",
      "location": {
        "latitude": 51.20118,
        "longitude": 6.777766
      },
      "address": {
        "country": "DE",
        "zipCode": "40237",
        "city": "Düsseldorf",
        "streetAddress": "Sohnstr. 159"
      }
    }
  ]
}
 

CreatePoint

Will create a new point.

Parameters

NameData typeUnit of measurementNote
name *StringN/AName of point.
noteStringN/A
location*LocationN/A
addressAddressN/A

Request (example)

{
   "name": "Berlin depot",
   "location":{
      "latitude":52.530112,
      "longitude":13.522968
 	 }
}

Response

{
  "id": "71094"
}
 

UpdatePoint

Will update parameters on an existing point.

Parameters

NameData typeUnit of measurementNote
id *StringN/AUnique identifier.
nameStringN/AName of point.
noteStringN/A
locationLocationN/A
addressAddressN/A

Request (example)

{
      "id": "71067",
      "name": "Region North"
}

Response

{}
 

DeletePoint

Will delete an existing point.

Parameters

NameData typeUnit of measurementNote
id *StringN/AUnique identifier.

Request (example)

{
    "id": "71067"
}

Response

{}