Compteurs vélo Smart-Home-Integration, kostenlos und Open Source
Fahrradzähler französischer Städte (Open Data): Durchfahrten pro Tag und Woche, Rekorde.
Veröffentlicht von guim31
- Geräte
- Version 1.0.0
- Erfordert Gladys >=5.3.0
- ★ 0
Die Fahrradzähler, die französische Städte als Open Data veröffentlichen, in Gladys: wie viele Radfahrende gestern an „deinem“ Zähler vorbeigefahren sind, in den letzten 7 Tagen, und ob es ein Rekord war. Paris, Nantes Métropole, Tours Métropole, der Großraum Saint-Nazaire und die Departementsstraßen der Hauts-de-Seine. Kein Konto, kein Schlüssel.
Inoffizielle Integration, ohne Verbindung zu den Städten, zu Eco-Counter oder zu den Betreibern der Zähler. Keine Hardware im Spiel: die fünf Quellen wurden am 29.10.2026 live geprüft, Rückmeldungen sind willkommen.
Was du bekommst
- Ein Gerät pro hinzugefügtem Zähler (pro Fahrtrichtung, wenn die Stadt sie trennt): Durchfahrten des letzten vollständigen Tages, der letzten 7 Tage, von heute bisher und der letzten verfügbaren Stunde (je nach Stadt), sowie das Alter der Daten.
- Ein Widget „Fahrradzähler“: deine Zähler in je einer Zeile (letzter vollständiger Tag und Trend über eine Woche), mit einem 7-Tage-Diagramm.
- Zwei Szenen-Auslöser: Tagesrekord gebrochen, Zählerdaten verspätet.
- Eine Szenen-Aktion: die Zahlen eines Zählers, mit einem fertigen Satz zum Senden oder Sprechen.
Voraussetzungen
- Gladys Assistant 5.3.0 oder neuer.
- Internetzugang für Gladys: die Daten kommen von den Open-Data-Portalen der Städte.
- Kein Konto, kein API-Schlüssel.
Installation
- Öffne in Gladys Integrationen → Von GitHub installieren.
- Füge die Adresse
https://github.com/guim31/gladys-compteurs-veloein und bestätige. - Öffne die Integration nach der Installation: der Tab Konfiguration erscheint.
Konfiguration
Einstellungen
| Einstellung | Wirkung |
|---|---|
| Städte | die Städte, deren Zähler im Tab „Entdecken“ angeboten werden |
| Sprache der Namen | Sprache der Funktionsnamen und der Sätze der Szenen (Französisch) |
| Abfrageintervall | alle 30 Minuten, jede Stunde (Standard) oder alle 3 Stunden |
Die Funktionsnamen werden beim Hinzufügen eines Geräts festgelegt: wähle zuerst die Sprache.
Zähler hinzufügen
- Kreuze eine oder mehrere Städte an und speichere.
- Öffne den Tab Entdecken: jeder Zähler dieser Städte mit Daten in den letzten 17 Tagen erscheint dort als „Stadt · Zähler“.
- Füge die gewünschten zu Gladys hinzu. Deren Werte kommen sofort an.
Die hinzugefügten Zähler sind die überwachten Zähler: das Widget, die Auslöser und die Szenen-Aktion bieten sie an. Ein hinzugefügter Zähler wird weiter gelesen, auch wenn du seine Stadt danach abwählst.
Prüfen
Die Aktion Status im Tab „Konfiguration“ listet die gelesenen Städte, ihre Anzahl an Zählern, die Uhrzeit der letzten Abfrage, den letzten vollständigen Tag und den letzten Fehler, falls es einen gibt.
Geräte
| Funktion | Bedeutung | Städte |
|---|---|---|
| Letzter vollständiger Tag | Durchfahrten des letzten Tages, den die Stadt vollständig geliefert hat | alle |
| Letzte 7 Tage | Durchfahrten der 7 Tage bis zum letzten vollständigen Tag | alle |
| Heute bisher | bereits gelieferte Durchfahrten des laufenden Tages (0 bis zu den ersten Daten) | Tours, Saint-Nazaire |
| Letzte verfügbare Stunde | Durchfahrten der letzten gelieferten Stunde | Paris, Saint-Nazaire |
| Alter der Daten | Stunden seit dem Ende der letzten Daten | alle |
Ein Tag wird nie angezeigt, bevor er vollständig ist: die Städte liefern einmal am Tag, und der Tag, der gerade geliefert wird, bleibt aus „Letzter vollständiger Tag“ und „Letzte 7 Tage“ heraus. Ein Tag, der in der Quelle fehlt, wird nicht erfunden: es wird dann keine 7-Tage-Summe veröffentlicht, bis die Woche wieder vollständig ist (Paris hat keinen 25. Oktober 2026, die Nacht der Zeitumstellung). Ein stündlicher Tag, dem eine Stunde fehlt, ist auch nicht vollständig. Bis dahin behält die Funktion ihren letzten Wert einer vollständigen Woche.
Dashboard-Widget
„Fahrradzähler“: eine Zeile pro Zähler (höchstens 10), mit den Durchfahrten des letzten vollständigen Tages, „gestern“ oder seinem Datum, und dem Trend gegenüber der Vorwoche („↗ 12 %“). Grau, wenn die Daten verspätet sind. Darunter ein Diagramm der letzten 7 vollständigen Tage der ersten vier Zähler; eine Einstellung blendet es aus. Das Widget zeigt die Namen, die du in Gladys vergeben hast.
Szenen-Auslöser
| Auslöser | Löst aus, wenn |
|---|---|
| Tagesrekord gebrochen | ein neuer vollständiger Tag den besten Tag des Zählers übertrifft (Verlauf der Stadt) |
| Zählerdaten verspätet | die Daten 12 h, 1 Tag, 3 Tage oder 1 Woche verspätet sind, über die übliche Verzögerung hinaus |
Beide lassen sich auf bestimmte Zähler beschränken. Variablen: Zähler, Stadt, Durchfahrten und Tag, bisheriger Rekord und sein Tag; das Alter der Daten für einen verspäteten Zähler. Ein Tag, den Nantes als zweifelhaft markiert, ist nie ein Rekord.
Szenen-Aktion
Zahlen eines Fahrradzählers abrufen: Durchfahrten des letzten vollständigen Tages und sein Datum, der letzten 7 Tage (0, wenn ein Tag fehlt), der Trend in % zur Vorwoche (mit „Trend bekannt“ auf 0, wenn er sich nicht berechnen lässt), die Stunden Verspätung, und ein Satz wie „Pont Wilson: 1.934 Fahrräder am 27. Okt., 11.915 in 7 Tagen.“. „Vollständiger Tag bekannt“ ist 0, solange der Zähler noch keinen vollständigen Tag hat.
Szenen-Beispiele
- Jeden Morgen um 9 Uhr: die Zahlen deines Zählers abrufen und den Satz per Telegram senden.
- Tagesrekord gebrochen: eine Nachricht mit dem Zähler und seinen Durchfahrten senden (Variablen der Szene).
- Zählerdaten 3 Tage verspätet: eine Nachricht senden, der Zähler ist wohl defekt.
Daten und Aktualisierung
| Stadt | Portal | Schritt | Veröffentlichung |
|---|---|---|---|
| Paris | opendata.paris.fr (Opendatasoft) | Stunde | jeden Morgen, bis zum Vortag |
| Nantes Métropole | data.nantesmetropole.fr (Opendatasoft) | Tag | jeden Morgen, zwei Tage versetzt |
| Tours Métropole | data.tours-metropole.fr (Opendatasoft) | Tag | am späten Vormittag, mit dem laufenden Tag |
| Saint-Nazaire | data.saintnazaireagglo.fr (Opendatasoft) | Stunde | jeden Morgen, bis zu diesem Morgen |
| Hauts-de-Seine | opendata.hauts-de-seine.fr (Opendatasoft) | Tag | jede Nacht; ein Tag zählt, sobald der nächste da ist |
Der „Letzte vollständige Tag“ ist also meist gestern (Paris, Tours, Saint-Nazaire), vorgestern
(Hauts-de-Seine) oder drei Tage zuvor (Nantes). Eine aggregierte Anfrage pro Stadt und Abfrage
(eine mehr für die letzte Stunde in Paris und Saint-Nazaire), und einmal pro hinzugefügtem Zähler
der beste Tag seines Verlaufs, danach in /data gespeichert. Bei einer Abfrage pro Stunde sind das
einige Dutzend Anfragen am Tag, weit unter den Kontingenten der Portale für anonyme Nutzung.
Fehlerbehebung
- Kein Zähler in „Entdecken“: prüfe, ob eine Stadt angekreuzt und gespeichert ist, und starte dann die Aktion Status. Ein Fehler „HTTP 503“ oder „timeout“ kommt vom Portal der Stadt: versuche es später erneut.
- Die Werte ändern sich den ganzen Tag nicht: normal, die Städte veröffentlichen einmal am Tag.
- Eine graue Zeile im Widget: die Daten dieses Zählers sind verspätet (Zähler defekt oder Stadt verspätet).
- Für mehr Details setze
LOG_LEVEL=debug: jede Abfrage wird dann protokolliert.
Einschränkungen
- Toulouse aktualisiert seinen Eco-Counter-Datensatz seit Juni 2025 nicht mehr, Rennes seit Juli 2026; Montpellier war während der Tests nicht erreichbar; Lille, Angers und Brest veröffentlichen nur Jahres- oder Kampagnenzahlen; Anglet wechselt jedes Jahr den Datensatz. Diese Städte lassen sich ergänzen, sobald es einen täglichen Datenstrom gibt.
- Zahlen so, wie die Städte sie veröffentlichen (rohe Eco-Counter-Zählungen, manchmal später korrigiert).
- Nur lesend.
Danksagung
- Daten: Ville de Paris, Nantes Métropole, Syndicat des Mobilités de Touraine, Saint-Nazaire agglo – La CARENE und Département des Hauts-de-Seine, unter ihren offenen Lizenzen (ODbL / Licence Ouverte).
- Aufgebaut auf der offiziellen Gladys-Integrationsvorlage.
Konfigurationseinstellungen
Diese Einstellungen fragt Compteurs vélo in seinem Konfigurationsbildschirm in Gladys ab.
| Einstellung | Typ | Pflichtfeld | Beschreibung |
|---|---|---|---|
| So funktioniert es | section | Nein | Kreuze deine Städte an und speichere: ihre Fahrradzähler erscheinen im Tab „Entdecken“. Füge die gewünschten zu Gladys hinzu. Kein Konto, kein Schlüssel. Die Städte veröffentlichen einmal am Tag: die Zahlen sind vom Vortag oder älter. |
| Städte | multi_select | Nein | Täglich als Open Data veröffentlichte Fahrradzähler. Andere Städte: siehe Anleitung. |
| Sprache der Namen | select | Nein | Namen der Funktionen (beim Hinzufügen festgelegt) und Sätze der Szenen. |
| Abfrageintervall | select | Nein | Wie oft die Portale abgefragt werden. Diese veröffentlichen einmal am Tag, morgens. |
So installierst du Compteurs vélo in Gladys
- Öffne in Gladys Integrationen: Compteurs vélo erscheint im Katalog neben den nativen Integrationen, mit einem Community-Badge.
- Klicke auf Installieren. Gladys lädt das Docker-Image (
ghcr.io/guim31/gladys-compteurs-velo:1.0.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/guim31/gladys-compteurs-velo.
Compteurs vélo 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
Compteurs vélo 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 guim31 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