Zum Hauptinhalt springen

Île-de-France Mobilités Smart-Home-Integration, kostenlos und Open Source

Île-de-France Mobilités-Integration für Gladys Assistant

RER, Transilien, Metro, Tram, Bus: Abfahrten und Verkehr in Echtzeit.

Diese Integration verfolgt den öffentlichen Nahverkehr im Großraum Paris in Echtzeit in Gladys: die nächsten Abfahrten an deinen Haltestellen — RER, Transilien, Metro, Tram, Bus — mit ihren Verspätungen und Ausfällen, und den Verkehr deiner Linien (Störungen, Bauarbeiten). Daraus macht sie Geräte, Szenen-Auslöser („mein RER fällt aus“, „meine Metro fährt in 5 Minuten“, „Linie 13 ist gestört“) und Dashboard-Widgets.

Die Daten stammen von PRIM, der Open-Data-Plattform von Île-de-France Mobilités, und aus ihren offenen Referenzdaten (Linien und Haltestellen).

Community-Integration, nicht verbunden mit Île-de-France Mobilités, SNCF oder RATP.

Konfiguration​

1. Einen API-Schlüssel holen (kostenlos)​

  1. Erstelle ein Konto auf prim.iledefrance-mobilites.fr.
  2. Öffne im Menü deines Kontos Mes jetons d'authentification (meine Authentifizierungs-Token), Tab API, und klicke auf Générer mon jeton.
  3. Kopiere das Token sofort: Es wird nur einmal angezeigt (ein neues zu erzeugen macht das alte ungültig).

Ein neues Konto erlaubt 1 000 Anfragen pro Tag und API: genug für ein oder zwei Haltestellen mit Zeitfenster. Für mehr beantragst du auf der Seite Ma consommation API kostenlos ein höheres Kontingent (bis zu 1 000 000 pro Tag für die Abfahrten) und trägst es dann in der Einstellung Tageskontingent der Abfahrten ein.

2. Die verfolgten Haltestellen (bis zu 3)​

FeldRolle
Haltestelleder Name der Haltestelle („Massy - Palaiseau“, „Châtelet“) oder ihre Nummer aus Haltestelle suchen
Linieoptional, aber empfohlen: „RER B“, „Transilien P“, „Métro 13“, „T3a“, „Bus 91“, „C01743“
Richtungoptional: Wörter des Ziels („Robinson“, „Saint-Rémy | Massy“ für zwei Richtungen)
Zeitfensteroptional, z. B. 07:00-09:30
Reisetageoptional, z. B. Montag bis Freitag (leer: jeden Tag)

Bei einer Linie ohne Verkehrsmittel ist ein Buchstabe eine Zuglinie („B“ = RER B, „P“ = Transilien P) und eine Zahl eine Metrolinie vor einer Buslinie („13“ = Metro 13). Für einen Bus schreibe „Bus 91“; haben mehrere Netze eine Linie mit dieser Nummer, nutze die Kennung aus Linie suchen („C01122“).

Mit einer Linie wird der Haltestellenname unter den Haltestellen dieser Linie gesucht: am zuverlässigsten. Ohne Linie nimmt die Integration die Haltestelle, deren Name genau passt, Bahnhöfe zuerst, und zeigt alle ihre Linien. Ist es nicht die richtige Haltestelle, nutze Haltestelle suchen und kopiere ihre Nummer.

Das Zeitfenster​

Die nächsten Abfahrten sind nur zwei Stunden im Voraus bekannt. Mit einem Zeitfenster wird die Haltestelle nur ab einer Stunde vor dem Fenster bis zu seinem Ende gelesen, und den Rest der Zeit gar nicht. Das spart viel Kontingent: Eine Haltestelle mit einem 2-stündigen Zeitfenster an Werktagen kostet etwa 65 Anfragen pro Tag, eine ganztägig gelesene etwa 600.

Bräuchten die eingerichteten Haltestellen mehr als das Kontingent, verteilt die Integration die Abfragen selbst (die Schaltfläche Verbindung testen zeigt das tatsächlich verwendete Intervall).

3. Der Verkehr​

Gib unter Verfolgte Linien bis zu 6 Linien durch Kommas getrennt ein: RER B, Transilien P, Métro 13. Das ganze Netz wird mit einer einzigen Anfrage alle 5 Minuten gelesen (einstellbar), etwa 290 Anfragen pro Tag, unabhängig von der Zahl der Linien.

Eine Linie ist:

  • unterbrochen, wenn eine unterbrechende Störung gilt (kein Zug auf der ganzen Linie oder einem Teil davon);
  • gestört, wenn eine Störung gilt, ohne den Verkehr zu unterbrechen (Verlangsamungen, ausgelassene Halte …);
  • normal sonst. Reine Informationsmeldungen (ein defekter Aufzug …) zählen nicht.

Speichere und klicke dann auf Verbindung testen: Für jede Haltestelle zeigt es die gefundenen Abfahrten und die nächste, den Zustand jeder Linie und das verbrauchte Kontingent.

4. Die Geräte hinzufügen​

Im Tab Entdecken erscheint jede Haltestelle als „IDFM – Haltestelle (Linie → Richtung)“ und jede verfolgte Linie als „IDFM – Verkehr Linie“. Füge sie hinzu und ordne sie einem Raum zu.

GerätFunktionWert
HaltestelleNächste AbfahrtText, z. B. „07:42 · RER B KASE → Aéroport CDG 2 · +5 min“
HaltestelleAbfahrt inMinuten, Echtzeit
HaltestelleVerspätungMinuten (Züge mit Fahrplan; bei der Metro, die keinen hat, immer 0)
HaltestelleGestörte Abfahrtenwie viele verfolgte Abfahrten verspätet (ab der Schwelle) oder ausgefallen sind
LinieVerkehrText: „Normaler Verkehr“, „Gestört: …“, „Unterbrochen: …“
LinieAktuelle Störungendie jetzt geltenden Störungen (Informationsmeldungen ausgenommen)

Die Gerätenamen und die Szenen-Zusammenfassungen folgen der Einstellung Sprache der Texte: Englisch, Französisch, Deutsch, Spanisch oder automatisch (die Sprache deines Dashboards, sobald ein IDFM-Widget angezeigt wurde).

Auf dem Bildschirm Geräte zeigt das Badge jeder Haltestelle und Linie cloud, solange die PRIM-API antwortet, unerreichbar, wenn ihre letzte Abfrage fehlschlug, und wird orange, wenn die Abfragen wegen des Tageskontingents pausieren.

Szenen​

Auslöser​

AuslöserWann
IDFM: Zug verspätetein verfolgter Zug verspätet sich (ab der Schwelle), dann erneut bei 15 und 30 min
IDFM: Abfahrt fällt auseine verfolgte Abfahrt fällt aus
IDFM: Abfahrt in Kürzeeine verfolgte Abfahrt erfolgt in 2, 5, 10, 15, 20 oder 30 Minuten, nach der echten Zeit
IDFM: Linie gestörteine neue Störung betrifft eine verfolgte Linie (Filter: Schwere, Störung/Bauarbeiten)
IDFM: Verkehr wieder normaleine verfolgte Linie, die gestört war, fährt wieder normal

Jedes Ereignis liefert eine Variable Zusammenfassung, einen Satz, der direkt verschickt werden kann: „Massy - Palaiseau: RER B KASE → Aéroport CDG 2 fährt in 15 min ab, um 07:42 (4 min Verspätung).“ oder „RER B: Unterbrochen. Trafic interrompu entre Massy et Paris.“.

Ein Ereignis löst nur einmal pro Abfahrt oder Störung aus, auch nach einem Neustart.

Aktionen​

  • IDFM: nächste Abfahrten: die nächste Abfahrt einer Haltestelle (Linie, Ziel, Uhrzeit, Verspätung, Gleis …) und eine Zusammenfassung, zum Beispiel um „meinen nächsten RER anzusagen, wenn ich aus der Dusche komme“.
  • IDFM: Verkehr einer Linie: der Zustand einer Linie, ihre wichtigste Störung und eine Zusammenfassung.

Widgets​

Das Widget „IDFM-Abfahrten“ (die nächsten RER B in Massy - Palaiseau, einer verspätet, einer fällt aus) neben dem Widget „IDFM-Verkehr“ (RER B unterbrochen, Bauarbeiten auf Linie 13 geplant) — generierte Illustration, kein Screenshot

  • IDFM-Abfahrten: die nächsten Abfahrten einer Haltestelle wie auf den Anzeigetafeln am Bahnhof, mit „N min“, „+N min“, „Fällt aus“ oder „Am Bahnsteig“. Wähle eine verfolgte Haltestelle oder gib eine andere Haltestelle (und ihre Linie) direkt im Widget ein — sie verbraucht dann bei jeder Aktualisierung Kontingent.
  • IDFM-Verkehr: der Zustand jeder verfolgten Linie (oder der im Widget eingegebenen), dann die aktuellen Störungen und die in den nächsten 24 Stunden geplanten; tippe auf eine, um die ganze Meldung zu lesen.

Häufige Fragen​

Keine Verspätung bei der Metro? Die Metro und die meisten Busse haben keinen Fahrplan in den Echtzeitdaten: Nur die Wartezeit ist bekannt. Die Verspätung und der Auslöser „Zug verspätet“ betreffen RER, Transilien und Linien mit Fahrplan.

Das Widget zeigt „Abfahrten von 07:00-09:30 werden ab 06:00 angezeigt“. Das ist normal: Außerhalb des Zeitfensters wird die Haltestelle nicht gelesen.

Gerätenamen oder Zusammenfassungen auf Englisch? Stelle in den Einstellungen Sprache der Texte ein oder öffne einmal ein IDFM-Widget.

„Der PRIM-API-Schlüssel wird abgelehnt“. Das Token wurde falsch kopiert oder inzwischen neu erzeugt: Erzeuge ein neues und füge es ein.

„Tageskontingent erreicht“. Gib deinen Haltestellen ein Zeitfenster, verlangsame die Aktualisierung oder beantrage bei PRIM ein höheres Kontingent (kostenlos) und trage es in den Einstellungen ein.

Konfigurationseinstellungen​

Diese Einstellungen fragt Île-de-France Mobilités in seinem Konfigurationsbildschirm in Gladys ab.

