Zum Hauptinhalt springen

London Air Smart-Home-Integration, kostenlos und Open Source

London Air-Integration für Gladys Assistant

Londoner Luftqualität von London Air (Imperial College): DAQI-Index pro Bezirk und Standort.

Auf GitHub ansehenAlle Integrationen

Die Londoner Luftqualität vom London Air Quality Network (LAQN), betrieben von der Environmental Research Group des Imperial College London: der britische Luftqualitätsindex DAQI (Daily Air Quality Index) jedes Bezirks (Borough) und jedes Messstandorts, Stunde für Stunde, mit dem Index jedes Schadstoffs.

Nicht mit London Air oder dem Imperial College London verbunden. Die Daten stammen aus der offenen API (api.erg.ic.ac.uk) und werden so verwendet, wie London Air sie veröffentlicht.

Was die Integration macht​

  • Liest das stündliche Bulletin von London Air, ohne Konto und ohne Schlüssel: eine Anfrage alle 30 oder 60 Minuten deckt alle Bezirke und Standorte ab.
  • Legt ein Gerät pro Bezirk (der schlechteste Index seiner Standorte) und ein Gerät pro gewähltem Messstandort an, insgesamt höchstens 10: den DAQI (1 bis 10), sein Band als Wort, den Index jedes gemessenen Schadstoffs (PM2.5, PM10, NO₂, O₃, SO₂) und das Alter des Bulletins.
  • Fügt ein Dashboard-Widget Luftqualität in London, zwei Szenenauslöser (Luftverschmutzung steigt, wieder niedrig) und eine Szenenaktion Luftqualität abrufen hinzu.
  • Findet einen Bezirk oder Standort nach Name oder Code, oder die deinem Haus nächsten.

Nur lesend: Die Integration liest ausschließlich öffentliche Daten.

Voraussetzungen​

  • Gladys Assistant 5.2.0 oder neuer.
  • Internetzugang von Gladys zu api.erg.ic.ac.uk.
  • Für die Suche rund um dein Haus: sein Standort unter Einstellungen → Zuhause.

Konfiguration​

Bezirke und Standorte wählen​

  1. Öffne den Reiter Konfiguration der Integration.
  2. Klicke auf Gebiet finden: Gib einen Bezirk, einen Ort oder einen Standortcode ein (Camden, Marylebone, MY1), oder lass das Feld leer, um die deinem Haus nächsten Bezirke und Standorte mit ihrer Entfernung zu sehen.
  3. Trage die gewünschten Bezirke unter Bezirke ein, nach Name oder Nummer, durch Kommas getrennt (Camden, Westminster), und die Standorte unter Standorte, nach Code (CD1, MY1). Speichere.
  4. Füge sie im Reiter Entdecken zu Gladys hinzu.

Ein Bezirk fasst sein Gebiet zusammen; ein Standort in der Nähe deines Zuhauses oder einer Schule zeigt, was du dort einatmest (ein Standort am Straßenrand einer Hauptstraße misst deutlich mehr als ein Hintergrundstandort). Die London-Air-Karte zeigt alle Standorte.

Weitere Einstellungen​

  • Abruf: alle 30 Minuten (Standard) oder jede Stunde. London Air veröffentlicht ein Bulletin pro Stunde: häufiger zu lesen brächte nichts.
  • Sprache: Sprache der Funktionsnamen (beim Hinzufügen eines Geräts festgelegt, also zuerst wählen) und der Szenentexte. Standardmäßig Französisch.

Der Button Gebiete prüfen liest das Bulletin sofort und zeigt, was jeder Bezirk und Standort liefert und welche Namen oder Codes nicht verstanden werden.

Geräte​

Ein Gerät pro Bezirk (London Air <Bezirk>) oder pro Standort (London Air \<Name des Standorts>).

FunktionWerte
Luftqualitätsindex (DAQI)1 bis 10, der schlechteste Schadstoff
Luftverschmutzungdas Band als Wort, in deiner Sprache
PM2.5-, PM10-, NO₂-, O₃-, SO₂-Index1 bis 10, jeder Schadstoff
Alter des BulletinsMinuten seit der Stunde des Bulletins

Nur die Schadstoffe, die der Standort (oder ein Standort des Bezirks) misst, werden angelegt. Das stündliche Bulletin liefert Indizes, keine Konzentrationen: Jeder Schadstoff ist sein Index auf derselben Skala von 1 bis 10.

Der britische Daily Air Quality Index hat vier Bänder: Niedrig (Low, 1 bis 3), Mäßig (Moderate, 4 bis 6), Hoch (High, 7 bis 9) und Sehr hoch (Very High, 10). Der schlechteste Schadstoff bestimmt den Index. Ein Bezirk übernimmt, Schadstoff für Schadstoff, den schlechtesten seiner Standorte.

Ein Schadstoff mit „No data“ behält seinen letzten Wert 3 Stunden lang (damit eine Lücke keine Szenen auslöst) und veröffentlicht danach nichts mehr. Ein Bulletin, das älter als 6 Stunden ist, wird nicht mehr als aktuell veröffentlicht: Gladys behält die letzten Werte mit ihrem Datum, und das Widget meldet veraltete Daten.

Widget​

Luftqualität in London:

  • mit gewähltem Bezirk oder Standort: bis zu vier Schadstoffkacheln, das Band eingefärbt (grün Niedrig, orange Mäßig, rot Hoch und Sehr hoch) und das Alter des Bulletins;
  • ohne: eine Zeile pro Bezirk oder Standort, sein Band eingefärbt.

Szenen​

Auslöser: London Air: Luftverschmutzung steigt​

