Qualité de l'air Smart-Home-Integration, kostenlos und Open Source
Luftqualitätsindex jeder Stadt der Welt, auf Basis der CAMS-Daten von Copernicus.
Veröffentlicht von prohand
- Geräte
- Version 2.5.1
- Erfordert Gladys >=5.2.0
- ★ 0
Verfolge den Luftqualitätsindex der Orte deiner Wahl in Gladys, mit einem Gerät pro Ort. Du fügst deine Gladys-Häuser mit einem Klick hinzu oder einen Ort, indem du den Namen seiner Stadt eingibst, überall auf der Welt.
Kein Konto anzulegen, kein API-Schlüssel einzufügen: Beide Quellen, die diese Integration nutzt, sind offen und öffentlich.
Deine Gladys-Häuser mit einem Klick hinzufügen
Du hast Gladys bereits gesagt, wo du wohnst: Das ist die Karte unter Einstellungen > Zuhause. Die Schaltfläche „Meine Gladys-Häuser hinzufügen“ liest diese Häuser und legt für jedes noch nicht überwachte einen Ort an — ohne eine Stadt einzugeben.
Drei Dinge, die du wissen solltest:
- Der Zugriff ist eine Berechtigung. Wo du wohnst, sind personenbezogene Daten: Gladys teilt sie nur, wenn du die Anfrage auf dem Installationsbildschirm der Integration angenommen haben. Antwortet die Schaltfläche, dass der Zugriff verweigert wird, entferne die Integration und installiere sie neu, wobei du die angezeigte Anfrage annimmst.
- Ein Haus, das du nie auf der Karte platziert hast, hat keine Koordinaten. Es wird in der Antwort genannt; verorte es unter Einstellungen > Zuhause und führe die Aktion erneut aus.
- Das ist keine Synchronisierung. Die Häuser werden in dem Moment gelesen, in dem du klickst. Heraus kommt ein gewöhnlicher Ort, der wie die anderen umbenannt und entfernt wird, und ein später in Gladys verschobenes Haus verschiebt seinen Ort nicht.
Um nur eines deiner Häuser hinzuzufügen — ein Ferienhaus, das nicht überwacht werden soll, bleibt außen vor —, wähle es im Feld Haus der Schaltfläche; bleibt es leer, werden alle Häuser hinzugefügt.
Erneutes Klicken ist unbedenklich: Ein bereits überwachtes Haus wird gemeldet, nicht ein zweites Mal hinzugefügt. Ein Ort, der aus einem Haus stammt, hat keine Adressbezeichnung: Die Liste zeigt seinen Namen und seinen Punkt, weil der Geocoder die Stadt, in der ein Punkt liegt, nicht benennen kann.
Einen Ort hinzufügen
- Öffne den Tab Konfiguration der Integration.
- Klicke im Abschnitt „Deine Orte“ auf Ort hinzufügen.
- Gib die Stadt ein — „Nantes“, „Montreal“, „Kyoto“ — und optional einen Namen für diesen Ort („Zuhause“, „Büro“…). Ohne Namen übernimmt der Ort den Namen des gefundenen Orts.
- Die Antwort erscheint unter der Schaltfläche. Bei Erfolg bestätigt sie das Hinzufügen und nennt dir die Nummer des Orts.
- Geh zum Tab Entdecken: Das Gerät „Qualité de l'air — dein Ort“ („Luftqualität — dein Ort“, wenn die Sprache der Gerätenamen Deutsch ist) wartet dort. Klicke auf Zu Gladys hinzufügen, um es anzulegen.
Ein Name, mehrere Orte
Die meisten Städtenamen sind mehrfach vergeben: Allein in Frankreich gibt es mehrere Montauban, ein Paris in Texas und ein Springfield pro US-Bundesstaat. In diesem Fall entscheidet die Integration nicht für dich — sie antwortet mit der Liste der gefundenen Orte und bittet dich, genauer zu werden.
Grenze nach einem Komma ein: die Region, das Departement, den Bundesstaat, das Land oder die Postleitzahl, in beliebiger Reihenfolge.
- „Montauban, Tarn-et-Garonne“
- „Springfield, Illinois“
- „Nantes, 44000“
- „Paris, France“
Akzente und Groß-/Kleinschreibung spielen keine Rolle: „saint-etienne“ findet „Saint-Étienne“.
Oder direkt ein Punkt
Kennt der Geocoder deinen Weiler nicht oder möchtest du einen genauen Punkt von einer Karte übernehmen, gib stattdessen Breitengrad und Längengrad ein (WGS-84-Dezimalgrad). Beide gehören zusammen: Einer allein ist kein Punkt. Sie haben dann Vorrang vor der eingegebenen Stadt, die nur als Bezeichnung erhalten bleibt.
Deine Orte auflisten
Die Schaltfläche Meine Orte anzeigen listet alles auf, was die Integration überwacht: Nummer, Name, Ort (Stadt, Region, Land) und Koordinaten. Ein Eintrag pro Zeile, jeder beginnt mit „•“.
Diese Nummern sind die, die beim Entfernen verwendet werden: Führe diese Aktion aus, bevor du einen Ort entfernst, um der Nummer sicher zu sein.
Einen Ort entfernen
- Klicke auf Ort entfernen.
- Wähle die Nummer des Orts in der Auswahlliste.
- Führe die Aktion einmal ohne Häkchen aus: Die Antwort sagt dir, welcher Ort entfernt würde. Prüfe, ob es der richtige ist.
- Setze das Häkchen bei Ich bestätige das Entfernen und führe sie erneut aus.
Der Ort verschwindet sofort aus dem Tab „Entdecken“.
Das Gladys-Gerät selbst wird nicht gelöscht. Eine Integration darf ein von dir angelegtes Gerät nicht löschen — sie kann nur aufhören, es anzubieten. Hattest du das Gerät dieses Orts hinzugefügt, nennt die Antwort es: Lösche es selbst im Tab Geräte der Integration, sonst bleibt es dort und wird nie wieder aktualisiert.
Achte auch auf die Neunummerierung: Wird Ort 2 von vieren entfernt, werden die Orte 3 und 4 zu den Orten 2 und 3. Führe „Meine Orte anzeigen“ erneut aus, bevor du einen weiteren entfernst.
Was das Gerät misst
Jedes Gerät stellt bereit:
| Funktion | Was sie enthält |
|---|---|
| Luftqualitätsindex | 1 bis 6 — der Wert für eine Szene |
| Luftqualität (Text) | Gut, Ausreichend, Mäßig, Schlecht, Sehr schlecht, Extrem schlecht |
| Dominierender Schadstoff | der Schadstoff, der den Index bestimmt hat |
| Teilindex PM2,5 / PM10 / NO₂ / O₃ / SO₂ | 1 bis 6, Schadstoff für Schadstoff |
| PM2,5 / PM10 / NO₂ / O₃ / SO₂ | die Konzentration in µg/m³ |
| Letzte Datenaktualisierung | die Uhrzeit der Daten, in der Ortszeit des Orts |
Die sechs Klassen des Index:
| Index | Luftqualität |
|---|---|
| 1 | Gut |
| 2 | Ausreichend |
| 3 | Mäßig |
| 4 | Schlecht |
| 5 | Sehr schlecht |
| 6 | Extrem schlecht |
Der Gesamtindex ist der des schlechtesten Schadstoffs — so sind sowohl der europäische Index als auch der französische ATMO-Index definiert: Ein einziger verschlechterter Schadstoff genügt, um die Luft zu verschlechtern.
Neben seinem Teilindex erhält jeder Schadstoff auch seine rohe Konzentration in µg/m³ — ein Teilindex ist ein Band, und ein Band verbirgt, was darin geschieht: Ein Ozon-Nachmittag, der von 55 auf 128 µg/m³ steigt, verlässt nie Klasse 3. Jeder der fünf hat seine eigene Gladys-Sensorkategorie, sodass alle ihr Symbol, ihr Farbabzeichen und ihre Kurve im Verlauf erhalten.
Die letzte Datenaktualisierung ist die Uhrzeit der CAMS-Analyse für diesen
Ort, nicht die Uhrzeit, zu der die Integration zuletzt lief: Das Modell rechnet
stündlich, häufigeres Aktualisieren verschiebt sie also nicht. Sie wird in der
Ortszeit des Orts angezeigt (gefolgt von ihrer Zone, CEST, GMT+9…),
weshalb jedes Gerät seine eigene hat: Zwei Orte können zu Recht zwei
verschiedene Uhrzeiten anzeigen.
Ein Schadstoff, für den die Quelle keinen Wert hat, veröffentlicht gar nichts. Eine fehlende Messung ist keine saubere Luft: Eine 1 zu schreiben würde den Verlauf verfälschen und könnte eine Szene „die Luft ist wieder gut“ auslösen.
Woher die Daten stammen
Die Konzentrationen stammen aus den CAMS-Daten (Copernicus Atmosphere Monitoring Service, der Atmosphärendienst der Europäischen Union, betrieben vom EZMW), die Open-Meteo als Open Data weiterverbreitet. Zwei Modelle, und die Integration wählt nach der Lage des Orts:
| Lage des Orts | Gelesenes Modell | Auflösung |
|---|---|---|
| In Europa | CAMS europäisch | ~11 km |
| Anderswo | CAMS global | ~40 km |
Beide veröffentlichen dieselben fünf regulierten Schadstoffe. Ein Ort bleibt immer beim selben Modell, sodass sein Verlauf eine einzige Reihe ist und nicht zwei übereinander gestapelte Datensätze unter einem Diagramm.
Atmo France ist die Referenz für den französischen ATMO-Index, aber seine API erfordert ein Konto und ein Authentifizierungstoken, das jeder Benutzer anlegen müsste, bevor die Integration überhaupt funktioniert. Eine offizielle, offene Quelle ohne Authentifizierung wurde vorgezogen.
Der Index wird aus diesen Konzentrationen mit den Schwellenwerten des Europäischen Luftqualitätsindex (Europäische Umweltagentur) berechnet. Diese sind, Band für Band, die des französischen ATMO-Index seit dem arrêté du 10 juillet 2020, in Kraft seit dem 1. Januar 2021, der den nationalen Index an den europäischen angeglichen hat: sechs Klassen, dieselben fünf regulierten Schadstoffe, dieselben Grenzen.
Ein Unterschied, den man kennen sollte: Der veröffentlichte ATMO-Index ist ein Tageswert (Tagesmittel für Feinstaub, Tagesmaximum für die Gase), während diese Integration die aktuelle Stunde liest, wie es der europäische Index tut. Der Wert reagiert daher innerhalb der Stunde — was eine Hausautomations-Szene braucht —, statt das ATMO-Tagesbulletin wiederzugeben.
Städte werden über die Geocoding-API von Open-Meteo in Koordinaten aufgelöst, gestützt auf die weltweite GeoNames-Datenbank. Ebenfalls offen, ebenfalls ohne Konto und ohne API-Schlüssel.
Auf deinem Dashboard
Zwei Widgets werden unter Dashboard → Bearbeiten → Neues Widget angeboten, bei den Integrations-Widgets. Sie folgen der Sprache der Person, die sie ansieht, und ihre Farben folgen dem Gladys-Design (hell oder dunkel).
Luftqualität — ein Ort
Die Karte eines Orts, ausgewählt unter den bereits über den Tab „Entdecken“ hinzugefügten Geräten:
- eine Anzeige von 1 bis 6 mit dem aktuellen Index;
- der dominierende Schadstoff, der den Index bestimmt (nichts, wenn die Luft gut ist);
- eine Zeile pro Schadstoff, der schlechteste zuerst, mit seiner Klasse und seiner Konzentration: „4/6 (Schlecht) · 150 µg/m³“;
- die Kurve der kommenden Stunden, heute und morgen — das Einzige, was kein Sensor zeigen kann, da es noch nicht geschehen ist;
- die Uhrzeit der CAMS-Analyse und eine Schaltfläche Aktualisieren.
Zwei Einstellungen pro Karte:
- Verfolgte Schadstoffe — wähle die aus, die dich interessieren (Ozon im Sommer, Feinstaub im Winter): Die Anzeige, die Zeilen und die Kurve berücksichtigen dann nur diese. Nichts ausgewählt = alle, also der Index, den Gladys veröffentlicht.
- Kommende Stunden anzeigen — deaktiviere es für eine kompakte Karte.
Luftqualität — alle Orte
Eine Zeile pro konfiguriertem Ort, mit seinem Index und seinem dominierenden Schadstoff, und eine Schaltfläche Aktualisieren, die alle Orte neu liest. Keine Einstellung: Die Karte zeigt die in der Konfiguration verwaltete Liste. Bei mehr als zehn Orten sagt die Bildunterschrift, wie viele ausgelassen sind.
Die Farben: Grün für „Gut“ und „Ausreichend“, Gelb für „Mäßig“, Rot von „Schlecht“ bis „Extrem schlecht“. Die Widget-Palette hat weder Orange noch Violett; ein wiederholtes Rot ist besser, als ein „Schlecht“ gelb zu malen.
Den Index in einer Szene verwenden
1. Die Messwerte, wie jeder Sensor
Der Index, die Teilindizes und die Konzentrationen sind Funktionen des Geräts: Der Gladys-Auslöser „Änderung von Gerätestatus“ überwacht sie wie jeden Sensor („wenn der Index über 3 steigt“).
2. Die Auslöser
Im Szenen-Editor, in der Kategorie Integrationen der Auslöser-Auswahl (jeder Eintrag zeigt „Luftqualität“ unter seinem Namen):
- Luftqualitätsindex hat sich geändert — einmal, wenn der Gesamtindex eines Orts von einer Klasse in eine andere wechselt. Nie bei jeder Aktualisierung.
- Teilindex eines Schadstoffs hat sich geändert — dasselbe, Schadstoff für Schadstoff.
Jeder Auslöser lässt sich filtern (alles ist optional, ein leerer Filter bedeutet „beliebig“): der Ort, die neue(n) Klasse(n), die Richtung („Verschlechterung“, um die Fenster zu schließen, „Verbesserung“, um sie wieder zu öffnen) und beim zweiten der/die Schadstoff(e).
Die Szene erhält fertige Variablen, darunter {{triggerEvent.data.summary}}:
„Luftqualität in Zuhause: Index 4/6 (Schlecht), dominierend Ozon (O₃).“ — direkt
für eine Benachrichtigung. Die anderen: Name des Orts, neue und vorherige Klasse
(als Zahl und ausgeschrieben), Richtung, Schadstoff, Konzentration (zweiter
Auslöser), Uhrzeit der Analyse.
Zwei Dinge, die man wissen sollte:
- Bei der ersten Messung nach einem Start wird nichts ausgelöst: Die vorherige Klasse ist unbekannt, und „unbekannt → 4“ ist keine Änderung.
- Fehlende Daten sind keine Rückkehr zu guter Luft: Sie lösen nichts aus, und die nächste Klasse wird mit der zuletzt tatsächlich gelesenen verglichen.
3. Die Aktionen
- Luftqualität lesen — liest einen Ort sofort und übergibt den nächsten Aktionen die Klasse, ihre Bezeichnung, den Schadstoff, seine Konzentration, die Uhrzeit der Analyse und denselben fertigen Satz. Wähle „Gesamtindex“ (der derzeit schlechteste Schadstoff) oder einen Schadstoff. Keine Daten? Die Klasse ist leer und der Satz sagt es: Prüfe das in einer Bedingung, statt auf einen Fehler zu warten.
- Luftqualitätsdaten aktualisieren — liest einen Ort neu und veröffentlicht ihn neu, oder alle, wenn der Ort leer bleibt, ohne auf die nächste Aktualisierung zu warten. Gibt zurück, wie viele Orte aktualisiert wurden und wie viele fehlgeschlagen sind.
Beispiel: „jeden Tag um 7 Uhr → Luftqualität lesen (Zuhause) → mir {{summary}}
schicken“.
Einstellungen
- Sprache der Gerätenamen — standardmäßig Französisch (auch Englisch, Deutsch und Spanisch). Alles, was die Integration anzeigt, folgt bereits der Sprache deines Gladys-Kontos, aber der Name eines Geräts und seiner Funktionen wird so gespeichert, wie er veröffentlicht wird, und muss daher hier gewählt werden. Ein bereits hinzugefügtes Gerät behält die Namen, mit denen es erstellt wurde; lösche es und füge es über den Tab „Entdecken“ erneut hinzu, um es umzubenennen. Diese Einstellung ist auch die Sprache, in der der Geocoder antwortet: „Munich“ oder „München“ für dieselbe Stadt.
- Aktualisierungsintervall — standardmäßig 1 Stunde (zwischen 15 Minuten und 24 Stunden). Die CAMS-Analyse wird einmal pro Stunde erstellt: Darunter ist nichts zu gewinnen.
Prüfen, ob es funktioniert
Die Schaltfläche Luftqualitätsquelle testen fragt die Quelle live für jeden Ort ab und zeigt den Index jedes Orts an, im selben Format wie die Liste. Das ist der schnellste Weg zu sehen, ob ein Ort ein Problem hat, und warum.
Der Tab Überwachung zeigt den Anwendungsstatus der Integration: Er wird rot, mit dem Grund, wenn ein Ort nicht mehr gelesen werden kann.
Ein Ort, für den die Quelle nicht antwortet, wird für sich allein erneut versucht, 30 Sekunden und dann 2 Minuten später (länger, wenn die Quelle um eine Verlangsamung bittet), statt bis zur nächsten Aktualisierung leer zu bleiben. Alle deine Orte werden gemeinsam gelesen, mit einer Anfrage pro CAMS-Modell.
Grenzen
- Der Index ist der europäische, überall angewendet. Außerhalb Europas ist er daher nicht der nationale Index des Landes: Ein Ort in den Vereinigten Staaten, in China oder in Indien wird mit den europäischen Bändern bewertet, nicht mit dem US-AQI, dem chinesischen Index oder dem indischen CAQI. Die Konzentrationen selbst bleiben die Konzentrationen.
- Außerhalb Europas ist das Modell viermal gröber (~40 km statt ~11 km): Es beschreibt eine regionale Hintergrundbelastung gut, eine Straße weniger.
- Maximal zwanzig Orte.
- Gladys 5.2.0 oder neuer: 5.1.0 hat Widgets und Szenen für Integrationen geöffnet, 5.2.0 die Hausauswahl von „Meine Gladys-Häuser hinzufügen“.
- Ein Ort kann nicht bearbeitet werden: Um eine andere Gemeinde zu überwachen, entferne ihn und füge einen neuen hinzu.
Konfigurationseinstellungen
Diese Einstellungen fragt Qualité de l'air in seinem Konfigurationsbildschirm in Gladys ab.
| Einstellung | Typ | Pflichtfeld | Beschreibung |
|---|---|---|---|
| So funktioniert es | section | Nein | Füge mit der Schaltfläche unten einen Ort hinzu: Gib eine Stadt ein, überall auf der Welt, und im Tab „Entdecken“ erscheint ein Luftqualitätsgerät, bereit zum Hinzufügen zu Gladys. Städte werden über die Geocoding-API von Open-Meteo (GeoNames) aufgelöst, und die Schadstoffkonzentrationen stammen aus den CAMS-Daten von Copernicus, die Open-Meteo als Open Data weiterverbreitet: Weder ein Konto noch ein API-Schlüssel ist nötig. In Europa wird das europäische CAMS-Modell (~11 km) verwendet, anderswo das globale CAMS-Modell (~40 km). Der Index ist der Europäische Luftqualitätsindex, dessen sechs Klassen und Schwellenwerte seit 2021 auch der französische ATMO-Index verwendet — er wird weltweit angewendet und ist daher außerhalb Europas nicht der nationale Index des jeweiligen Landes. Dazu gehören zwei Dashboard-Widgets, zwei Szenen-Auslöser und zwei Szenen-Aktionen: Füge eine Karte über „Dashboard bearbeiten“ hinzu; der Szenen-Editor führt sie unter „Integrationen“ auf. |
| Allgemeine Einstellungen | section | Nein | Diese Einstellungen gelten für alle konfigurierten Orte. |
| Sprache der Gerätenamen | select | Nein | Die Sprache, in der die Namen der Geräte und ihrer Funktionen geschrieben werden: „Dominierender Schadstoff“ oder „Polluant dominant“, „Stickstoffdioxid (NO₂)“ oder „Dioxyde d'azote (NO₂)“. Alles andere, was diese Integration anzeigt, folgt bereits deiner Gladys-Sprache, aber der Name eines Geräts und seiner Funktionen wird so gespeichert, wie er veröffentlicht wird, und muss daher hier gewählt werden. Ein bereits zu Gladys hinzugefügtes Gerät behält die Namen, mit denen es erstellt wurde: Lösche es und füge es über den Tab „Entdecken“ erneut hinzu, um es umzubenennen. |
| Aktualisierungsintervall (s) | number | Nein | Wie oft jeder Ort aktualisiert wird, in Sekunden. Die CAMS-Analyse wird einmal pro Stunde erstellt, unter einer Stunde ist also nichts zu gewinnen. |
| Deine Orte | section | Nein | Verwende die Schaltflächen unten, um deine Orte hinzuzufügen, aufzulisten und zu entfernen. „Meine Gladys-Häuser hinzufügen“ fügt sie mit einem Klick hinzu, aus den Häusern, die du in Gladys bereits auf der Karte platziert hast. Sie sind keine Felder dieses Formulars: Eine Liste, die nach und nach entsteht, kann keines sein, daher geschieht alles unter einer Schaltfläche, und die dort angezeigte Antwort zeigt dir die Liste. |
So installierst du Qualité de l'air in Gladys
- Öffne in Gladys Integrationen: Qualité de l'air erscheint im Katalog neben den nativen Integrationen, mit einem Community-Badge.
- Klicke auf Installieren. Gladys lädt das Docker-Image (
ghcr.io/prohand/gladys-airquality:2.5.1) 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/prohand/gladys-airquality.
Qualité de l'air benötigt Gladys >=5.2.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
Qualité de l'air 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 prohand 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