EinstellungTypPflichtfeldBeschreibung
PRIM-API-SchlüsselsectionNeinDie Daten stammen von PRIM, der Open-Data-Plattform von Île-de-France Mobilités: Echtzeit-Abfahrten von RER, Transilien, Metro, Tram und Bus sowie die Verkehrsstörungen. Der Schlüssel ist kostenlos: Erstelle ein Konto und erzeuge dann ein Token unter „Mes jetons d’authentification“. Ein neues Konto erlaubt 1 000 Anfragen pro Tag und API; die Integration zählt sie und verteilt ihre Abfragen, um darunter zu bleiben.
API-SchlüsselsecretJaDas auf PRIM erzeugte Token (wird nur einmal angezeigt).
Haltestelle 1sectionNeinDie Haltestelle, an der du in Zug, Metro, Tram oder Bus einsteigst, und ihre Linie: Die Abfahrten werden in Echtzeit gelesen. Ein Haltestellenname („Massy - Palaiseau“) oder ihre Nummer aus der Schaltfläche „Haltestelle suchen“. Mit einer Linie wird der Name unter ihren Haltestellen gesucht. Die Richtung behält nur die Abfahrten, deren Ziel diese Wörter enthält („Robinson“, „Saint-Rémy | Massy“). Das Zeitfenster spart Kontingent: Die Haltestelle wird dann nur ab einer Stunde davor bis zu seinem Ende gelesen.
HaltestellestringNein
LiniestringNeinRER B, Transilien P, Métro 13, T3a, Bus 91 … Leer: alle Linien der Haltestelle.
RichtungstringNeinWörter des Ziels. Leer: alle Richtungen.
ZeitfensterstringNeinAbfahrten zwischen diesen Uhrzeiten, z. B. 07:00-09:30. Leer: den ganzen Tag.
Reisetagemulti_selectNeinLeer: jeden Tag.
Haltestelle 2 (optional)sectionNeinDieselben Felder wie bei Haltestelle 1, zum Beispiel für die Rückfahrt. Leer lassen, wenn nicht benötigt.
HaltestellestringNein
LiniestringNeinRER B, Transilien P, Métro 13, T3a, Bus 91 … Leer: alle Linien der Haltestelle.
RichtungstringNeinWörter des Ziels. Leer: alle Richtungen.
ZeitfensterstringNeinAbfahrten zwischen diesen Uhrzeiten, z. B. 07:00-09:30. Leer: den ganzen Tag.
Reisetagemulti_selectNeinLeer: jeden Tag.
Haltestelle 3 (optional)sectionNeinDieselben Felder wie bei Haltestelle 1, zum Beispiel für die Rückfahrt. Leer lassen, wenn nicht benötigt.
HaltestellestringNein
LiniestringNeinRER B, Transilien P, Métro 13, T3a, Bus 91 … Leer: alle Linien der Haltestelle.
RichtungstringNeinWörter des Ziels. Leer: alle Richtungen.
ZeitfensterstringNeinAbfahrten zwischen diesen Uhrzeiten, z. B. 07:00-09:30. Leer: den ganzen Tag.
Reisetagemulti_selectNeinLeer: jeden Tag.
VerkehrsectionNeinDie Linien, deren Verkehr du verfolgst: ein Gerät pro Linie (normal, gestört, unterbrochen), Szenen, wenn eine Störung beginnt oder endet, und ein Widget. Das ganze Netz wird alle paar Minuten mit einer einzigen Anfrage gelesen.
Verfolgte LinienstringNeinBis zu 6, durch Kommas getrennt.
EinstellungensectionNeinMit den Standardwerten kostet eine ganztägig gelesene Haltestelle etwa 600 Anfragen pro Tag, eine Haltestelle mit einem 2-stündigen Zeitfenster an Werktagen etwa 65. Würden die Haltestellen mehr als das Tageskontingent brauchen, liest die Integration sie von selbst seltener.
Verfolgte Abfahrten pro HaltestellenumberNeinDie nächsten Abfahrten jeder Haltestelle, zwischen 1 und 8.
Verspätungsschwelle (min)numberNeinAb wie vielen Minuten ein Zug als verspätet gilt (Szenen, gestörte Abfahrten, Farben).
Aktualisierung der Abfahrten (min)numberNeinInnerhalb des Zeitfensters (ohne Zeitfenster den ganzen Tag), zwischen 1 und 30 Minuten.
Aktualisierung des Verkehrs (min)numberNeinZwischen 2 und 60 Minuten.
Tageskontingent der AbfahrtennumberNeinDas Tageskontingent der API „Prochains passages (requête unitaire)“ deines Kontos: 1 000 bei einem neuen Konto. Erhöhe es hier, nachdem du bei PRIM mehr beantragt hast (kostenlos).
Sprache der TexteselectNeinGerätenamen, Zusammenfassungen und Ausgaben der Szenen. Automatisch: die Sprache deines Dashboards, sobald ein IDFM-Widget angezeigt wurde.

So installierst du Île-de-France Mobilités in Gladys​

  1. Öffne in Gladys Integrationen: Île-de-France Mobilités erscheint im Katalog neben den nativen Integrationen, mit einem Community-Badge.
  2. Klicke auf Installieren. Gladys lädt das Docker-Image (ghcr.io/william-de71/gladys-idfm:1.1.1) herunter, startet es in einer vom Kern isolierten Sandbox und erzeugt die Oberfläche der Integration (Geräte, Erkennung und Konfiguration).
  3. Öffne den Bildschirm Konfiguration der Integration, fülle die Einstellungen aus und speichere.
  4. Du kannst sie auch direkt über die URL ihres Repositorys installieren: https://github.com/William-De71/gladys-idfm.

Île-de-France Mobilités benötigt Gladys >=5.1.1. 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​

Île-de-France Mobilités 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.

Abonniere den Newsletter von Gladys Assistant

Ein paar E-Mails im Monat zu neuen Releases und Neuigkeiten aus dem Projekt. Verschickt von Pierre-Gilles Leymarie, dem Gründer des Projekts. Jederzeit abbestellbar 🙂