---
title: "Configuration – Geofencing"
description: "Geofencing auto-detects vehicle arrivals/departures via virtual boundaries, improving ETA accuracy, stop updates and reducing manual input."
url: https://help.qargo.com/us/articles/386541-configuration-geofencing
locale: us
updated: 2026-11-03
---

# Configuration – Geofencing

:::callout{tone="info"}
**🎥 Click below to watch the video on geofencing.**
:::

[![](https://help.qargo.com/media/a07051ca6a4d-image.png)](https://rousing-seal.clueso.site/share/5166846c-353c-4b7b-88a6-62e265f5d1fb)

## What is geofencing? {#h_e7f7ca60a0}

Geofencing is a feature that automatically detects when vehicles enter or exit defined geographical areas around locations.⁠⁠ It creates virtual boundaries (typically circular areas with a customizable radius) around stop locations. These boundaries provide more accurate arrival and departure timestamps without relying solely on driver input.

## Benefits of geofencing {#h_fade38e418}

-   More reliable stop updates
-   Improved accuracy of stop arrival and departure through autocomplete
-   Improved ETA calculations
-   Fewer manual updates
-   Fewer calls between driver and office to report arrivals

## How does Qargo use geofencing? {#h_a96086b7b0}

-   Geofences trigger "Arrived at location" and "Departed at location".
-   Geofences are defined by a circle radius around the location.

    -   This is defined on the tenant and on the location.
-   The stop is completed when the geofence associated with the location is triggered.
-   Once the stop is completed (green), Qargo logs the events and records the times.

:::callout{tone="note"}
‼️ Autocompleting stops requires a telematics system.
:::

## Configuration {#h_2bf60916f0}

At the tenant level, the following values can be configured for geofencing:

-   **Enable geofencing for resources**: defines which types of resources have geofencing enabled or disabled.
-   **Update stop times based on geofence:** automatically completes the stop once the enabled resource triggers the geofence radius.
-   **Default geofence location radius (meter)**: defines the default size of the geofencing area. This can also be overridden at the location level.

![](https://help.qargo.com/media/32297c0f6bfa-image.png)

-   Locations: a radius can be defined that overrides the radius defined at the tenant level.

    ![](https://help.qargo.com/media/918d282537bc-image.png)


-   Click the **Customize** button to enable the column in the **Stops view**.

    ![](https://help.qargo.com/media/25398eb3ba7a-image.png)


View geofence times in the **Stops view**.

![](https://help.qargo.com/media/dc552cf49e1e-image.png)

## Autocompleting stops {#h_c00f0b93e0}

-   The load must be fully dispatched to the driver.

    ![](https://help.qargo.com/media/f6a1faa7a2e9-image.png)

-   Arrival and departure at stops are completed automatically based on geofenced areas.
-   The driver mobile app is only supported when used together with a telematics system.
-   The previous stop must be completed before the stop can be autocompleted.

    -   If the previous stop was not successfully completed, geofence times are still captured, but the stop is not completed.
-   If autocomplete geofencing is used to depart from a stop, the stop is marked as completed.

    -   In the driver mobile app, the question path is not shown to the driver automatically.
    -   The driver can still update the information for the completed stop.

![](https://help.qargo.com/media/c46d8fd94c4a-image.png)

### Arrival at stop {#h_c25baaf29b}

-   When the driver enters the geofence area, arrival is completed automatically.

    -   In the driver mobile app, the **Arrive** step of the stop is completed.
    -   The date and time stamp for arrival is logged.
    -   If no arrival is detected by the geofence, the driver must arrive manually to complete the task.

### Departure from stop {#h_6fec00da90}

-   Departure from the stop is completed when the vehicle leaves the location and passes through the geofence.

    -   In the driver mobile app, the driver typically completes the **Depart** step already. In that case, the geofence is kept as a backup.

::video{src="/media/video/5ba2001400a4-2025-08-19_17-32-54-1-.mp4"}

## Polygon geofences: follow the outline of a site {#h_8e0e676fcc}

As mentioned above, geofencing records when a vehicle arrives at and leaves a stop, and it can complete the stop automatically. By default, the geofence is a circle around the stop's location.

On large or irregular sites, such as a port terminal, a circle also covers nearby roads and neighboring sites. Passing traffic can then complete a stop, or complete it at the wrong site. A polygon geofence follows the outline of the site instead.

Each location has one geofence: a single closed shape, with no holes and no separate areas. If customers share a location, they also share its geofence.

:::callout{tone="note"}
‼️ Outlines are not sent to Samsara. A dispatched route still gives Samsara a fixed 150 m circle.
:::

### Polygon geofence: draw, change or remove {#h_c835c4c564}

1.  Open the location under **Locations > Locations**.
2.  Locate the **Geofencing** section.
3.  Select **Polygon** in the **Geofence shape** field. **Trigger radius (meter)** is grayed out.
4.  Click the map to place each corner of the outline, then double-click to finish. The outline turns red and the **Adjust geofence** button appears above the map. Geofences of neighboring locations are not shown while drawing.
5.  Save the location.

![](https://help.qargo.com/media/cdd394d360d3-Screenshot-2026-10-28-at-11_37_57.png)

:::callout{tone="info"}
📚 The outline is saved together with the location. It needs: 3 to 40 corners, edges that do not cross or touch, and the location pin inside it. If a check fails, a message names the problem and the saved outline stays as it was.
:::

To change the outline, click **Adjust geofence** and draw it again, because corners cannot be dragged. To keep the saved outline, click **Cancel**.

![](https://help.qargo.com/media/648eaf0eccd6-Screenshot-2026-10-28-at-13_07_45.png)

After saving, the route map in **Load detail** and **Order detail** shows the polygon geofence (the red outline) around every stop at this location.

![](https://help.qargo.com/media/00bf3f111ecb-Screenshot-2026-10-28-at-14_52_32.png)

To go back to a circle, select **Circle**, enter a radius in **Trigger radius (meter)** and save. To reset, clear the **Geofence shape** field with its x and save.

![](https://help.qargo.com/media/c4eeb70c01a4-Screenshot-2026-10-28-at-14_54_03.png)

### Location import: geofence columns {#h_f921f8b270}

The location import file has two optional geofence columns. Fill in one of them per location to set a circle or an outline.

:::callout{tone="note"}
💬 Import data is only visible to Qargo admins. Contact the onboarding manager or account manager to import the file.
:::

| **Column** | **What to enter** |
| --- | --- |
| geofence\_radius\_meters | Radius of the circle around the location, in meters. |
| geofence\_polygon | Outline of the site, written as POLYGON((longitude latitude, longitude latitude, ...)). |

Example of a geofence\_polygon value:\
POLYGON((4.4800 51.0250, 4.4860 51.0250, 4.4860 51.0262, 4.4830 51.0262, 4.4830 51.0280, 4.4800 51.0280, 4.4800 51.0250))

![](https://help.qargo.com/media/b979ea2bc95d-Screenshot-2026-10-29-at-10_43_18.png)

### Import rules: what to know {#h_cc06599800}

-   **Closed outline:** repeat the first corner at the end. The closing corner does not count toward the maximum of 40 corners.
-   **Checks:** the import applies the same checks as the location screen. The outline needs 3 to 40 corners, edges that do not cross or touch, and the location pin inside.
-   **One outline:** a location has one outline, with no holes and no second area.
-   **One shape per row:** a row with both columns filled fails with an error on that row.
-   **Empty cells:** an empty cell leaves the saved geofence unchanged.
-   **Changing shape:** a filled cell switches the location to that shape. The saved shape of the other kind stays stored. A radius on a location with an outline makes it a circle. Switching back to **Polygon** restores the outline.
-   **Export:** the export writes the same values under translated column labels, for the active shape only. An exported file cannot be imported back unchanged.

## Limitations {#h_9265061421}

:::callout{tone="warning"}
‼️ Geofence detection based only on tracking data from the driver mobile app is not supported.
:::

-   Autocomplete only works if the previous stops were successfully completed.

    -   If the previous stop was not successfully completed, the geofencing times are still captured, but the arrival/departure is not autocompleted.
-   If autocomplete geofencing is used for departing from a stop, the stop is marked as completed.

    -   In the driver mobile app, question paths are not shown to the driver.
    -   The driver can manually go back to the completed stop to fill in the question paths.


## Related articles

- [Planning — Stop arrival and departure events — What, why & how.](https://help.qargo.com/us/articles/838853-planning-stop-arrival-and-departure-events-what-why-how.md)
- [Planning – ETA calculations in Qargo: what, why, and how](https://help.qargo.com/us/articles/664264-planning-eta-calculations-in-qargo-what-why-and-how.md)
- [Integrations – Samsara](https://help.qargo.com/us/articles/347762-integrations-samsara.md)
- [Planning: map features and functions](https://help.qargo.com/us/articles/310006-planning-map-features-and-functions.md)
- [Intermodal - Intermodal planning](https://help.qargo.com/us/articles/133848-intermodal-intermodal-planning.md)
