Geofences

A geofence is an area boundary that you can define and associate with your devices. The area that the geofence encloses 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.

POI geofence (Point Of Interest) is a geofence, which is defined using radio measurements. POI geofences need to be trained separately using a telemetry that a device has recorded while being at the desired point of interest. The device is considered to be inside a trained POI geofence when the radio measurements of the device-ingested telemetry and the previously recorded geofence training data match. POI geofences should only be used indoors.

Once created, a geofence can be associated with a device. This association means that every time a position or a radio measurement update is received from the device, it will be evaluated whether the device has transitioned across the associated geofence. If such a transition has happened, a transition event will be recorded and a notification will be triggered.

Geofences are managed via the geofences endpoint.

NOTE: A geofence can also be referred to as a geozone, and these two terms are interchangeable.