Löst aus, wenn das Band eines Bezirks oder Standorts auf Mäßig oder schlechter steigt, oder sich weiter verschlechtert (Mäßig, dann Hoch löst zweimal aus). Eine Änderung innerhalb eines Bands (4, dann 5) löst nichts aus. Filter: der Bezirk oder Standort und das neue Band: Wähle die Bänder ab deiner Schwelle (zum Beispiel Hoch und Sehr hoch). Informationen für die Aktionen: Name, Band, Index, vorheriger Index, der Schadstoff, der den Index bestimmt, eine fertige Zusammenfassung.

Auslöser: London Air: Luftverschmutzung wieder niedrig​

Löst aus, wenn das Band nach einer mäßigen oder schlechteren Episode auf Niedrig zurückkehrt. Filter: der Bezirk oder Standort und das schlechteste Band der Episode (wähle dieselben Bänder wie oben, um beide Szenen zu koppeln). Informationen: das neue Band und der Index, das schlechteste Band und der schlechteste Index der Episode, eine Zusammenfassung.

Der erste Index nach der Installation legt das Ausgangsband fest, ohne etwas auszulösen; ein Neustart löst dieselbe Änderung nicht zweimal aus.

Aktion: London Air: Luftqualität abrufen​

Die Luftqualität eines Bezirks oder Standorts, oder des schlechtesten der hinzugefügten: Zusammenfassung, Band, Index, Schadstoff, der Index jedes Schadstoffs und das Alter des Bulletins, für die folgenden Aktionen (eine Nachricht, eine Bedingung).

Szenenbeispiele​

  • Fenster schließen: Auslöser Luftverschmutzung steigt mit den Bändern Hoch und Sehr hoch → {{triggerEvent.data.summary}} senden und die Lüftung ausschalten.
  • Wieder lüften: Auslöser wieder niedrig mit denselben Bändern → „Du kannst die Fenster wieder öffnen“ senden.
  • Schulweg: um 7:45 die Aktion Luftqualität abrufen auf dem Standort bei der Schule, dann ihre Zusammenfassung senden.
  • Luftreiniger: wenn der PM2.5-Index deines Bezirks 4 erreicht, den Luftreiniger einschalten.

Fehlerbehebung​

  • „Noch kein Bezirk und kein Standort“ auf dem Konfigurationsbildschirm: Trage mindestens einen Bezirk oder Standort ein, oder prüfe die Schreibweise mit Gebiete prüfen.
  • „kein Messstandort in diesem Bezirk“ oder „nicht im London-Air-Bulletin“: Manche Bezirke haben keinen Standort im stündlichen Bulletin (Barnet, Bromley, die City of London… zum Zeitpunkt dieser Doku), und ein Standort kann außer Betrieb sein. Gebiet finden listet die, die melden, mit ihrer Anzahl an Standorten.
  • „Keine London-Air-Bezirke“: Der Name steht nicht in der Liste; gib ihn so ein, wie Gebiet finden ihn zeigt, oder seine Nummer.
  • Schadstoffindizes ohne Wert: Das Bulletin meldet oft „No data“ für einen Teil der Schadstoffe eines Standorts (letzte Stunde noch nicht eingegangen, Messgerät außer Betrieb); der Index kommt dann von den anderen.
  • „Die London-Air-API antwortet nicht“: Die Werte bleiben erhalten und werden beim nächsten Abruf neu gelesen. Der Reiter Protokolle meldet den Fehler einmal und seine Behebung.
  • Details im Reiter Protokolle der Integration (LOG_LEVEL=debug für mehr).

Grenzen​

  • Stündliches Bulletin: Indizes, keine Konzentrationen, und oft „No data“ für einen Teil der Schadstoffe.
  • Das Bulletin kommt verspätet: Am 24. Oktober 2026 um 10:40 war das neueste das von 8:00. Die Funktion „Alter des Bulletins“ zeigt es.
  • Es sind Messungen, keine Vorhersagen.
  • London Air veröffentlicht kein Anfragelimit: Die Integration stellt alle 30 oder 60 Minuten eine Anfrage, unabhängig von der Zahl der Gebiete, und nur solange eines davon zu Gladys hinzugefügt ist.
  • Die Auslöser folgen den Bändern, wie sie veröffentlicht werden: Ein Band, das zwischen zwei Werten schwankt, löst bei jeder Änderung aus.

Konfigurationseinstellungen​

Diese Einstellungen fragt London Air in seinem Konfigurationsbildschirm in Gladys ab.

EinstellungTypPflichtfeldBeschreibung
Luftqualität in LondonsectionNeinLiest das stündliche Bulletin des London Air Quality Network (Environmental Research Group, Imperial College London) über seine offene API, ohne Konto. Nicht mit London Air oder dem Imperial College London verbunden.
BezirkestringNeinDie Londoner Bezirke (Boroughs), nach Name oder Nummer, durch Kommas getrennt: je ein Gerät mit dem schlechtesten Index seiner Standorte. „Gebiet finden“ unten listet sie auf.
StandortestringNeinDie Messstandorte, nach ihrem Code, durch Kommas getrennt: je ein Gerät. Bezirke und Standorte zusammen: höchstens 10.
AbrufselectNeinLondon Air veröffentlicht jede Stunde ein Bulletin.
SpracheselectNeinSprache der Funktionsnamen (beim Hinzufügen eines Geräts festgelegt) und der Szenentexte.

So installierst du London Air in Gladys​

  1. Öffne in Gladys Integrationen: London Air erscheint im Katalog neben den nativen Integrationen, mit einem Community-Badge.
  2. Klicke auf Installieren. Gladys lädt das Docker-Image (ghcr.io/guim31/gladys-londonair:1.0.0) 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/guim31/gladys-londonair.

London 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​

London 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 guim31 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 🙂
Zuletzt aktualisiert am