🇩đŸ‡č LuftqualitĂ€t Österreich – neue Home-Assistant-Integration (Daten vom Umweltbundesamt)

Hallo zusammen,

ich habe eine Integration gebaut, die die LuftgĂŒtemesswerte des Umweltbundesamts
nach Home Assistant holt – fĂŒr die offiziellen Messstellen in ganz Österreich.

Die Station findest du ĂŒber die Karte

Kein Suchen nach Stations-IDs: Beim Einrichten setzt du einen Marker auf deinen
Standort und ziehst den Kreis auf den gewĂŒnschten Suchradius (Standard 15 km,
maximal 100 km). Alle Stationen im Umkreis erscheinen nach Entfernung sortiert –
und die Liste zeigt schon vorab, was die jeweilige Station ĂŒberhaupt misst.
Wer den Namen kennt, tippt stattdessen einfach „Graz" oder „Stephansplatz".

Vor dem Anlegen kommt eine Detailansicht: Adresse, Betreiber, Entfernung und die
aktuellen Messwerte der Station. Erst danach wird der Eintrag erstellt. Bereits
eingerichtete Stationen werden ausgeblendet.

Was dabei herauskommt

Pro Station ein GerÀt, pro Schadstoff zwei Sensoren:

  • Aktueller Wert – der Halbstundenmittelwert, also der frischeste Wert,
    den die Quelle veröffentlicht
  • Tagesmittelwert – darauf beziehen sich die österreichischen Grenzwerte;
    er lĂ€uft ab Mitternacht mit und wĂ€chst ĂŒber den Tag

Abgedeckt sind PM10, PM2,5, NO₂, NO, O₃, SO₂ und CO. Angelegt wird nur, was die
Station tatsĂ€chlich liefert – keine leeren EntitĂ€ten.

Alle Sensoren haben die passende Device Class und state_class: measurement,
landen also in der Langzeitstatistik und lassen sich direkt in Statistik-Karten
und Automationen verwenden.

Station auf der Karte

Jede Station bekommt zusÀtzlich eine Koordinaten-EntitÀt (unter Diagnose),
die genau dafĂŒr gedacht ist, auf eine Map-Karte gelegt zu werden – eine pro
Station, damit nicht sieben Marker auf demselben Punkt landen:

type: map
entities:
  - sensor.<station>_koordinaten

DarĂŒber hinaus tragen alle Sensoren die Stationsmetadaten als Attribute:
Koordinaten, Adresse, Betreiber, Stations-ID, Seehöhe und den Messzeitpunkt.

Eckdaten

  • Einrichtung vollstĂ€ndig ĂŒber die OberflĂ€che, UI auf Deutsch und Englisch
  • Aktualisierung alle 30 Minuten
  • Home Assistant 2026.8.0 oder neuer, keine zusĂ€tzlichen Python-AbhĂ€ngigkeiten
  • Apache-2.0

Installation ĂŒber HACS (Custom Repository)

HACS → MenĂŒ (⋼) → Benutzerdefinierte Repositories →
https://github.com/karlrt/ha-austrian-air-quality als Kategorie Integration
hinzufĂŒgen → installieren → Home Assistant neu starten →
Einstellungen → GerĂ€te & Dienste → Integration hinzufĂŒgen → LuftqualitĂ€t Österreich

Repository: GitHub - karlrt/ha-austrian-air-quality: Home Assistant integration for air quality measurements in Austria (data source: Umweltbundesamt / Federal Environment Agency Austria). · GitHub

Zum Einordnen

Die Integration ist jung und bisher vor allem von mir getestet. Sie liest die
JSON-Schnittstelle der öffentlichen LuftgĂŒtekarte des Umweltbundesamts – dieselbe,
die auch die Karte selbst verwendet. Diese Schnittstelle ist nicht dokumentiert
und kann sich jederzeit Àndern. Das Projekt ist unabhÀngig und steht in keiner
Verbindung zum Umweltbundesamt; rechtsverbindlich sind ausschließlich dessen
offizielle Veröffentlichungen.

Wenn jemand eine Station in seiner NĂ€he einrichtet und mir kurz sagt, ob die Werte
stimmen, freue ich mich sehr – besonders ĂŒber RĂŒckmeldungen aus BundeslĂ€ndern
außerhalb der Steiermark. Issues, Pull Requests (und Sterne) sind willkommen.

Hallo, hab mir die Integration jetzt mal installiert und sieht gut aus:

Die Station wurde gleich gefunden und die Einrichtung geht sehr schnell vor sich. Einzig der LuftqualitĂ€tsindex und die LuftqualitĂ€tsindex Stufe werden bei mit als unbekannt angezeigt, obwohl ich sie auf der Seite der IQAir finden kann. Auf der Seite des Landes NÖ und auch vom Bundesumweltamt werden diese beiden Werte nicht angegeben. Ansonsten eine coole App :+1:

Freut mich, dass es dir gefÀllt!

Warum ist der LuftqualitĂ€tsindex “unbekannt”? Das ist eine bewusste Regel. Der Index bleibt None (→ „Unbekannt"), solange die EEA-Mindestdatenanforderung nicht erfĂŒllt ist: Die verlangt NO₂ und O₃ und mindestens eine PM-Fraktion. Fehlt eines davon, gibt station_index() level=None zurĂŒck — und beide Sensoren (Index und Stufe) leiten sich daraus ab, sind also gleichzeitig unbekannt.

Es gibt aber die Indices fĂŒr NO2 und die Feinstaubwerte (bei dir “gut” und “annehmbar”). Beides sind lokal errechnete Werte - die kommen nicht von den Stationen. Weitere Infos im Readme.

Danke fĂŒr die ErkĂ€rung. Dann werd ich mich mal in das Readme einlesen :zany_face: