Dokumentation
Geofency
Benötigt: IP-Symcon >= 4.2
Das Modul dient zum empfangen von Geofency Daten.
Funktionsumfang
- Pro Gerät eine eigene Standortliste
- Benutzername und Passwort Identifikation innerhalb von IP-Symcon.
- Richtet automatisch den Webhook "/hook/geofency" ein.
- Es wird empfohlen dies in Kombination mit dem Connect Modul zu nutzen.
- Optional kann der aktuelle Standort von Geofency übermittelt werden
Voraussetzungen
- Geofency App für Apple iOS
Software-Installation
Über den Module Store das Modul Geofency installieren.
Geofency Konfiguration
In der Geofency App mit + einen neuen Standort hinzufügen. Dann auf die 3 Punkte rechts klicken um das Menü zu öffnen. Hier ist Webhook auszuwählen.
Event
Als URL wird jeweils die Domain eingetragen unter der IP-Symcon zu erreichen ist gefolgt von /hook/geofency Am einfachtsen ist es dort die IP-Symcon Connect Adresse einzutragen gefolgt von /hook/geofency
Optional kann Aktuelle Position senden aktiviert werden.
POST Format
Einstellung bleibt auf Default, JSON-enkodiert ist deaktiv und wird nicht ausgewählt
Authentifizierung
Name | HTTP Basic Authentifizierung |
---|---|
Username | Der Webhook Benutzername der dann in IP-Symcon hinterlegt wird |
Passwort | Das Webhook Passwort das dann in IP-Symcon hinterlegt wird |
Einrichten der Instanzen in IP-Symcon
- Unter "Instanz hinzufügen" kann das 'Geofency'-Modul mithilfe des Schnellfilters gefunden werden.
- Weitere Informationen zum Hinzufügen von Instanzen in der Dokumentation der Instanzen
Konfigurationsseite:
Name | Beschreibung |
---|---|
Benutzername | Benutzername, welcher in der Geofency App angegeben werden muss, um IP-Symcon Daten schicken zu können. |
Passwort | Passwort, welches in der Geofency App angeben werden muss. |
Werden diese Daten Leer gelassen kann jeder über den Hook Daten an IP-Symcon schicken.
Statusvariablen
Die Statusvariablen/Kategorien werden automatisch angelegt. Das Löschen einzelner kann zu Fehlfunktionen führen.
Statusvariablen
Die Variablen werden anhand der Geräte ID und beim erstmaligen senden innerhalb des Geofency Moduls automatisch angelegt. Es können mehrere Geräte über einen Hook laufen. Jedes Gerät wird unter seiner eigenen "Kategorie" eingerichtet.
Name | Typ | Beschreibung |
---|---|---|
Gerätename | Instanz (Dummy) | Dient als "Kategorie" in der sich alle überwachten Standorte, sowie der Zeitstempel und Längen-/Breitengrad befinden. Wird pro Gerät erstellt. |
Latitude | Float | Breitengrad (Mitte des Geofences) der letzten Aktivität |
Longitude | Float | Längengrad (Mitte des Geofences) der letzten Aktivität |
CurrentLatitude | Float | Proximity-Koordinaten, also die aktuellen Koordinaten bei Ein- oder Austritt (äusserer Umkreis des Geofences), falls „Aktuelle Position senden“ in der App beim Webhook gewählt wurde |
CurrentLongitude | Float | Proximity-Koordinaten, also die aktuellen Koordinaten bei Ein- oder Austritt (äusserer Umkreis des Geofences), falls „Aktuelle Position senden“ in der App beim Webhook gewählt wurde |
Direction | Integer | Azimutwinkel (Richtung in Grad) des aktuellen Ein-/Austrittspunktes bezogen auf die Mitte des Geofence-Kreises, falls „Aktuelle Position senden“ in der App beim Webhook gewählt wurde |
Distance | Float | Abstand (in Meter) des aktuellen Ein-/Austrittspunktes bezogen auf die Mitte des Geofence-Kreises, falls „Aktuelle Position senden“ in der App beim Webhook gewählt wurde |
Orientation | Float | Himmelsrichtung (als Name) des aktuellen Ein-/Austrittspunktes bezogen auf die Mitte des Geofence-Kreises, falls „Aktuelle Position senden“ in der App beim Webhook gewählt wurde |
Timestamp | Integer | UnixTimestamp der letzten Aktivität. |
Beispielstandort (Büro) | Boolean | Present oder Absent. Information wird von Gefency geliefert. |
aktuelle Longitude | Float | Aktueller Breitengrad |
aktuelle Latitude | Float | Aktueller Längengrad |
Motion | Integer | aktueller Bewegungszustand wie Gehen, Autofahren etc. |
WifiBSSD | String | BSSID des verbundenen WLANs |
WifiSSID | String | SSID des verbundenen WLANs |
Beispiel: