Geoloc-Plugin

Description

Plugin zum Verwalten von Koordinaten und Berechnen der Entfernung zwischen 2 Punkten, der Fahrzeit (mit dem Auto) zwischen 2 Punkten sowie der Entfernung. Um die Reisezeit zu berechnen, ist ein Google-Entwicklerkonto erforderlich, um auf die „Directions API“ zugreifen zu können’. Ohne Google-Konto können Sie die Entfernung zwischen 2 Punkten (Entfernung in der Luftlinie) berechnen, nicht jedoch die Reisezeit oder die Straßenentfernung.

Configuration

Sobald das Plugin über den Markt installiert und aktiviert ist, können Sie über das Menü Plugins → Organisation → Geoloc auf die Seite Geolocation-Plugin zugreifen.

Der erste Schritt besteht darin, den API-Schlüssel zu konfigurieren, der die Verbindung zu Google ermöglicht. Geben Sie dazu in der Plugin-Konfiguration Ihren API-Schlüssel in den dafür vorgesehenen Bereich ein (Direction API). Anschließend können Sie die maximale Anzahl der Google-Anfragen begrenzen, die das Plugin täglich ausführen kann. Dadurch wird eine Überladung vermieden. Standardmäßig sind 1.000 Anfragen pro Tag möglich (1.000 Anfragen = 5 $, also höchstens etwa 150 $ pro Monat, was unter den 200 $ liegt, die Google jeden Monat anbietet). Um eine unbegrenzte Anzahl von Anfragen pro Tag zu haben, müssen Sie den Wert 0 angeben. Wenn der Google API-Schlüssel nicht angegeben ist, wird die Entfernungsberechnung (Route und Reisezeit) nicht berechnet. Es wird nur die Entfernung „Luftlinie“ berechnet.

Hier finden Sie alle Ihre Geoloc-Geräte :

Sobald ein Gerät ausgewählt wurde, gelangen Sie auf diese Seite :

L’onglet «Equipement» permet de choisir le nom de l’équipement, l’objet parent ainsi que son état et sa visibilité.

Anschließend können Sie wählen, ob dieses Gerät alle 5 Minuten aktualisiert werden soll. Beispielsweise wird es nicht für feste Geräte (in meinem Fall Home or Work (Ben)) benötigt, sondern für mobile Geräte (Mobile Ben)). Um die Aktualisierung zu aktivieren, muss das Kästchen „Automatisch (cron)“ aktiviert werden. Anschließend können Sie die Cache-Gültigkeit konfigurieren. Standardmäßig ist der Cache 5 Minuten (300 Sekunden) gültig). Der Cache wird verwendet, wenn sich das Gerät nicht bewegt hat, unabhängig von der Gültigkeit des Caches, oder wenn die Informationen noch gültig sind. Über die „Refresh“-Funktion des Geräts ist es jederzeit möglich, eine Aktualisierung der Informationen zu erzwingen. In diesem Fall werden die Informationen über das Gerät aus dem Cache gelöscht, die Informationen von Google abgerufen und zur späteren Verwendung wieder in den Cache eingefügt.

L’onglet «Commandes» permet d’ajouter les informations que nous voulons obtenir. Sobald die Ausrüstung hinzugefügt wurde, haben wir die Wahl zwischen drei Arten von Steuerungen : fest, dynamisch und distanziert.

Fixe

Stellt einen Punkt mit Koordinaten dar, die sich nicht ändern. Zum Beispiel die Koordinaten Ihres Hauses, Ihrer Arbeit usw. Sie müssen nur die Koordinaten in das Formular eintragen : Latitude,Longitude.

Pour trouver les coordonnées de votre position fixe, allez simplement sur Google map : https://www.google.com / maps / Vorschau . Wenn Sie nach einer Adresse suchen, befinden sich die Kontaktdaten in der URL-Adresse, z. B. für 25 rue de Mogador :

Sie können auch mit der linken Maustaste auf die Karte klicken. Die Koordinaten werden in der kleinen Karte oben links angezeigt.

Dynamique

Stellt einen Punkt mit variablen Koordinaten dar, das Objekt bewegt sich. Dies ist normalerweise Ihr Laptop. Diese Bestellung enthält daher die zuletzt gesendeten Kontaktdaten, bis Sie neue senden. Die URL zum Aktualisieren dieses Befehls lautet :

\.#URL\._JEEDOM\.#/core/api/jeeApi.php?api=\.#API\._KEY\.#&type=geoloc&id=\.#ID\._CMD\.#&value=%LOC

.#URL._JEEDOM.# entspricht Ihrer Jeedom-Zugriffs-URL. Dies ist (sofern Sie nicht mit Ihrem lokalen Netzwerk verbunden sind) die Internetadresse, mit der Sie von außen auf Jeedom zugreifen. Vergessen Sie nicht, den Port sowie / jeedom / anzugeben.

api=.#API._KEY.# entspricht Ihrem API-Schlüssel, der für Ihre Installation spezifisch ist. Um es zu finden, können Sie entweder zum Géoloc-Plugin gehen, es wird direkt in der URL angegeben.

Soit dans le menu « Général », puis « Administration » et « Konfiguration », en activant le mode Expert vous verrez alors une ligne clé API.

<id=.#ID._CMD.# entspricht der ID Ihrer Bestellung. Une fois que vous avez donné un nom à votre commande de Géolocalisation, déterminé son type et sauvegardé, un numéro apparaît dans la case « .# » devant le nom votre commande.

