Naolib Nantes Smart-Home-Integration, kostenlos und Open Source
Trams und Busse in Nantes (Naolib): Echtzeit-Abfahrten, Verspätungen, Verkehrslage.
Veröffentlicht von William-De71
- Geräte
- Version 0.1.0
- Erfordert Gladys >=5.3.0
- ★ 0
Überblick
Diese Integration bringt Naolib, die Trams, Busways, Chronobusse, Busse und Navibus-Fähren von Nantes Métropole, in Gladys. Sie liefert die nächsten Abfahrten, in Echtzeit korrigiert, mit ihrer Verspätung, an den Haltestellen deiner Wahl (drei im Formular, bis zu 10 weitere per Schaltfläche), gefiltert nach Linie und Richtung. Außerdem verfolgt sie die Verkehrslage von bis zu sechs Linien (normal, Verkehrsinformation, gestört, stark gestört) mit den Meldungen von Naolib: Umleitungen, verlegte Haltestellen, Bauarbeiten. Jede Haltestelle und jede Linie wird ein Gerät, das du auf einem Dashboard anzeigen und in Szenen verwenden kannst.
Die Daten stammen aus den offiziellen Open Data von Naolib (Nantes Métropole) unter der Lizenz ODbL: kein Konto, kein Schlüssel. Der Fahrplan (GTFS, veröffentlicht auf data.nantesmetropole.fr) wird nur heruntergeladen, wenn eine neue Datei erscheint, und von der Integration aufbewahrt. Die Echtzeit (GTFS-RT) des gesamten Netzes wird über transport.data.gouv.fr, den nationalen Zugangspunkt, in einer einzigen Anfrage für alle verfolgten Haltestellen gelesen, standardmäßig jede Minute (alle 10 Minuten, solange keine Haltestelle in der nächsten halben Stunde etwas ankündigt, also nachts). Die Meldungen werden alle 5 Minuten gelesen.
Eine Abfahrt wird in Echtzeit verfolgt, sobald ihre Fahrt unterwegs ist: Ihre geschätzte Zeit und ihre Verspätung werden angegeben. Vorher gilt der Fahrplan, markiert mit „(Fahrplan)“. Ausgefallene Fahrten und nicht bediente Haltestellen werden angezeigt.
Die Quelle der Echtzeit antwortet nur alle 30 Sekunden, für alle Nutzer zusammen: Ist sie belegt, fragt die Integration einige Sekunden später erneut und nutzt bis dahin ihre letzte Abfrage (jünger als 3 Minuten).
Dies ist eine Cloud-Integration: Sie kontaktiert data.nantesmetropole.fr und proxy.transport.data.gouv.fr. Sonst verlässt nichts dein Netzwerk.
Voraussetzungen
- Gladys Assistant 5.3.0 oder neuer.
- Sonst nichts: Die Open Data von Naolib brauchen weder Konto noch Schlüssel.
Konfiguration
| Feld | Was eingeben |
|---|---|
| Haltestelle 1, 2, 3 | Der Name der Haltestelle, wie er an ihr steht: „Commerce“, „Gare Nord - Jardin des Plantes“. |
| Linie | Nur diese Linie: „1“, „C1“, „4“, „N1“. Leer: alle Linien der Haltestelle. |
| Richtung | Nur die Ziele mit diesen Wörtern: „Beaujoire“, „Beaujoire | Ranzay“. Leer: beide Richtungen. |
| Verfolgte Linien | Die Linien, deren Verkehrslage du verfolgst, höchstens sechs: „1, 2, C1, 4“. |
| Abfrage der Echtzeit | Alle 30 Sekunden, jede Minute, alle 2 Minuten oder alle 5 Minuten. |
| Sprache der Texte | Namen der Geräte, Zusammenfassungen und Ausgaben der Szenen. Haltestellennamen und Verkehrsmeldungen bleiben französisch. |
Eine Haltestelle fasst alle Bahnsteige ihres Haltestellenbereichs zusammen, Trams und Busse: „Commerce“ liefert beide Richtungen der Trams 1, 2 und 3 und die Busse, die dort halten. Ein Name, den es in zwei Gemeinden gibt („Poitou“), ergibt zwei Haltestellen: Die zweite schreibt Haltestelle suchen mit „-2“. Die Schaltfläche Haltestelle suchen liefert die Haltestellen mit einigen Wörtern, mit ihren Linien („Commerce → 1, 2, 3…“). Wenige Wörter genügen, wenn nur eine Haltestelle sie enthält („haluch“ → Haluchère - Batignolles). Verbindung testen fragt den Fahrplan erneut ab und liest sofort jede Haltestelle und jede Linie.
Eine Linie wird wie am Fahrzeug geschrieben: „1“ bis „3“ für die Trams, „4“ und „5“ für die Busways, „C1“ bis „C20“ für die Chronobusse, „N1“ bis „N3“ für die Navibus-Fähren, „26“, „NS“ (Nuit Sud)…
Mehr Haltestellen als die drei des Formulars (Zuhause, Arbeit, Schule…): Haltestelle hinzufügen nimmt dieselben drei Felder — Haltestelle, Linie, Richtung — und verfolgt bis zu 10 weitere Haltestellen. Haltestellen auflisten zeigt alle verfolgten Haltestellen, nummeriert; Haltestelle entfernen nimmt diese Nummer (oder den Namen). Die hinzugefügten Haltestellen werden in der Konfiguration von Gladys gespeichert und folgen so ihren Backups.
Der Fahrplan von Naolib ist eine große Datei: Die erste Abfrage, und die jeder neuen Datei, dauert etwa 20 Sekunden.
Verwendung
Geräte
Erstelle im Tab Entdecken die gewünschten Geräte:
- Naolib <Haltestelle>: die nächste Abfahrt als Text („1 → Beaujoire · 3 Min. (+2 Min. Verspätung)“), die Wartezeit der nächsten und der übernächsten Abfahrt (Minuten) und die Verspätung der nächsten (Minuten, nur veröffentlicht, wenn sie in Echtzeit verfolgt wird);
- Naolib Straßenbahn 1, Naolib Linie C1…: die Verkehrslage als Text („Verkehr gestört: Travaux boulevard de l'Estuaire“) und die Anzahl der laufenden Verkehrsmeldungen.
Nachts, ohne Abfahrt in den nächsten drei Stunden, zeigt das Gerät die erste Abfahrt des Morgens.
Verkehrslage
Naolib veröffentlicht Meldungen: einen Text, die betroffenen Linien (oder Haltestellen) und ihre Zeiträume. Der Zustand einer Linie ergibt sich aus ihrer schwersten laufenden Meldung: stark gestört bei einer Unterbrechung, gestört bei einer Umleitung, verlegten oder nicht bedienten Haltestellen, Verspätungen, sonst Verkehrsinformation; normal ohne Meldung. Eine Meldung, die in den nächsten drei Tagen beginnt, wird als bevorstehend angezeigt. Der Link zum Plan einer Umleitung öffnet sich, wenn vorhanden, über die Karte der Meldung.
Dashboard-Widgets
- Naolib Abfahrten: die nächsten Abfahrten einer Haltestelle, kompakt. Eine Zeile pro Linie und Ziel, mit ihren nächsten Abfahrten nacheinander („2 · 17 Min.“). Eine ausgefallene Fahrt wird angezeigt („entfällt 22:48“) und färbt die Zeile orange, wie eine Verspätung ab 5 Minuten. Die Einstellung Angezeigte Fahrten legt die Anzahl der Zeilen fest. Wähle eine verfolgte Haltestelle oder gib in den Widget-Einstellungen eine beliebige Haltestelle (und eine Linie) ein. Mit Mehrere Haltestellen zeigt ein Widget mehrere Haltestellengeräte: Die Geräte einer Haltestelle werden unter ihrem Namen zusammengeführt; bei verschiedenen Haltestellen beginnt jede mit einer eigenen Zeile.
- Naolib Verkehrslage: der Zustand jeder Linie, dann die laufenden Meldungen und die der nächsten drei Tage, mit ihrem Zeitraum. Tippe auf eine Karte für den vollständigen Text. Die verfolgten Linien, die in den Einstellungen eingegebenen, oder die drei Tramlinien, wenn du keine verfolgst.
Szenen
Auslöser, einmal pro Änderung (die erste Abfrage dient nur als Ausgangspunkt):
- Naolib: Abfahrt bald: Eine Abfahrt an einer verfolgten Haltestelle fährt in 2, 3, 5, 10, 15 oder 20 Minuten ab, gerechnet nach ihrer Echtzeitschätzung.
- Naolib: Abfahrt entfällt: Eine Fahrt der nächsten Stunde an einer verfolgten Haltestelle fällt aus oder bedient die Haltestelle nicht.
- Naolib: Linie gestört: Eine verfolgte Linie wird gestört oder stark gestört.
- Naolib: wieder normal: keine laufende Störung mehr auf der Linie.
- Naolib: neue Verkehrsmeldung: Naolib veröffentlicht eine Meldung zu einer verfolgten Linie, laufend oder bevorstehend.
Jeder liefert einen fertigen Satz, {{triggerEvent.data.summary}}, und seine Werte (Linie, Ziel, Uhrzeit, Verspätung, Titel, Text, Beginn und Ende…). Die Aktionen Naolib: nächste Abfahrten und Naolib: Verkehrslage einer Linie geben dieselbe Art von Werten zurück, für eine Nachricht oder eine Bedingung.
Beispiele:
- Wenn die Tram 1 Richtung Beaujoire in 5 Minuten an Commerce abfährt → die Flurlampe grün schalten.
- Wenn eine Abfahrt deiner Haltestelle entfällt oder die C1 umgeleitet wird → die Zusammenfassung vor dem Losgehen aufs Handy schicken.
- Jeden Werktag um 7:30 Uhr → die nächsten Abfahrten deiner Haltestelle lesen und vom Küchenlautsprecher ansagen lassen.
Transport
Nur Cloud: Die Daten kommen aus dem Internet. Der Fahrplan, wenn eine neue Datei erscheint, die Echtzeit des gesamten Netzes in einer Anfrage, die Meldungen alle 5 Minuten.
Fehlerbehebung
- „Unbekannt oder mehrdeutig“: Nutze Haltestelle suchen und kopiere den genauen Namen (mit seinem „-2“ für die zweite Haltestelle eines Namens); für eine Linie ihren Namen wie am Fahrzeug („1“, „C1“, „4“).
- „(Fahrplan)“ hinter einer Abfahrt: Ihre Fahrt ist noch nicht unterwegs, oder Naolib verfolgt sie nicht; die Uhrzeit ist die des Fahrplans.
- Keine Abfahrt in der eingegebenen Richtung: Die Ziele sind die an den Fahrzeugen angezeigten („Beaujoire“, „François Mitterrand“); leere die Richtung, um alle zu sehen.
- „Die Open Data von Naolib antworten nicht“: Die Integration versucht es bei jeder Abfrage erneut; bis dahin kommen die Abfahrten aus dem gespeicherten Fahrplan. Eine kurze Ablehnung der Echtzeit (ihre Quelle antwortet nur alle 30 Sekunden) fällt nicht auf: Die letzte Abfrage wird verwendet.
- Um ein Problem zu melden: Drücke Diagnose und kopiere die Zeilen, die mit „Naolib diagnostic“ beginnen, aus dem Tab Protokolle in ein GitHub-Issue oder eine Antwort im Forum, mit den Versionen von Gladys und der Integration.
Konfigurationseinstellungen
Diese Einstellungen fragt Naolib Nantes in seinem Konfigurationsbildschirm in Gladys ab.
| Einstellung | Typ | Pflichtfeld | Beschreibung |
|---|---|---|---|
| Naolib Open Data | section | Nein | Die Abfahrten und die Verkehrslage stammen aus den offiziellen Open Data von Naolib, den Trams und Bussen von Nantes Métropole: Fahrplan (GTFS) und Echtzeit (GTFS-RT) des gesamten Netzes (Trams, Busways, Chronobus, Busse, Navibus). Kein Konto und kein Schlüssel: Trage unten deine Haltestellen und Linien ein und drücke dann „Verbindung testen“. |
| Haltestelle 1 | section | Nein | Die Haltestelle, an der du die Tram oder den Bus nimmst: ihre nächsten Abfahrten nach dem in Echtzeit korrigierten Fahrplan, mit ihrer Verspätung. Gib ihren Namen so ein, wie er an der Haltestelle steht („Commerce“, „Gare Nord - Jardin des Plantes“): Die Schaltfläche „Haltestelle suchen“ liefert sie. Die Linie behält nur ihre Abfahrten („1“, „C1“, „4“). Die Richtung behält nur die Ziele mit diesen Wörtern („Gare Sud“, „Beaujoire | Ranzay“). |
| Haltestelle | string | Nein | |
| Linie | string | Nein | Leer für alle Linien. |
| Richtung | string | Nein | Wörter des Ziels. Leer für beide Richtungen. |
| Haltestelle 2 | section | Nein | |
| Haltestelle | string | Nein | |
| Linie | string | Nein | Leer für alle Linien. |
| Richtung | string | Nein | Wörter des Ziels. Leer für beide Richtungen. |
| Haltestelle 3 | section | Nein | Weitere Haltestellen (Zuhause, Arbeit, Schule…): Die Schaltfläche „Haltestelle hinzufügen“ unter dem Formular verfolgt bis zu 10 weitere, „Haltestellen auflisten“ zeigt alle nummeriert, und „Haltestelle entfernen“ beendet die Verfolgung einer Haltestelle. Die Echtzeit aller Haltestellen kommt in einer einzigen Anfrage. |
| Haltestelle | string | Nein | |
| Linie | string | Nein | Leer für alle Linien. |
| Richtung | string | Nein | Wörter des Ziels. Leer für beide Richtungen. |
| Verkehrslage der Linien | section | Nein | Die Linien, deren Verkehrslage du verfolgst: ein Gerät pro Linie, mit ihrem Zustand (normal, Verkehrsinformation, gestört, stark gestört) aus den Meldungen von Naolib und ihren Verkehrsmeldungen (Bauarbeiten, Umleitungen, nicht bediente Haltestellen), alle 5 Minuten gelesen. |
| Verfolgte Linien | string | Nein | Bis zu 6, durch Kommas getrennt. |
| Optionen | section | Nein | |
| Lesen der Echtzeit | select | Nein | Wie oft die Echtzeit des Netzes gelesen wird: eine einzige Anfrage für alle verfolgten Haltestellen. Solange keine Haltestelle in der nächsten halben Stunde etwas ankündigt (nachts), alle 10 Minuten. Der Fahrplan wird einmal am Tag gelesen. |
| Sprache der Texte | select | Nein | Namen der Geräte, Zusammenfassungen und Ausgaben der Szenen. Automatisch: die Sprache deines Dashboards, sobald ein Naolib-Widget angezeigt wurde. Haltestellennamen und Verkehrsmeldungen bleiben auf Französisch. |
So installierst du Naolib Nantes in Gladys
- Öffne in Gladys Integrationen: Naolib Nantes 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-naolib: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-naolib.
Naolib Nantes benötigt Gladys >=5.3.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
Naolib Nantes 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