Piscines et patinoires Smart-Home-Integration, kostenlos und Open Source
Live-Andrang städtischer Schwimmbäder und Eisbahnen in Frankreich (Open Data): Straßburg, Bordeaux
Veröffentlicht von guim31
- Geräte
- Version 1.1.0
- Erfordert Gladys >=5.3.0
- ★ 0
Andrang und Öffnung städtischer Schwimmbäder französischer Städte, live von ihren Open-Data-Portalen gelesen: die Schwimmbäder der Eurométropole de Strasbourg und die der Stadt Bordeaux. Kein Konto, kein Schlüssel.
Inoffizielle Integration, ohne Verbindung zu den Städten, Métropoles oder Betreibern der Bäder. Entwickelt ohne Zugang zu den Anlagen: Die Quellen wurden am 29.10.2026 live geprüft (nachts, Bäder geschlossen). Rückmeldungen sind willkommen.
Eisbahn: Die Eisbahn Iceberg in Straßburg veröffentlicht ihren Andrang im selben Format wie die Schwimmbäder. Du kreuzt sie separat an, „Straßburg (Eisbahn Iceberg)“ unter Städte: Die Eisbahn bekommt dasselbe Gerät („Strasbourg · Patinoire l'Iceberg“), dieselben Auslöser, dasselbe Widget und dieselbe Szenen-Aktion wie die Straßburger Schwimmbäder. Alles, was diese Anleitung über Schwimmbäder sagt, gilt auch für sie.
Was du bekommst
- Ein Gerät pro Schwimmbad, das du hinzufügst: geöffnet oder geschlossen, anwesende Personen, Kapazität und Auslastung, Andrang, heutige Öffnungszeiten und Alter der Daten (je nach Stadt).
- Ein Widget „Schwimmbäder“: deine Bäder in je einer Zeile, mit Andrang und Schließzeit, grün, orange oder rot je nach Auslastung.
- Vier Szenen-Auslöser: Schwimmbad öffnet, Schwimmbad schließt, Andrang über einer Schwelle, Andrang unter einer Schwelle.
- Eine Szenen-Aktion: der Zustand deiner Bäder in einem fertigen Satz.
Voraussetzungen
- Gladys Assistant 5.3.0 oder neuer.
- Internetzugang von Gladys aus: 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
https://github.com/guim31/gladys-piscinesein und bestätige. - Öffne die Integration nach der Installation: Der Tab Konfiguration erscheint.
Konfiguration
Einstellungen
| Einstellung | Wirkung |
|---|---|
| Städte | die Städte, deren Schwimmbäder im Tab „Entdecken“ angeboten werden |
| Aktualisierung | alle 3, 5 (Standard) oder 10 Minuten |
| Sprache der Namen und Nachrichten | Sprache der Funktionsnamen, der Texte, des Widgets und der Szenen-Sätze |
Die Namen der Funktionen werden beim Hinzufügen festgelegt: Wähle die Sprache vorher.
Schwimmbäder hinzufügen
- Kreuze eine oder mehrere Städte an und speichere.
- Öffne den Tab Entdecken: Die Schwimmbäder dieser Städte erscheinen dort als „Stadt · Bad“.
- Füge die gewünschten zu Gladys hinzu. Die Werte kommen sofort.
Die hinzugefügten Bäder sind die überwachten Schwimmbäder: Widget, Auslöser und Szenen-Aktion bieten sie an. Ein hinzugefügtes Bad wird weiter gelesen, auch wenn du seine Stadt danach abwählst.
Prüfen
Die Aktion Status im Tab Konfiguration listet die gelesenen Städte, die Zahl der gefundenen Bäder, die Zeit der letzten Abfrage, den letzten Fehler und die Zahl der hinzugefügten Bäder.
Geräte
Jedes hinzugefügte Schwimmbad ist ein schreibgeschütztes Gerät. Seine Funktionen hängen davon ab, was die Stadt veröffentlicht:
| Funktion | Gladys-Typ | Wert | Straßburg | Bordeaux |
|---|---|---|---|---|
| Geöffnet | binär | 1 geöffnet, 0 geschlossen | ja | nein |
| Anwesende Personen | Zähler | Personen im Bad | ja | ja |
| Kapazität | Zähler | gleichzeitig zugelassene Personen | nein | ja |
| Auslastung | Füllstand (%) | anwesende Personen / Kapazität | nein | ja |
| Andrang | Text | ruhig, mäßig voll, voll, überfüllt oder „geschlossen“ | ja | nein |
| Heutige Öffnungszeiten | Text | zum Beispiel „07:00–14:30, 16:00–20:00“ | ja | nein |
| Alter der Daten | Dauer (Minuten) | Alter der Zählung, nach der Zeitangabe der Stadt | ja | ja |
Kein Wert wird erfunden: Straßburg veröffentlicht keine Zählung, solange ein Bad geschlossen ist (vor allem nachts). Die Personenzahl wird dann nicht aktualisiert (der letzte Wert bleibt sichtbar), und Andrang zeigt „geschlossen“. Der Andrang ist die vom Betreiber veröffentlichte Stufe (grün, orange, rot, schwarz), die die geöffneten Becken berücksichtigt.
Bordeaux zählt pro Zone: Die Integration addiert die Zonen eines Bads, ohne die Tribünen (Zuschauer). Bordeaux veröffentlicht weder den Zustand geöffnet/geschlossen noch die Zeiten.
Nach 45 Minuten ohne Aktualisierung durch die Stadt gelten die Daten als veraltet.
Dashboard-Widget
Füge das Widget Schwimmbäder zu einem Dashboard hinzu. Es zeigt eine Zeile pro überwachtem Bad (höchstens zehn), unter dem Namen, den du ihm in Gladys gegeben hast, zum Beispiel „85 Pers. · ruhig · bis 20:00“ oder „geschlossen · öffnet um 07:00“. In den Einstellungen: die angezeigten Bäder (leer: alle) und ob die Öffnungszeiten angezeigt werden.
Farben: die Stufe des Betreibers in Straßburg (grün ruhig, orange mäßig voll, rot voll oder überfüllt); die Auslastung in Bordeaux (orange ab 70 %, rot ab 90 %); grau, wenn das Bad geschlossen ist, keine Zählung hat oder die Daten veraltet sind.
Szenen-Auslöser
| Auslöser | Wird ausgelöst, wenn |
|---|---|
| Schwimmbad öffnet | das Bad von geschlossen auf geöffnet wechselt (Straßburg) |
| Schwimmbad schließt | das Bad von geöffnet auf geschlossen wechselt (Straßburg) |
| Andrang über einer Schwelle | die Personenzahl über die gewählte Schwelle steigt (20, 50, 100, 150, 200, 300) |
| Andrang unter einer Schwelle | die Personenzahl eines geöffneten Bads auf die Schwelle oder darunter fällt |
Das Feld Schwimmbäder filtert die betroffenen Bäder; leer: jedes überwachte Bad. Variablen für die folgenden Aktionen: Schwimmbad, Stadt, anwesende Personen, Auslastung (0 wenn unbekannt).
Die Auslöser vergleichen zwei aufeinanderfolgende Abfragen: Nach einem Ausfall des Portals und bei veralteten Daten wird nichts ausgelöst. Bei einer Wiedereröffnung beginnt die Zählung bei null. In Bordeaux, das den Zustand geöffnet/geschlossen nicht veröffentlicht, löst der Abfall auf 0 bei der Schließung „Andrang unter einer Schwelle“ nicht aus. Eine Zahl, die um eine Schwelle schwankt, löst bei jedem Überschreiten aus.
Szenen-Aktion
Andrang der Schwimmbäder abrufen: deine überwachten Bäder (oder die gewählten) in einem Satz. Ergebnisse:
sentence: „Piscine du Wacken: 85 Personen (ruhig), geöffnet bis 20:00. Piscine de Hautepierre: geschlossen.“;open_count: Zahl der geöffneten Bäder (Städte, die den Zustand veröffentlichen);people: Summe der anwesenden Personen.
Der Satz folgt der in der Konfiguration gewählten Sprache.
Szenen-Beispiele
- Vor dem Schwimmen: ein Knopf oder eine feste Uhrzeit, Aktion „Andrang der Schwimmbäder
abrufen“, dann „Nachricht senden“ mit
sentence. - Ruhige Zeit: Auslöser „Andrang unter einer Schwelle“ (dein Bad, Schwelle 50), dann eine Benachrichtigung „Jetzt ist ein guter Moment“.
- Bad geöffnet: Auslöser „Schwimmbad öffnet“ am Samstagmorgen, dann eine Nachricht.
Daten und Aktualisierung
| Stadt | Portal | Datensatz | Lizenz |
|---|---|---|---|
| Straßburg | data.strasbourg.eu (Opendatasoft) | Fréquentation en temps réel des piscines | Licence Ouverte |
| Bordeaux | opendata.bordeaux-metropole.fr (Opendatasoft) | Fréquentation temps réel des piscines (ville) | Licence Ouverte |
| Straßburg | data.strasbourg.eu (Opendatasoft) | Fréquentation en temps réel de la patinoire Iceberg | Licence Ouverte |
Eine Anfrage pro Stadt und Abfrage, einige Kilobyte. Die Städte aktualisieren ihre Daten alle 5 bis 10 Minuten; bei 5 Minuten sind das 288 Anfragen pro Tag und Stadt, weit unter den Kontingenten der Portale für anonyme Nutzung. Nur die angekreuzten Städte und die der hinzugefügten Bäder werden gelesen.
Fehlerbehebung
- Kein Schwimmbad in „Entdecken“: Prüfe, ob eine Stadt angekreuzt und gespeichert ist, und starte die Aktion Status. Ein Fehler „HTTP 503“ oder „timeout“ kommt vom Portal der Stadt: versuche es später erneut.
- „Daten veraltet“ im Widget: Die Stadt hat dieses Bad seit mehr als 45 Minuten nicht aktualisiert.
- Keine Personenzahl: Das Bad ist geschlossen, oder die Stadt veröffentlicht gerade keine Zählung. Nichts wird erfunden.
- Keine Funktion „Geöffnet“ und keine Zeiten: Die Stadt veröffentlicht sie nicht (Bordeaux).
- Für mehr Details setze
LOG_LEVEL=debug: Jede Abfrage wird dann protokolliert.
Einschränkungen
- Nur Straßburg und Bordeaux veröffentlichen heute den Andrang ihrer Bäder live. Nantes, Toulouse, Paris, Rennes oder Montpellier veröffentlichen nur statische Daten (Adressen, Ausstattung) und kommen hinzu, sobald ein Live-Feed erscheint.
- Die Zahlen stammen von den Betreibern (Zählung der Ein- und Ausgänge) und können von der Wirklichkeit abweichen, vor allem gegen Ende des Tages.
- Straßburg gibt keine Kapazität an, daher keine Auslastung.
- Nur lesend: keine Reservierung, keine Bezahlung.
- Eisbahnen: Nur die Straßburger (Iceberg) veröffentlicht heute ihren Andrang live; Toulouse veröffentlicht nur eine statische Liste.
Danksagung
- Daten: Eurométropole de Strasbourg und Bordeaux Métropole, unter der Licence Ouverte (Etalab).
- Gebaut auf Basis der offiziellen Integrationsvorlage.
Konfigurationseinstellungen
Diese Einstellungen fragt Piscines et patinoires in seinem Konfigurationsbildschirm in Gladys ab.
| Einstellung | Typ | Pflichtfeld | Beschreibung |
|---|---|---|---|
| So funktioniert es | section | Nein | Kreuze deine Städte an und speichere: ihre Schwimmbäder und Eisbahnen erscheinen im Tab „Entdecken“. Füge die gewünschten zu Gladys hinzu. Kein Konto, kein Schlüssel. |
| Städte | multi_select | Nein | Schwimmbäder und Eisbahnen, deren Andrang live als Open Data veröffentlicht wird. Andere Städte: siehe Anleitung. |
| Aktualisierung | select | Nein | |
| Sprache der Namen und Nachrichten | select | Nein | Die Namen der Funktionen werden beim Hinzufügen festgelegt. |
So installierst du Piscines et patinoires in Gladys
- Öffne in Gladys Integrationen: Piscines et patinoires erscheint im Katalog neben den nativen Integrationen, mit einem Community-Badge.
- Klicke auf Installieren. Gladys lädt das Docker-Image (
ghcr.io/guim31/gladys-piscines:1.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/guim31/gladys-piscines.
Piscines et patinoires 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
Piscines et patinoires 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