Skip to main content

Geofences

Geofences allow you to define a specific are on a map where you want to be notified when a vehicle enters or exits. The way this works is that you visually define an area in the geofence editor, which can be either a polygon shape, or a point with a radius.

This geofence is then syncronized to the device, and the device will then behave in the following ways.

The events are triggered in two different ways.

  1. When the device wakes up, it will report the state of the geofences, which geofences it is inside, and which geofences it is outside. vehicle/geofence/GEOFENCE_NAME/inside|outside
  1. Whenever a new position is logged, it will check the defined geofences, and if the state of a geofence has changed, ie. you have either exited or entered a geofence, and the next 2 positions (3 total), are the same state, then the device will trigger an event vehicle/geofence/GEOFENCE_NAME/enter or vehicle/geofence/GEOFENCE_NAME/exit

This events are triggered on the device, and then uploaded to the cloud. This means that you are able to both create triggers in the cloud, but also configure reactors directly on the device that can react to this event, like playing a sound, sending a HTTP request or maybe publish a message on a MQTT broker.

note

Click here to see the guide about how triggers work.