Geofencing-Funktion im Localino-System

1. Einleitung

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 BuildingPro Suites integriert werden.

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

• Action-WebSocket: In Localino muss ein Action-WebSocket eingerichtet werden.

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

• Tracker-Zuweisung: Der zu überwachende Tag muss einem Asset zugewiesen werden, auf dem die automatische Regel erstellt werden soll.

Die wichtigste Information, die über das /actionwebsocket gesendet werden muss, ist die id (hardwareid) des Tags und idealerweise das ts (timestamp).

Weitere Informationen, die in Zukunft eine Rolle spielen könnten:

Zusätzlich zu id als auch ts, könnten die folgenden Informationen in Zukunft wichtig sein:

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

• Gruppe (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.

• Aktionsauslöser (trigger): Der konkrete Auslöser der Aktion, z. B. "ZoneLeave" oder "ZoneEnter".

• CrossDirection (crossdirection): Informationen über die Bewegungsrichtung, falls relevant.

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

---

2. Geofencing-Alarmprozess

Wenn alles korrekt eingerichtet ist, wird automatisch eine Regel erstellt und ein Alarm ausgelöst, wenn ein ZoneLeave-Ereignis auftritt.

2.1 Verlassen einer Zone (ZoneLeave)

• Ein "ZoneLeave" -Auslöser setzt das geofencing_alarm -Attribut im zugewiesenen 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" -Auslöser setzt das geofencing_alarm Attribut auf 0.

• Der Alarm wird zurückgesetzt und es wird eine Nachricht gesendet, die die Rückkehr in die erlaubte Zone bestätigt:

  "{{asset.name}} befindet sich wieder innerhalb der erlaubten Zone"