Mapbox Traffic Smart-Home-Integration, kostenlos und Open Source
Echtzeit-Verkehr auf Ihren Strecken: Fahrzeit, Verspätung, Diagramme und Stauwarnungen über Mapbox.
Veröffentlicht von quentinlegay
- Geräte
- Version 1.1.2
- Erfordert Gladys >=5.1.0
- ★ 0
Verfolgen Sie die Fahrzeit Ihrer üblichen Strecken (Zuhause → Arbeit, Schule…)
mit Echtzeit-Verkehr, sehen Sie sie als Diagramm und lassen Sie sich bei Staus
oder ungewöhnlich langen Fahrten benachrichtigen. Die Daten stammen aus der
Mapbox Directions API
(Profil driving-traffic).
Was Sie bekommen
Ein Gerät Strecke pro konfigurierter Strecke (bis zu 3), mit:
| Funktion | Beschreibung |
|---|---|
| Fahrzeit | Dauer mit dem aktuellen Verkehr, in Minuten (im Verlauf gespeichert) |
| Übliche Fahrzeit | Typische Dauer zu dieser Zeit der Woche laut Mapbox |
| Verspätung | Differenz zwischen beiden, in Minuten |
| Entfernung | Länge der empfohlenen Strecke, in km |
| Verkehrslage | 0 flüssig, 1 zähflüssig, 2 Stau, 3 schwerer Stau |
| Verkehr | Dieselbe Stufe als Text |
| Über | Die befahrenen Hauptstraßen („A86, A1“) |
Außerdem:
- ein Dashboard-Widget „Fahrzeit“: Dauer, Verspätung, Diagramm der aktuellen und der üblichen Fahrzeit, Verkehrszustand und eine Schaltfläche „Aktualisieren“;
- vier Szenen-Auslöser: Stau auf einer Strecke, Stau aufgelöst, Ungewöhnlich lange Fahrzeit, Fahrzeit wieder normal;
- eine Szenen-Aktion Fahrzeit einer Strecke abrufen, z. B. um jeden Morgen „32 min (+7 min) · Zähflüssig“ zu senden.
Einrichtung
- Erstellen Sie ein kostenloses Konto auf mapbox.com
und kopieren Sie Ihr öffentliches Standard-Zugriffstoken (es beginnt mit
pk.). Der kostenlose Tarif enthält 100.000 Routenanfragen pro Monat. - Fügen Sie das Token im Reiter Konfiguration der Integration ein.
- Füllen Sie mindestens Strecke 1 aus:
- Name: zum Beispiel „Arbeit“;
- Start: leer lassen, um vom in Gladys festgelegten Standort des Hauses loszufahren (Einstellungen → Häuser), oder eine Adresse bzw. Koordinaten eingeben;
- Ziel: eine Adresse oder Koordinaten „Breitengrad, Längengrad“ („48.8924, 2.2369“, wie mit einem Rechtsklick aus Google Maps kopiert);
- Fahren über (optional): standardmäßig nimmt Mapbox den schnellsten
Weg. Um Ihrem Weg zu folgen, geben Sie einen oder mehrere Orte in der
gewünschten Reihenfolge an, getrennt durch
;(bis zu 3): eine Brücke, eine Stadt, einen Punkt auf Ihrer Straße… Zum BeispielPont de Normandie; 49.4431, 0.3601. Wählen Sie Punkte auf der gewünschten Straße (nicht daneben), sonst macht Mapbox einen Umweg, um sie zu erreichen. Das kostet keine zusätzliche Anfrage.
- Klicken Sie auf Mapbox testen: die aktuelle Fahrzeit von Strecke 1 wird unter der Schaltfläche angezeigt.
- Öffnen Sie den Reiter Erkennung und fügen Sie Ihre Strecken hinzu.
Aktualisierung
- Intervall: standardmäßig 300 s (mindestens 60 s).
- Aktive Tage / Aktive Stunden: Mapbox nur abfragen, wenn es darauf
ankommt, z. B. Montag bis Freitag,
07:00-09:30, 16:30-19:00. Leer bedeutet immer. Die Stunden gelten in der konfigurierten Zeitzone (standardmäßigEurope/Paris). - Vermeiden: Mautstraßen, Autobahnen, Fähren.
Kostenloser Mapbox-Tarif
Die Directions-API enthält 100.000 kostenlose Anfragen pro Monat; darüber hinaus berechnet Mapbox die zusätzlichen Anfragen (siehe die Mapbox-Preise). Die Integration stellt bei jeder Aktualisierung eine Anfrage pro Strecke und geokodiert jede Adresse nur einmal. Monatlicher Verbrauch ≈ Strecken × Aktualisierungen pro Stunde × aktive Stunden pro Tag × Tage.
Zum Beispiel verbrauchen 3 Strecken, die alle 5 Minuten während 5 Stunden an jedem Werktag aktualisiert werden, etwa 4.000 Anfragen pro Monat, und etwa 26.000, wenn sie den ganzen Tag aktualisiert werden: beides bleibt im kostenlosen Tarif. 3 Strecken jede Minute rund um die Uhr zu aktualisieren verbraucht etwa 130.000 Anfragen und überschreitet ihn.
Ihren tatsächlichen Verbrauch sehen Sie in Ihrem Mapbox-Konto.
Warnungen
- Stau: mindestens 10 % (einstellbar) der Strecke sind laut Mapbox stark verstopft, oder die Fahrt ist deutlich länger als üblich (+35 %).
- Ungewöhnlich lang: die Fahrzeit überschreitet die übliche um 30 % und um mindestens 5 Minuten (beides einstellbar), sodass eine kurze Fahrt, die von 4 auf 6 Minuten steigt, keine Warnung auslöst.
Szenen-Beispiele
- Stauwarnung: Auslöser Stau auf einer Strecke (Strecke „Arbeit“),
Aktion „Nachricht senden“:
Stau zur Arbeit: {{triggerEvent.data.summary}}. - Morgendliche Übersicht: werktags um 7 Uhr die Aktion Fahrzeit einer Strecke abrufen, dann „Nachricht senden“ mit der Variable Zusammenfassung (oder Fahrzeit (min)) der vorherigen Aktion.
- Persönliche Schwelle: die Strecke ist ein normales Gladys-Gerät, daher funktioniert auch der native Auslöser „Gerätewert“: „wenn Fahrzeit (Arbeit) > 45“.
Ereignis-Auslöser werden nur bei einer Änderung ausgelöst (ein einziges „Stau“, solange der Stau andauert).
Fehlerbehebung
- „Mapbox refused the access token“: prüfen Sie das Token auf account.mapbox.com.
- Adresse nicht gefunden: verwenden Sie eine vollständigere Adresse oder Koordinaten.
- „the home has no location“: legen Sie den Standort des Hauses in Gladys fest, oder füllen Sie den Start aus.
- Die Logs der Integration (Reiter Logs, oder
docker logs) beschreiben jede Aktualisierung; setzen SieLOG_LEVEL=debug, um die Anfragen zu sehen (das Token wird maskiert).
Konfigurationseinstellungen
Diese Einstellungen fragt Mapbox Traffic in seinem Konfigurationsbildschirm in Gladys ab.
| Einstellung | Typ | Pflichtfeld | Beschreibung |
|---|---|---|---|
| Mapbox-Konto | section | Nein | Erstellen Sie ein kostenloses Mapbox-Konto und kopieren Sie Ihr öffentliches Standard-Zugriffstoken (es beginnt mit pk.). |
| Kostenloser Mapbox-Tarif | section | Nein | Die Directions-API enthält 100.000 kostenlose Anfragen pro Monat; darüber hinaus berechnet Mapbox die zusätzlichen Anfragen. Diese Integration stellt bei jeder Aktualisierung eine Anfrage pro Strecke (Adressen werden nur einmal geokodiert). Monatlicher Verbrauch ≈ Strecken × Aktualisierungen pro Stunde × aktive Stunden pro Tag × Tage. Beispiele: 3 Strecken alle 5 min, 5 h pro Werktag ≈ 4.000 Anfragen (kostenlos); 3 Strecken alle 5 min, rund um die Uhr ≈ 26.000 (kostenlos); 3 Strecken jede Minute, rund um die Uhr ≈ 130.000 (über dem kostenlosen Tarif). Nutzen Sie die aktiven Tage und Stunden unten, um deutlich darunter zu bleiben. |
| Mapbox-Zugriffstoken | secret | Ja | |
| Sprache der Texte | select | Nein | |
| Strecke 1 | section | Nein | Ein Ort ist entweder eine Adresse („10 rue de Rivoli, Paris“) oder Koordinaten im Format „Breitengrad, Längengrad“ („48.8566, 2.3522“, wie aus Google Maps kopiert). Lassen Sie den Start leer, um vom in Gladys festgelegten Standort des Hauses loszufahren. Lassen Sie das Ziel leer, um die Strecke zu deaktivieren. Um einen anderen als den schnellsten Weg zu nehmen, geben Sie Orte an, über die gefahren werden soll (eine Brücke, eine Stadt, eine Straße). |
| Name | string | Nein | |
| Start (leer lassen, um von zu Hause loszufahren) | string | Nein | |
| Fahren über (optional) | string | Nein | Erzwingt die Strecke über diese Orte, in dieser Reihenfolge, statt des schnellsten Wegs. Bis zu 3 Orte, getrennt durch „;“. |
| Ziel | string | Ja | |
| Strecke 2 | section | Nein | Optionale zusätzliche Strecke, gleiches Format wie Strecke 1. |
| Name | string | Nein | |
| Start (leer lassen, um von zu Hause loszufahren) | string | Nein | |
| Fahren über (optional) | string | Nein | Erzwingt die Strecke über diese Orte, in dieser Reihenfolge, statt des schnellsten Wegs. Bis zu 3 Orte, getrennt durch „;“. |
| Ziel | string | Nein | |
| Strecke 3 | section | Nein | Optionale zusätzliche Strecke, gleiches Format wie Strecke 1. |
| Name | string | Nein | |
| Start (leer lassen, um von zu Hause loszufahren) | string | Nein | |
| Fahren über (optional) | string | Nein | Erzwingt die Strecke über diese Orte, in dieser Reihenfolge, statt des schnellsten Wegs. Bis zu 3 Orte, getrennt durch „;“. |
| Ziel | string | Nein | |
| Aktualisierung | section | Nein | Die Strecken werden nur an den aktiven Tagen und zu den aktiven Stunden aktualisiert, um Ihr Mapbox-Kontingent zu schonen. Leer lassen, um ständig zu aktualisieren. |
| Aktualisierungsintervall (s) | number | Nein | |
| Aktive Tage (leer = jeden Tag) | multi_select | Nein | |
| Aktive Stunden (leer = den ganzen Tag) | string | Nein | |
| Zeitzone | string | Nein | |
| Vermeiden | multi_select | Nein | |
| Warnungen | section | Nein | Ein Stau wird erkannt, wenn mindestens der angegebene Anteil der Strecke stark verstopft ist. Die Fahrzeit ist ungewöhnlich lang, wenn sie die übliche sowohl um den angegebenen Prozentsatz als auch um die angegebene Anzahl Minuten überschreitet. Beides löst Szenen aus. |
| Stau: verstopfter Anteil der Strecke (%) | number | Nein | |
| Ungewöhnlich: länger als üblich um (%) | number | Nein | |
| Ungewöhnlich: mind. (min) Verspätung | number | Nein |
So installierst du Mapbox Traffic in Gladys
- Öffne in Gladys Integrationen: Mapbox Traffic erscheint im Katalog neben den nativen Integrationen, mit einem Community-Badge.
- Klicke auf Installieren. Gladys lädt das Docker-Image (
ghcr.io/quentinlegay/gladys-mapbox-traffic:1.1.2) 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/quentinlegay/Gladys-mapbox-traffic.
Mapbox Traffic 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
Mapbox Traffic 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 quentinlegay 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