# GeoFence

A *GeoFence* is a virtual fence that defines an areas that a vehicle can leave (inclusions) or enter (exclusions). *Auterion Mission Control* enables the creation of complex *GeoFence* boundaries made up of multiple circular and polygonal regions.

{% hint style="success" %}
GeoFences can be used to prevent a vehicle flying out of range of the RC controller, or into unsafe or restricted airspace. They are respected in all modes, including missions and manual flight.
{% endhint %}

{% hint style="info" %}
Fences defined in a plan are different/seperate to the simple cylindrical geofence defined in the [Geofence Failsafe](https://docs.auterion.com/settings-and-maintenance/safety#geofence-failsafe).
{% endhint %}

![](https://3329189600-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FFW1Ge1p1f6WHyiYCb146%2Fuploads%2Fgit-blob-26eed959c709057a60d753b25255f76a551d2947%2FScreenshot%202023-10-08%20at%2021.04.00.png?alt=media)

The action triggered when the flight controller detects an impending geofence breach is defined in the [Geofence Failsafe](https://docs.auterion.com/settings-and-maintenance/safety#geofence-failsafe) settings.

## Creating a GeoFence

Users should create an inclusion geofence around the desired mission path (the mission is displayed semi-transparent when editing fences) and exclusion fences around any areas that the vehicle must not travel.

**To create a new GeoFence:**

1. Navigate to the *Plan View*.
2. Select the **Extras** button in the **Mission editor** to display the *GeoFence Editor*.

   <figure><img src="https://3329189600-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FFW1Ge1p1f6WHyiYCb146%2Fuploads%2Fgit-blob-7120409c036d9863eae3585d1d9ee7ee404ff1e4%2FScreenshot%202023-10-08%20at%2021.06.08.png?alt=media" alt="" width="297"><figcaption></figcaption></figure>
3. Insert a *Circular GeoFence* by pressing the **Circular Fence** button.\
   \
   A round fence will be added to the map, along with an entry in the *Circular Fences* list below the buttons.

   * Move the fence by dragging the central marker on the map.
   * Resize the fence by dragging the marker on the circumference (or set the radius value in the *GeoFence Editor*).

   <figure><img src="https://3329189600-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FFW1Ge1p1f6WHyiYCb146%2Fuploads%2Fgit-blob-70c95a7899c3ee9834789fa14b46de96c17043a0%2FScreenshot%202023-10-08%20at%2021.07.08.png?alt=media" alt=""><figcaption></figcaption></figure>
4. Insert a *Polygonal GeoFence* by pressing the **Polygon Fence** button.\
   \
   A square region will be added to the map, along with an entry in the *Polygon Fences* list below the buttons. A *Polygon Tools* overlay is added to the map that can be used to set/reset the geofence and change the way that it is defined.

   <figure><img src="https://3329189600-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FFW1Ge1p1f6WHyiYCb146%2Fuploads%2Fgit-blob-b4c4a70514e15ca5e3ea2fdb4200bf44b18b9c8d%2FScreenshot%202023-10-08%20at%2021.08.05.png?alt=media" alt=""><figcaption></figcaption></figure>

**Notes:**

* Move the fence by dragging the central marker on the map.
* Move the corners by dragging the vertices (filled circles).
* Create new vertices by clicking the "unfilled" dots on the lines between the filled vertices.
* Delete vertices by selecting them and choosing the *Remove vertix* option.

1. New regions are created as *inclusion zones* (vehicles must stay within the region). They can be changed to *exclusion zones* (where the vehicle can't travel) by *un-checking* the associated **Inclusion** checkbox in the fence panel.

   <figure><img src="https://3329189600-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FFW1Ge1p1f6WHyiYCb146%2Fuploads%2Fgit-blob-852e6856ff078840b56473e21c3bb48d016e05b9%2FScreenshot%202023-10-08%20at%2021.13.24.png?alt=media" alt="" width="297"><figcaption></figcaption></figure>
2. Multiple regions can be created by pressing the **plus icon.**

<figure><img src="https://3329189600-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FFW1Ge1p1f6WHyiYCb146%2Fuploads%2Fgit-blob-f1980a2a61349a29f6c447b66ea71a2f4a9429ce%2FScreenshot%202023-10-08%20at%2021.14.47.png?alt=media" alt="" width="297"><figcaption></figcaption></figure>

3. When finished, press the **Upload** button to save the fences to the vehicle.

<figure><img src="https://3329189600-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FFW1Ge1p1f6WHyiYCb146%2Fuploads%2Fgit-blob-088bb3494716cad270bf30b727c53b7d19cf2a5b%2FScreenshot%202023-10-08%20at%2021.15.49.png?alt=media" alt="" width="297"><figcaption></figcaption></figure>

## Edit/Delete GeoFence

To edit a fence, select the fence you want to edit.

<figure><img src="https://3329189600-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FFW1Ge1p1f6WHyiYCb146%2Fuploads%2Fgit-blob-f1980a2a61349a29f6c447b66ea71a2f4a9429ce%2FScreenshot%202023-10-08%20at%2021.14.47.png?alt=media" alt="" width="297"><figcaption></figcaption></figure>

The fence is then highlighted on the map and can be modified as described in the previous section.

To delete a fence, select the associated **Delete** button in the *GeoFence Editor*.

## GeoFence UI Overview

### Upload Button

![](https://3329189600-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FFW1Ge1p1f6WHyiYCb146%2Fuploads%2Fgit-blob-088bb3494716cad270bf30b727c53b7d19cf2a5b%2FScreenshot%202023-10-08%20at%2021.15.49.png?alt=media)

GeoFence definitions are saved to the vehicle using the [**Upload** ](https://docs.auterion.com/vehicle-operation/auterion-mission-control/ui-breakdown/plan-ui-overview#upload-button)button, along with any mission and rally point plans.

### GeoFence Plan Tools

![](https://3329189600-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FFW1Ge1p1f6WHyiYCb146%2Fuploads%2Fgit-blob-e73f8545e666b3bb320da3a83a9b68bda0fd233e%2FScreenshot%202023-10-08%20at%2021.19.58.png?alt=media)

The tools that are displayed when planning a *geofence* are listed below (for information about all tools see [Plan UI Overview](https://docs.auterion.com/vehicle-operation/auterion-mission-control/ui-breakdown/plan-ui-overview#plan-tools)).

| Icon                                                                                                                                                                                                                                   | **Name**                                                                                                                            | Description                                                                                                                 |
| -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------- |
| ![](https://3329189600-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FFW1Ge1p1f6WHyiYCb146%2Fuploads%2Fgit-blob-4b8b519f051008fae7548bceaec2ae892c9f713f%2FScreenshot%202023-10-08%20at%2021.02.10.png?alt=media) | [**File/Sync**](https://docs.auterion.com/vehicle-operation/auterion-mission-control/ui-breakdown/plan-ui-overview#file-sync-tools) | File operations (create, save or load plan) and sync operations (upload/download plan from vehicle, clear plan on vehicle). |
| ![](https://3329189600-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FFW1Ge1p1f6WHyiYCb146%2Fuploads%2Fgit-blob-7b92b8e1e0428ddbef0c6c355f1736dfa41977d7%2FScreenshot%202023-10-08%20at%2021.03.21.png?alt=media) | [**Center**](https://docs.auterion.com/vehicle-operation/auterion-mission-control/ui-breakdown/plan-ui-overview#map-tools)          | Center map on mission, home, vehicle, all items, or specified location.                                                     |
| ![](https://3329189600-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FFW1Ge1p1f6WHyiYCb146%2Fuploads%2Fgit-blob-27cc6ac19f474ebd614966843145bb8663ef9c3c%2FScreenshot%202023-10-08%20at%2021.02.44.png?alt=media) | **Rally Point**                                                                                                                     | Provides alternative landing points when performing Return To Launch                                                        |

### GeoFence Editor

![](https://3329189600-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FFW1Ge1p1f6WHyiYCb146%2Fuploads%2Fgit-blob-f62b24273184cd45e1e46820e47dbd2bd0358602%2FScreenshot%202023-10-08%20at%2021.21.08.png?alt=media)

The **Polygon Fence** and **Circular Fence** buttons are used to add a fence of the respective type to the map. The entries in the *Polygon Fences* or *Circular Fences* panels are used to select which fence is currently being edited on the map, to delete the fence, and to set the fence as an inclusion/exclusion zone.

| Name                               | Description                                                                                                                                |
| ---------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------ |
| **Polygon Fence**                  | Add a polygon fence to the map and an entry to the *Polygon Fences* section.                                                               |
| **Circular Fence**                 | Add a circular fence to the map and an entry to the *Circular Fences* section.                                                             |
| **Inclusion**                      | Set this fence as an inclusion (vehicle must move within the fence). Uncheck if vehicle must fly outside the region enclosed by the fence. |
| **Edit**                           | Set this fence as current fence (for editing on map).                                                                                      |
| **Radius**                         | Set radius for this fence (circular fence only).                                                                                           |
| **Del**                            | Delete this fence.                                                                                                                         |
| **Add/Remove Breach Return Point** | Add or remove breach return point. The breach return point should be used as return destination instead of the home location.              |
| **Altitude**                       | Breach return point altitude, if a point has been defined.                                                                                 |
