Geofences & points of interest

List geofences

GET /fleet/geofences

Areas drawn by the organisation, either a circle or a polygon. These are the zones used by GEOFENCE_ENTER and GEOFENCE_EXIT alerts.

Name	Type	Description
geometry	boolean	true adds each polygon as GeoJSON.
search	string	Match on name.
limit, cursor		See Pagination.

curl "https://api.routetracks.com/api/v1/partner/v1/fleet/geofences?geometry=true" \
  -H "Authorization: Bearer $TOKEN"

{
  "data": [
    {
      "id": "0b7c6f1e-3d1a-4a6e-9a51-6c2f0e4b7d11",
      "name": "Colombo Port – Gate 4",
      "code": "CMB-G4",
      "kind": "port",
      "typeName": "Port",
      "shape": "polygon",
      "center": { "latitude": 6.94732, "longitude": 79.84391 },
      "radius": 0,
      "geometry": {
        "type": "Polygon",
        "coordinates": [[[79.8431, 6.9468], [79.8448, 6.9468], [79.8448, 6.9479], [79.8431, 6.9479], [79.8431, 6.9468]]]
      },
      "notes": null,
      "createdAt": "2025-06-02T10:00:00.000Z"
    },
    {
      "id": "4e2d9a77-8b0c-41f5-a3d4-0f7c1b2e9a35",
      "name": "Kandy depot",
      "code": null,
      "kind": "depot",
      "typeName": null,
      "shape": "circle",
      "center": { "latitude": 7.290572, "longitude": 80.633728 },
      "radius": 250,
      "geometry": null,
      "notes": "Gate closes 22:00",
      "createdAt": "2025-06-02T10:05:00.000Z"
    }
  ],
  "meta": { "limit": 100, "hasMore": false, "nextCursor": null }
}

Field	Description
shape	circle or polygon.
center	Circle centre, or polygon centre point.
radius	Circle radius in metres. 0 for polygons.
geometry	GeoJSON Polygon ([longitude, latitude] pairs), only with geometry=true. null for circles.

List points of interest

GET /fleet/points-of-interest

Pins placed on the map: a single point with an icon and no boundary.

Name	Type	Description
search	string	Match on name or description.
limit, cursor		See Pagination.

{
  "data": [
    {
      "id": "cm1poi0003",
      "name": "Fuel station – Kadawatha",
      "description": "Company fuel card accepted",
      "icon": "fuel",
      "latitude": 7.00121,
      "longitude": 79.95302
    }
  ],
  "meta": { "limit": 100, "hasMore": false, "nextCursor": null }
}