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

1. Creation

Legacy Webapp	Modern Webapp (Option #1)
Select Settings Select Geofences	Select Settings Select Geofences
Select Name the new geofence Click Area	Select line to draw a polyline or square icon to create a polygon Create your geofence by clicking on the map Double-click when finished
Select area geometry, e.g. Circle	Name the new geofence Optionally, add attributes or extra Click Save
	Modern Webapp (Option #2)
Click on the map and create the area Close window → select	From main page select a device and click ...
Close window → select	Select Create Geofence
Close window → select	Name the new geofence Optionally, add attributes or extra Click Save

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	Select Settings Select Devices
Select the geofence you want assign Close window → select	Locate the device you want to assign to a geofence Click the chain icon (Connections)
	Click the geofence to assign, or search for it by name

Geometry

There are up to three supported geometry types, depending on the webapp you use:

Circle (Legacy only)

Polygon (Both webapps)

Polyline (Both webapps)

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:

{
    "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:

• Linked to a device: server will monitor device entering and exiting that geofence.

• Linked to a group: server will monitor all devices in that group entering and exiting the geofence.

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.

Tips and Tricks

Color of a geofence on the map can be set in the geofence attribute color. Any valid HTML colors are accepted.

If you need to control the BikeTrax movement along a pre-defined route, you can use a polyline geofence. Also, if you need to control when BikeTrax started and ended the route, you can add additional geofences at the source and at the destination.