Geofencing Function in the Localino System

1. Introduction

Geofencing enables the monitoring of trackers (e.g. tags) within predefined zones. An alarm is triggered when a tracker leaves a zone.

Prerequisites

• Integration: The Localino app must be correctly integrated into Eliona.

• Zone definition: Geofencing zones must be defined in Localino.

• Action-WebSocket: An Action-WebSocket must be set up in Localino.

• Action port: The Action port must be entered in the Localino database (schema localino, table config).

• Tracker assignment: The tag to be monitored must be assigned to an asset on which the automatic rule is to be created.

The most important information that must be sent via the /actionwebsocket is the id (hardwareid) of the tag and, ideally, the ts (timestamp).

Further information that could play a role in the future:

In addition to id and ts, the following information could be important in the future:

• Action Name (actionname): The name of the action that triggers the alarm.

• Group (hardwaregroup): The group or category of the device.

• Name (hardwarename): The name of the tracker or the hardware.

• Zone (zone): The defined zone that is left or entered.

• Action Trigger (trigger): The specific trigger of the action, e.g., "ZoneLeave" or "ZoneEnter".

• CrossDirection (crossdirection): Information about the direction of movement, if relevant.

This additional data could be useful for advanced notifications or future features, such as more detailed alarm messages or integration with other systems.

---

2. Geofencing Alarm Process

If everything is set up correctly, a rule is automatically created and an alarm is triggered when a ZoneLeave event occurs.

2.1 Leaving a Zone (ZoneLeave)

• A "ZoneLeave" trigger sets the geofencing_alarm attribute in the assigned asset to 1.

• An alarm message is automatically triggered:

  "{{asset.name}} is outside the allowed zone"

2.2 Entering a Zone (ZoneEnter)

• A "ZoneEnter" trigger sets the geofencing_alarm attribute to 0.

• The alarm is dismissed and a message is sent that confirms the return to the allowed zone:

  "{{asset.name}} is back inside the allowed zone"