# Geo-areas

## Introduction

A geographical area is defined as a geographic zone delineated by a GeoJSON. The detection of device entry or exit at a specific location can be facilitated through the utilisation of these areas. Furthermore, automation rules can be devised to generate alerts when a device enters or exits a designated area.

## Comprehensive API actions

### Creating an area

An area can be created based on the methodology by which the geographic zone is determined: either by a GeoJSON or a group of devices. Subsequently, the option to retrieve information from both (GeoJSON and device group) is provided. Further details can be found in the section on _creating an area specification_.

### Updating an area

It is permissible to modify all of the fields, with the exception of the identifier.

### Searching areas

The OpenGate API query enables the retrieval of various platform areas, contingent on the user's visualization capacity for their respective organization.

## API specification

{{< openapi src="areas.yaml" >}}