Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Geofences are geographical zones used to track device movement. The platform generates an event when BikeTrax enters or exits these zones.

1. Creation

  • Select Settings

  • Select Geofences

Image Modified
  • Select (plus)

  • Name the new geofence

  • Click Area

Image Modified
  • Select area geometry, e.g. Circle

Image Modified
  • Click on the map and create the area

  • Close window → select (tick)

Image Modified
  • Close window → select (tick)

Image Modified
  • Close window → select (error)

Image Modified
Info

You can create multiple geofences and assign it to multiple trackers.

2. Assignment

In order to trigger an event (get an alarm) when a the geofence is entered or exited, you have to assign the BikeTrax to the geofence:

  • Select the tracker

  • Open tracker settings menu

  • Select Geofences

Image Modified
  • Select the geofence you want assign

  • Close window → select (error)

Image Modified
Info

You will receive a push message via the app when a tracker enters / exits a geofence

...

The distance around a polyline geofence where BikeTrax is considered "inside the geofence" is set to 25 meters.

Get Inside/Outside Status

The geofenceIds array in the device object contains the IDs of the geofences the BikeTrax is surrounded currently. In this example its part of the geofence with ID 143103:

Code Block
languagejson
{
    "id": 231560,
    "attributes": {
        "B2B": true,
        "guarded": false,
        "alarm": false,
        "lastAlarm": 1662564152394,
        "guardType": "movement",
        "fwVersion": "LK_CAR_TQ2020/10/14 11:12"
    },
    "groupId": 0,
    "name": "t49 - staging",
    "uniqueId": "4710250149",
    "status": "offline",
    "lastUpdate": "2023-03-24T16:12:51.000+00:00",
    "positionId": 2167102178,
    "geofenceIds": [143103],
    "phone": "",
    "model": "",
    "contact": "",
    "category": null,
    "disabled": false
}

Permissions

The geofences relationships with other objects is very flexible:

...

If a user has access to a geofence, it means that the user can edit/remove the geofence and can subscribe to the geofence events.

Calendars

Calendars can be linked to geofences. This will limit events generation to the calendar schedule.

...