Google Maps Travel Time Smart-Home-Integration, kostenlos und Open Source
Fahrzeiten mit Live-Verkehr von Google Maps: Verzögerung, Entfernung, Route, Szenen.
Veröffentlicht von William-De71
- Geräte
- Version 0.1.0
- Erfordert Gladys >=5.1.0
- ★ 0
Überblick
Diese Integration verfolgt Ihre üblichen Strecken — nach Hause, zur Arbeit, zur Schule, zum Flughafen — mit der Fahrzeit von Google Maps. Für jede Strecke liefert sie die Fahrzeit mit Echtzeitverkehr, die Verzögerung durch den Verkehr, die Entfernung und die Hauptstraßen, und sie kann Ihre Szenen starten, wenn der Verkehr zunimmt oder sich die Route ändert.
- Jede Strecke wird zu einem Gerät: Fahrzeit, Zeit ohne Verkehr und Verkehrsverzögerung (Auto und Zweirad), Entfernung, Hauptstraßen.
- Die Strecken werden nur an ihren Tagen und Uhrzeiten gemessen, damit die Anfragen im kostenlosen Monatskontingent von Google bleiben.
- Szenen-Auslöser: Die Route einer Strecke ändert sich, das Monatsbudget ist fast verbraucht, Google lehnt den API-Schlüssel ab. Szenen-Aktionen: eine Route jetzt berechnen, eine Strecke jetzt messen.
- Drei Dashboard-Widgets: die Fahrzeiten der Strecken, eine Strecke, die Anfragen des Monats.
Das Bild oben ist eine generierte Illustration, kein Screenshot. Nicht mit Google verbunden; noch nicht mit einem echten API-Schlüssel getestet.
Voraussetzungen
- Gladys Assistant 5.1.0 oder neuer.
- Ein Google-Maps-Platform-API-Schlüssel:
- Erstellen Sie in der Google Cloud Console ein Projekt (oder wählen Sie eines) und verknüpfen Sie es mit einem Rechnungskonto: Google verlangt es auch, wenn Sie im Gratiskontingent bleiben.
- Aktivieren Sie die Routes API (APIs & Dienste → Bibliothek → „Routes API“).
- Erstellen Sie einen API-Schlüssel (Google Maps Platform → Schlüssel und Anmeldedaten) und beschränken Sie ihn auf die Routes API. Eine IP-Beschränkung funktioniert nur, wenn die öffentliche IP-Adresse Ihres Gladys fest ist.
- Die Zeitzone von Gladys richtig eingestellt (Einstellungen > System): Die Uhrzeiten der Strecken werden darin gelesen.
Kosten. Google berechnet jede erfolgreiche Anfrage über ein kostenloses Monatskontingent pro Anfrageart hinaus: 5.000 Anfragen per Auto mit Echtzeitverkehr („Pro“), 1.000 per Motorrad oder Roller („Enterprise“), 10.000 per Fahrrad, zu Fuß oder mit öffentlichen Verkehrsmitteln („Essentials“). Eine Autostrecke, die von 6 bis 21 Uhr, Montag bis Freitag, alle 15 Minuten gemessen wird, braucht etwa 1.300 Anfragen im Monat. Die Integration bleibt standardmäßig unter 90 % jedes Gratiskontingents und misst die Strecken lieber seltener, als es zu überschreiten. Das Gratiskontingent gehört zum Rechnungskonto: Andere Nutzungen des Kontos zählen mit.
Konfiguration
Die Strecken werden nicht als JSON eingegeben: Jede ist ein kleines Formular hinter den Schaltflächen unten auf der Konfigurationsseite.
| Feld oder Schaltfläche | Beschreibung |
|---|---|
| Google-Maps-Platform-API-Schlüssel | Erforderlich. Von Gladys geheim gehalten, nie wieder angezeigt und nie in die Logs geschrieben. |
| Standardintervall | Minuten zwischen zwei Messungen einer Strecke ohne eigenes Intervall (5 bis 240, standardmäßig 15). |
| Standard-Verzögerungsschwelle | Verkehrsverzögerung in Minuten, ab der eine Strecke in den Widgets rot erscheint (orange ab 3 Minuten). Standardmäßig 10. |
| Monatsbudget | Anteil des Gratiskontingents jeder Anfrageart, den die Integration verbrauchen darf. Standardmäßig 90; über 100 berechnet Google die zusätzlichen Anfragen. |
| Sprache der Texte | Funktionsnamen, Routenbeschreibungen, Szenen-Zusammenfassungen, Meldungen der Schaltflächen. Vor dem Hinzufügen der Geräte wählen: Ein Gerät behält die Namen, mit denen es erstellt wurde. |
| Strecke hinzufügen | Name, Start, Ziel, Fortbewegungsart, Maut / Autobahnen / Fähren vermeiden, Tage, Uhrzeiten („6-10, 16-20“, leer: 6-21), eigenes Intervall und eigene Schwelle. |
| Strecke ändern | Die Strecke über Name oder Nummer (#2); nur die ausgefüllten Felder ändern sich. 0 setzt Intervall oder Schwelle auf den Standard zurück. |
| Strecke entfernen | Die Strecke über Name oder Nummer. Ihr Gerät bleibt in Gladys, bis Sie es löschen. |
| Strecken auflisten | Jede Strecke mit Zeitplan, geplanten Anfragen, letzter Messung und letztem Fehler, dazu die Anfragen des Monats. |
| API-Schlüssel testen | Berechnet einen kurzen Fußweg in Paris (eine Essentials-Anfrage) und sagt, was zu beheben ist, wenn Google den Schlüssel ablehnt. |
Start und Ziel akzeptieren eine Adresse, einen Ort („Lyon Part-Dieu“), einen Plus Code oder Koordinaten „Breite, Länge“ (etwa 45.7640, 4.8357).
Verwendung
Strecken
- Fügen Sie den API-Schlüssel ein und drücken Sie API-Schlüssel testen.
- Drücken Sie Strecke hinzufügen für jede übliche Strecke. Standard: Auto, Montag bis Freitag von 6 bis 21 Uhr, alle 15 Minuten; passen Sie Tage und Uhrzeiten an.
- Die erste Messung kommt innerhalb einer Minute, wenn die Strecke in ihren Uhrzeiten liegt. Außerhalb behält die Strecke ihre letzte Messung.
Geräte
Öffnen Sie den Tab Entdecken und fügen Sie die gewünschten Strecken hinzu. Jedes Gerät hat:
- Fahrzeit mit Verkehr (Minuten; „Fahrzeit“ für Fahrrad, zu Fuß und öffentliche Verkehrsmittel);
- Fahrzeit ohne Verkehr und Verkehrsverzögerung (Minuten; Auto und Zweirad);
- Entfernung (km) und Route (die Hauptstraßen, etwa „A6“).
Die Werte folgen den Messungen der Strecke; Gladys behält ihren Verlauf.
Dashboard-Widgets
- Fahrzeiten: die Strecken mit Fahrzeit, Entfernung und Straßen, ein Verzögerungsabzeichen (grün, orange ab 3 Minuten, rot ab der Schwelle der Strecke), ein Link zur Route in Google Maps und Alle aktualisieren.
- Strecke: eine unter den Geräten gewählte Strecke: vier Kacheln, Route, letzte Messung, Aktualisieren.
- Google-Maps-Anfragen: eine Anzeige pro genutzter Anfrageart, was die Strecken pro Monat planen, der Zustand des Schlüssels.
Eine Aktualisieren-Schaltfläche kostet eine Anfrage pro Strecke, keine für eine vor weniger als einer Minute gemessene Strecke.
Szenen
Auslöser der Integration:
- Die Route einer Strecke ändert sich: Bei einer geplanten Messung führt die schnellste Route über andere Straßen als bei der vorigen. Variablen: Name, Route, vorherige Route, Fahrzeit, Verzögerung, Entfernung, Zusammenfassung.
- Das Monatsbudget ist fast verbraucht: Eine Anfrageart erreicht 80 %, dann 100 % ihres Budgets (je einmal pro Monat).
- Google lehnt den API-Schlüssel ab: einmal, bis eine Anfrage wieder funktioniert; die Zusammenfassung nennt die Abhilfe.
Für eine Schwelle („die Verzögerung übersteigt 10 Minuten“, „die Fahrzeit übersteigt 40 Minuten“) nutzen Sie den Geräte-Auslöser von Gladys auf der Funktion der Strecke.
Aktionen: Route berechnen (zwei beliebige Orte, jetzt) und Strecke jetzt messen (auch außerhalb ihrer Uhrzeiten). Beide liefern Fahrzeit, Zeit ohne Verkehr, Verzögerung, Entfernung, Route und eine Zusammenfassung wie „Arbeit: 38 Min., davon 14 Min. Verkehr, 11,8 km über M6.“ zum Versenden.
Beispiele:
- Wenn die Verkehrsverzögerung von „Arbeit“ 10 Minuten übersteigt → die Zusammenfassung der Strecke senden.
- Jeden Werktag um 7:15 → „Arbeit“ jetzt messen →
{{0.0.summary}}an die Familie senden.
Transport
Die Integration nutzt die Server von Google (Cloud): Die Adressen Ihrer Strecken werden bei jeder Messung mit Ihrem API-Schlüssel an Google gesendet. Die Strecken liegen in der Gladys-Konfiguration; die letzten Messungen und der Anfragezähler im Volume /data der Integration.
Fehlerbehebung
- „Google lehnt den API-Schlüssel ab“: Die Meldung nennt den Grund von Google.
API_KEY_INVALID: Schlüssel erneut kopieren.SERVICE_DISABLED: die Routes API im Projekt des Schlüssels aktivieren.BILLING_DISABLED: ein Rechnungskonto verknüpfen.API_KEY_SERVICE_BLOCKED: die Routes API zu den erlaubten APIs des Schlüssels hinzufügen. Eine IP-Beschränkung lehnt Gladys ab, wenn sich seine öffentliche Adresse geändert hat. Die Integration versucht es stündlich erneut, und sofort nach API-Schlüssel testen oder einem neuen Schlüssel. - Eine Strecke hat keine Messung: Prüfen Sie Tage und Uhrzeiten mit Strecken auflisten (die angezeigte Zeitzone muss Ihre sein) und den letzten Fehler: „Google hat keine Route gefunden“ bedeutet eine Adresse, die Google nicht findet, oder eine dort nicht verfügbare Fortbewegungsart.
- Seltenere Messungen als das Intervall: „gestreckt …, um im Budget zu bleiben“ in Strecken auflisten heißt, die Strecken dieser Anfrageart planen mehr als das Budget; Uhrzeiten, Strecken oder Intervall reduzieren oder das Budget erhöhen.
- „Die Anfragen des Monats sind verbraucht“: Das Budget dieser Anfrageart ist erreicht; die betroffenen Strecken warten auf den nächsten Monat (UTC). Maßgeblich ist die Zählung von Google (Cloud Console → Google Maps Platform → Messwerte).
- 429: Google begrenzt die Anfragen des Schlüssels; die Integration wartet 15 Minuten.
- Für eine Problemmeldung: die Versionen von Gladys und der Integration, den Text von Strecken auflisten (Adressen gern unkenntlich machen) und die Logs der Integration (Einstellungen → Supervision). Fügen Sie nie Ihren API-Schlüssel ein.
Konfigurationseinstellungen
Diese Einstellungen fragt Google Maps Travel Time in seinem Konfigurationsbildschirm in Gladys ab.
| Einstellung | Typ | Pflichtfeld | Beschreibung |
|---|---|---|---|
| Google Maps Travel Time | section | Nein | So funktioniert es: 1. Erstellen Sie in der Google Cloud Console einen Google-Maps-Platform-API-Schlüssel, in einem Projekt mit Rechnungskonto und aktivierter „Routes API“, und fügen Sie ihn unten ein. 2. Legen Sie jede Strecke mit „Strecke hinzufügen“ an: Start, Ziel, Fortbewegungsart, Tage und Uhrzeiten der Messung. 3. Öffnen Sie den Tab Entdecken und fügen Sie die Strecke hinzu: Sie wird zu einem Gerät mit Fahrzeit, Verkehrsverzögerung, Entfernung und Route. 4. Fügen Sie die Widgets einem Dashboard hinzu und nutzen Sie die Szenen (die Route ändert sich, eine Route berechnen). Kosten: Jede Messung ist eine Anfrage, die Google über sein kostenloses Monatskontingent hinaus berechnet — 5.000 Anfragen mit Verkehr per Auto, 1.000 per Zweirad, 10.000 ohne Verkehr (Fahrrad, zu Fuß, ÖPNV). Die Integration bleibt standardmäßig unter 90 % davon und streckt eher die Intervalle, als es zu überschreiten. Die Adressen werden an Google gesendet. |
| Google-Maps-Platform-API-Schlüssel | secret | Ja | Ein Schlüssel eines Google-Cloud-Projekts mit aktivierter Routes API. Beschränken Sie ihn auf die Routes API (und auf die öffentliche IP-Adresse Ihres Gladys, wenn sie fest ist). |
| Standardintervall (Minuten) | number | Nein | Wie oft eine Strecke ohne eigenes Intervall innerhalb ihrer Uhrzeiten gemessen wird (5 bis 240). |
| Standard-Verzögerungsschwelle (Minuten) | number | Nein | Ab dieser Verzögerung wird eine Strecke ohne eigene Schwelle in den Widgets rot angezeigt (orange ab 3 Minuten). |
| Monatsbudget (% des Gratiskontingents) | number | Nein | Anteil des kostenlosen Monatskontingents jeder Anfrageart, den die Integration verbrauchen darf: 90 lässt einen Puffer (Google zählt auch andere Nutzungen des Rechnungskontos). Über 100 berechnet Google die zusätzlichen Anfragen. |
| Sprache der Texte | select | Nein | Funktionsnamen, Routenbeschreibungen, Szenen-Zusammenfassungen und Meldungen der Schaltflächen. Automatisch: die Sprache Ihres Dashboards, sobald ein Widget angezeigt wurde, vorher aus der Zeitzone von Gladys abgeleitet. |
So installierst du Google Maps Travel Time in Gladys
- Öffne in Gladys Integrationen: Google Maps Travel Time erscheint im Katalog neben den nativen Integrationen, mit einem Community-Badge.
- Klicke auf Installieren. Gladys lädt das Docker-Image (
ghcr.io/william-de71/gladys-google-maps-travel-time:0.1.0) herunter, startet es in einer vom Kern isolierten Sandbox und erzeugt die Oberfläche der Integration (Geräte, Erkennung und Konfiguration). - Öffne den Bildschirm Konfiguration der Integration, fülle die Einstellungen aus und speichere.
- Du kannst sie auch direkt über die URL ihres Repositorys installieren: https://github.com/William-De71/gladys-google-maps-travel-time.
Google Maps Travel Time benötigt Gladys >=5.1.0. Der Katalog in Gladys wird stündlich aktualisiert, eine neue Version ist also spätestens eine Stunde nach ihrer Veröffentlichung verfügbar.
Du nutzt Gladys noch nicht? Es ist kostenlos und Open Source: folge der Installationsanleitung, um loszulegen.
Über externe Integrationen
Google Maps Travel Time ist eine externe Integration: eine Community-Integration, die als Docker-Container verpackt und auf GitHub veröffentlicht wird. Gladys installiert sie mit einem Klick und führt sie in einer vom Kern isolierten Sandbox aus. Sie wird von William-De71 veröffentlicht und gepflegt, nicht vom Gladys-Kernteam.
- Alle Integrationen durchsuchen, native und aus der Community
- Deine eigene externe Integration bauen und veröffentlichen
- Quellcode auf GitHub — Quelle dieser Dokumentation