HERE Geofences API

The Geofences service creates and manages geofences. A geofence is an area boundary that users can define and associate with their devices. The area that the geofence encloses can be defined using geographic coordinates or radio measurements. Geographic geofences can be `circular` or `polygonal`. A circular geofence is defined by geographic coordinates of its center and a radius, while polygonal geofences are defined as a set of geographic coordinates. `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. Once created, a geofence can be associated to a device. Every time a position or a radio measurement update is received from a device, HERE Tracking would evaluate whether the device has transitioned across the boundary of an associated geofence. If such a transition has happened, a transition event will be recorded. For the geographic geofences, the evaluation is based on the coordinates of the trace. For POI geofences, the device is considered to be inside a trained POI geofence when the radio measurements of the device-ingested telemetry and the training data match. Indoor geofences can be created by adding the floor properties to the geofence definition. Circular and polygonal geofences can be both outdoors and indoors. POI geofences should only be used indoors. For indoor geofences a device transition is recorded only if the position of the device is indoors and the floor details of the position match the geofence floor definition. NOTE: A geofence can also be referred to as a geozone, and these two terms are interchangeable.