%LOC entspricht Ihren Koordinaten in der Form Breite, Länge.

Sie müssen daher einen HTTP-POST für diese Adresse durchführen, indem Sie% LOC durch Ihre Kontaktdaten ersetzen.

Android Beispiel mit Tasker

Achtung : Für dieses Beispiel benötigen Sie die Tasker-App für Android (https://play.google.com/store/apps/details?id=net.dinglisch.android.taskerm). Dans l’onglet « Tâches », nous rajoutons une nouvelle tâche ici appelée « Jeedom ».

Nous y ajoutons une première action, dans la catégorie « Divers », nous sélectionnons « Obtenir la localisation ».

Wir werden jede Quelle verwenden, um unsere Position zu erhalten, und wir werden ein Zeitlimit von 30 Sekunden festlegen, damit Tasker die hat Zeit, unsere Kontaktdaten zu erhalten.

Ein zu kurzer Zeitrahmen ermöglicht möglicherweise nicht das Abrufen von Kontaktdaten oder ungenaue Kontaktdaten. Dies gilt auch für den Quellentyp. Nous ajoutons une deuxième action, dans la partie « Réseau » cette fois, nous sélectionnons « Post HTTP ».

Dans la case « Serveur :Port » nous copions notre URL complétée sauf pour la partie %LOC.

Lorsque nous lançons notre tâche « Jeedom », une icône devrait vous informer de l’utilisation de votre GPS dans votre barre de notification.

Une fois le délai écoulé, nous cliquons sur « tester » dans Jeedom et les coordonnées de notre portable apparaissent alors dans le popup. Der Tasker hat die Variable% LOC automatisch durch Ihre Kontaktdaten ersetzt.

Jetzt müssen Sie nur noch ein Szenario in Tasker erstellen, das diese Aufgabe bei Bedarf startet. Zum Beispiel jede Stunde, wenn Sie eine Verbindung über WLAN herstellen…

Entfernung, Reisezeit und Reisestrecke

Berechnet die Entfernung, Reisezeit (mit dem Auto, mit Google Maps) oder die Entfernung einer Reise (mit dem Auto, mit Google Maps) zwischen zwei Punkten. Es ist daher erforderlich, mindestens zwei Befehle bereits ausgefüllt zu haben. Hier haben wir die festen Koordinaten unseres Hauses sowie die aktualisierten Koordinaten unseres Handys. So können wir den Abstand zwischen den beiden berechnen. Nous sélectionnons « Distance » en type et nos deux commandes précédentes dans les options. Nach dem Speichern verwenden wir die Testschaltfläche und die Entfernung wird dann im Popup angezeigt. Hier 1,34 km.

Ebenso, wenn Sie die Reisezeit oder die Entfernung einer Reise wollen, es muss jeweils in Typ wählen : “Reisezeit “oder” Entfernung Reise”.

Dieses Plugin funktioniert wie ein Modul, das heißt, wenn es einmal gespeichert ist, finden wir es in der Liste der Aktionen oder Befehle. Daher ist es sehr einfach, es beispielsweise beim Erstellen von Szenarien zu verwenden. Wir können zum Beispiel ein Szenario durchführen, das zum Beispiel auf der Entfernung zwischen unserem Laptop und dem Haus basiert.

Beispielszenario

Dans la partie « Scénario », nous créons un scénario nommé « Géoloc TV » qui nous permet d’allumer la TV quand nous sommes à moins de 250 m de notre maison. Achtung : Positionierungssysteme sind nicht auf den nächsten Meter genau. Denken Sie daran, bei der Erstellung Ihrer Szenarien einen Spielraum einzuhalten. Dans « Mode de scénario » nous choisissons « Provoqué » et en « Déclencheur » nous ajoutons notre portable. In der Tat werden wir das Szenario auslösen, wenn die Koordinaten unseres Mobiltelefons aktualisiert werden.

Nous ajoutons un élément « Si / Alors / Sinon » avec comme condition une distance inférieure à 250 m et comme action la mise sous tension de la TV.

Nous n’avons rien mis dans la partie « Sinon » ainsi il ne se passera rien si je suis à plus de 250 m. Nach dem Speichern können wir uns das Protokoll ansehen. Wir sehen hier, dass Jeedom den Abstand zwischen dem Laptop und dem Haus getestet hat und da dieser mehr als 250 m beträgt, ist nichts passiert.

Für unseren Test überprüfen wir, ob der Fernseher ausgeschaltet ist. Das Widget zeigt uns einen Verbrauch von 0 Watt an.

Wir nähern uns unserem Haus und beginnen die Aufgabe auf Tasker. Wir können durch Testen der Entfernung sehen, dass sie jetzt 0,03 km beträgt. Wir sind also weit unter 250 m.

Der Szenarioteil informiert uns darüber, dass er kürzlich gestartet wurde.

Eine Tour durch das Protokoll zeigt, dass es nach der Aktualisierung der Koordinaten des Mobiltelefons gestartet wurde und dass die Entfernung viel weniger als 0,25 km betrug.

Das TV-Plugin auf dem Startbildschirm zeigt an, dass es jetzt mit Strom versorgt wird.

Hier ist ein Beispiel für die Verwendung des Geolocation-Plugins.

Natürlich haben wir den HTTP-POST von einem Android-Smartphone aus durchgeführt, aber es ist durchaus denkbar, dass ein Tablet (mit dem Internet) oder sogar ein Laptop mit einem Skript das Gleiche tun kann, um seine Details abzurufen und zu senden.