Geofencing-Funktion im Localino-System

1. Einführung

Geofencing ermöglicht die Überwachung von Trackern (z.B. Tags) innerhalb vordefinierter Zonen. Ein Alarm wird ausgelöst, wenn ein Tracker eine Zone verlässt.

Voraussetzungen

• Integration: Die Localino-App muss korrekt in Eliona integriert sein.

• Zonendefinition: Geofencing-Zonen müssen in Localino definiert sein.

• Action-WebSocket: Ein Action-WebSocket muss in Localino eingerichtet sein.

• Action-Port: Der Action-Port muss in der Localino-Datenbank (Schema localino, Tabelle config) eingetragen sein.

• Tracker-Zuordnung: Der zu überwachende Tag muss einem Asset zugeordnet sein, auf dem die automatischs Regel erstellt werden soll.

Die wichtigste Information, die über den /actionwebsocket gesendet werden muss, ist die id (hardwareid) des Tags sowie idealerweise der ts (Zeitstempel ).

Weitere Informationen, die zukünftig eine Rolle spielen könnten:

Zusätzlich zu id und ts könnten folgende Informationen in der Zukunft wichtig sein:

• Action Name (actionname): Der Name der Aktion, die den Alarm auslöst.

• Group (hardwaregroup): Die Gruppe oder Kategorie des Geräts.

• Name (hardwarename): Der Name des Trackers oder der Hardware.

• Zone (zone): Die definierte Zone, die verlassen oder betreten wird.

• Action Trigger (trigger): Der spezifische Auslöser der Aktion, z.B. "ZoneLeave" oder "ZoneEnter".

• CrossDirection (crossdirection): Informationen zur Bewegungsrichtung, falls relevant.

Diese zusätzlichen Daten könnten für erweiterte Benachrichtigungen oder zukünftige Features nützlich sein, wie z.B. detailliertere Alarmmeldungen oder die Integration mit weiteren Systemen.

---

2. Geofencing-Alarmprozess

Ist alles korrekt eingerichtet, wird bei einem ZoneLeave-Ereignis automatisch eine Regel erstellt, und ein Alarm wird ausgelöst.

2.1 Verlassen einer Zone (ZoneLeave)

• Ein "ZoneLeave"-Trigger setzt das Attribut geofencing_alarm im zugeordneten Asset auf 1.

• Eine Alarmmeldung wird automatisch ausgelöst:

  "{{asset.name}} befindet sich außerhalb der erlaubten Zone"

2.2 Betreten einer Zone (ZoneEnter)

• Ein "ZoneEnter"-Trigger setzt das Attribut geofencing_alarm auf 0.

• Der Alarm geht eine Nachricht wird gesendet, die das Zurückkehren in die erlaubte Zone bestätigt:

  "{{asset.name}} ist wieder innerhalb der erlaubten Zone"