GuidesAPI Reference
Guides

Creating and editing geofences

📘

Note

A geofence is sometimes called a geozone. These two terms are interchangeable.

A geofence is an area boundary that you can define and associate with your devices. The area enclosed by the geofence can be defined using geographic coordinates or radio measurements.

Geographic geofences can be either circular or polygonal. A circular geofence is defined by geographic coordinates of its center and a radius, while a polygonal geofence is defined as a set of geographic coordinates.

Circular and polygonal geofences can be both outdoors and indoors. Indoor geofences can be created by adding the floor properties to the geofence definition.

A POI geofence (Point Of Interest) is a geofence defined using radio measurements. POI geofences must be trained separately using a telemetry that a device has recorded while at the desired point of interest. The device is considered to be inside a trained POI geofence when there's a match between the radio measurements of the device-ingested telemetry and the previously recorded geofence training data.

📘

Note

POI geofences should only be used indoors.

After creation, a geofence can be associated with a device. With an association in place, a device that crosses a geofence will return a position a position or radio measurement update. This action is recorded as a geofence transition event.

Use the geofences endpoint to manage geofences.