Geofences

This guide is applicable to the following device / devices:

Mini

TMU CM4

CAN-FD Pro

CAN-FD Pro +IP67 casing

---

In the second subsection on the Vehicle Tab, you will find Geofences. This feature allows you to create and manage geofences, which define specific boundaries on a map to mark areas of interest and receive notifications about events within those boundaries. For example, you can get notification when a vehicle enters or exits a designated geofence.
Click on the Geofences tab to see the world map under which is a list of any geofences that have been created.

How to Create a Fleet Geofence

1. Click Create to start creating a geofence. Under the headline Create Geofence you’ll see three columns – Details, Groups, Vehicles.
   We’ll start with Details; add a name for the geofence for an easy internal identification. Add a description for more information about the geofence. Choose a color for the geofence to be shown on the map.

2. Configure Notifications:

   • In the Default Notification section, specify who will receive notifications. Ensure you have created notification channels (learn how here).
   • Choose a channel to receive notifications when vehicles enter and/or exit the geofence. You can select multiple notification channels.

3. Draw the Geofence:

   • On the map, zoom in on the area where you want to set boundaries.
   • Use the tools on the left side to create the geofence. Select either a circle or polygon tool to draw boundaries.
   • Additional tools include options to edit, drag, remove or rotate layers.

4. Add Vehicle groups to the Geofence:

   • In the second column under Create Geofence you can add vehicle groups to the geofence.
   • If you have created a vehicle group (more info here), you can apply the geofence to the desired group of vehicles. Find the group in the list or search for it using the filtering option.
   • View group details including name, number of vehicles, notification channels, and default notifications. You can edit the Notification channels here.
   • Choose a Group by check-marking one or multiple groups to enable Actions in top right corner. From here you can bulk edit notifications, reset selected notification channels, enable or disable all selected groups.
   • You can save time editing chosen groups using Actions, just make sure to check-mark the groups to access Actions, see image below.
   • Enabling desired groups means all the vehicles in the vehicle Groups will be under this geofence.
   • When you are making changes to the Groups or Vehicles you might see an orange dot at the top on enabling icon as well as orange letter circle icon letting you know that the changes have not been saved.
   • For filtering on ‘All’, “Enabled’, and ‘Disabled’ you’ll have to save changes first.

5. Add Individual Vehicles to the Geofence:

   • If you want to add vehicles individually, or you have not created Vehicle groups, we can go to the third column under the headline - Vehicles. Here you will find a list of all your vehicles, with their name and VIN.
   • Search for the vehicle. Enable the vehicles you want to include in the geofence.
   • If you want to see if you are choosing the correct vehicle to enable, you can click on the icon next to the vehicle name and a new window will open up where you can double check without interrupting the process.

6. Save the Geofence:

   • Once satisfied, click Create. You can always add more vehicles or change details later.
   • A notification will confirm that the geofence was successfully created.

---

How Fleet Geofences Work

Once a geofence is created and vehicles are assigned, the AutoPi Cloud monitors vehicle positions and triggers events based on geofence state changes.

Event Types

Enter / Exit Events When a new position is logged, the device checks whether the geofence state has changed. If 3 consecutive positions confirm the change, one of the following events is triggered:

• vehicle/geofence/GEOFENCE_NAME/enter
• vehicle/geofence/GEOFENCE_NAME/exit

These events are sent to the AutoPi Cloud, where they can be used for monitoring, notifications, and automation.

---

Use Fleet Geofences with Templates

You can combine fleet geofences with Templates to ensure that every new device added to a template automatically has the geofence applied, no manual setup required.

How It Works

When a fleet geofence is configured and a template is assigned to a device, the geofence rules are applied to that device as part of the template. Any new device subsequently assigned to the template will have the fleet geofence applied automatically.

This makes fleet geofences ideal for scaling across large fleets, where consistent geofence coverage is needed without repeating configuration for each individual device.

---

Use Fleet Geofences with Triggers

Geofence events can be used to automate actions through Triggers. A trigger listens for a specific geofence event and performs a defined action in response.

Example Use Cases

• Send an email notification when a vehicle enters a restricted area.
• Fire a webhook when a vehicle exits a designated delivery zone.
• Send an alert on the AutoPi Cloud when a vehicle crosses a geofence boundary.

How to Set Up a Trigger

1. Navigate to Device → Events to confirm that geofence events are being received.
2. Go to Triggers and click Create.
3. Set the event condition to match one of the following:
   • vehicle/geofence/*/enter — triggers on entry into any geofence.
   • vehicle/geofence/*/exit — triggers on exit from any geofence.
   • Or use a specific geofence name instead of * to target a particular geofence.
4. Define the action to perform when the event occurs (e.g., send email, send alert, call webhook).
5. Save the trigger.

Possible Actions

• Send email notifications.
• Trigger webhook requests.
• Send an alert on AutoPi Cloud.