# Geofences

Geofences are virtual boundaries you draw on the map. FleetFusion records when vehicles enter, exit, or dwell inside a geofence, and can notify the people you nominate when a transition occurs.

<figure><img src="/files/dXhOuHG0yrMxhXDCvEGf" alt=""><figcaption></figcaption></figure>

> **Permissions:** The Geofences page requires the `FleetAssistant.Geofences` policy. Administrators and Fleet Managers typically have this permission; Standard Users do not see the page unless their role has been granted access.

## What you can do

* Draw circular and polygon geofences directly on a Trimble Maps canvas.
* Define what counts as a transition (enter, exit, or both) and apply a dwell threshold.
* Restrict the geofence to specific vehicles or fleets, or apply it to all vehicles.
* Set an in-zone speed limit and trigger an event when a vehicle exceeds it.
* Configure a weekly schedule so the geofence only generates events at the times you care about.
* Nominate email recipients for entering and leaving notifications.
* Optionally request a video clip download when a transition occurs.

## Opening the Geofences page

To open the Geofences page, click **Tracking** in the sidebar and select **Geofences**, or navigate directly to `/tracking/geofences`.

The page is split into two panes:

* **Geofence list** (left) - all geofences in your organisation, with a coloured dot, the shape type (circle or polygon) and an active/inactive badge.
* **Map** (right) - shows existing geofences. The same map is used for drawing new shapes.

The toolbar above the list provides:

* A **Search** box to filter the list by name or location text.
* An **All / Active / Inactive** dropdown to filter by activation state.
* A **+ New Geofence** button.

## Geofence types and triggers

Every geofence has a **shape** and a **trigger**.

| Setting         | Options               | Notes                                                                                                                     |
| --------------- | --------------------- | ------------------------------------------------------------------------------------------------------------------------- |
| Shape           | Circle, Polygon       | Choose when you draw the boundary.                                                                                        |
| Trigger         | Enter, Exit, Both     | Controls which transitions raise events.                                                                                  |
| Dwell threshold | Seconds               | When greater than zero, an enter event is only raised after the vehicle has stayed inside the geofence for the threshold. |
| Cooldown period | Seconds (default 300) | Suppresses repeat events from the same vehicle within the window.                                                         |

> **Note:** Dwell is configured by setting the **Dwell threshold** on an enter or both trigger. There is no separate "Dwell" trigger type.

## How to create a geofence

To create a new geofence:

1. Click **Tracking** in the sidebar and select **Geofences**.
2. Click **+ New Geofence**. The list panel switches to the geofence form and the map enters draw mode.
3. Choose a shape:
   * **Circle** - click on the map to place the centre, then drag to set the radius.
   * **Polygon** - click each vertex in turn, then double-click the last point to close the shape.
4. In the form, fill in the basics:
   * **Name** - a short identifier such as "Hayes Depot" or "Customer Site - Manchester".
   * **Colour** - choose from the colour palette. The dot in the list and the shape on the map use this colour.
   * **Active** - leave enabled to start raising events immediately.
5. Configure the trigger:
   * **Trigger** - select **Enter**, **Exit**, or **Both**.
   * **Dwell threshold** - enter a number of seconds if you only want events after a sustained presence.
   * **Cooldown period** - the minimum gap between repeated events from the same vehicle.
6. (Optional) Enable **Speed limit** and enter a speed in your tenant's display unit (mph or km/h). Vehicles inside the geofence travelling above this limit raise a speed-limit event.
7. (Optional) Enable **Download video on transition** to automatically request a clip from connected dashcams when an event fires.
8. Choose who the geofence applies to:
   * Leave **All vehicles** enabled to apply to every tracked vehicle, or
   * Disable it and add specific vehicles or fleets using the lookup boxes.
9. (Optional) Add a **Schedule**. By default a geofence is active 09:00-17:00 Monday-Sunday; click **Add period** for additional time bands (up to five).
10. Add **Notification recipients**:
    * **Entering** - users or email addresses that receive an alert when a vehicle enters.
    * **Leaving** - users or email addresses that receive an alert when a vehicle exits.
11. Click **Save**.

The new geofence appears on the map with the colour you chose and is added to the list.

> **Tip:** Use polygons for site boundaries that follow real walls or roads, and circles for radius-based areas such as "within 500 m of a customer".

## Editing and deleting

To edit a geofence, click the pencil icon on its row, or click the row to centre the map on it and then click **Edit**. Changes to the shape are made directly on the map.

To delete a geofence, click the trash icon on its row and confirm. Deleting a geofence stops further events being raised, but does not remove historical events from reports.

## How geofence events feed the rest of FleetFusion

* Map overlays - when **Geofences** is enabled in the [Tracking](/documentation/fleet-operations/tracking.md) toolbar, every active geofence is drawn on the map.
* Notifications - if the geofence has recipients configured, an alert is sent on each transition. The alert appears in the [Notifications dashboard](/documentation/fleet-operations/notifications.md).
* Video clips - if **Download video on transition** is enabled, a media-download alert appears in the dashboard when the clip is ready.

## Related articles

* [Tracking](/documentation/fleet-operations/tracking.md)
* [Tracking modes](/documentation/fleet-operations/tracking/tracking-modes.md)
* [Points of interest](/documentation/fleet-operations/tracking/poi.md)
* [Notifications](/documentation/fleet-operations/notifications.md)
* [Video events](/documentation/fleet-operations/tracking/video-events.md)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.fleetfusion.ai/documentation/fleet-operations/tracking/geofences.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.