Pollens Smart-Home-Integration, kostenlos und Open Source
Pollenrisiko für die Orte deiner Wahl, aus der europäischen CAMS-Vorhersage von Copernicus.
Veröffentlicht von prohand
- Geräte
- Version 2.4.1
- Erfordert Gladys >=5.2.0
- ★ 0
Diese Integration stellt das Pollenrisiko der Orte deiner Wahl als Gladys-Geräte bereit: ein Gerät pro Ort, mit einem Risikoniveau von 0 bis 3 — der Skala von Gladys selbst — für jede Pollenart. Du fügst deine Gladys-Häuser mit einem Klick hinzu, oder einen Ort, indem du seine Gemeinde eingibst.
Kein Konto anzulegen, kein API-Schlüssel einzufügen.
Das Risiko erscheint auch auf deinem Dashboard (zwei Widgets) und steuert deine Szenen (zwei Auslöser, zwei Aktionen).
Diese Version erfordert Gladys 5.2 oder neuer: Die Liste deiner Gladys-Häuser in „Meine Gladys-Häuser hinzufügen“ gibt es vorher nicht, ebenso wenig (vor 5.1) die Dashboard-Widgets und Szenenkarten einer Integration.
Woher die Daten stammen
Die Pollenkonzentrationen stammen aus der europäischen CAMS-Luftqualitätsvorhersage (Copernicus Atmosphere Monitoring Service, der Atmosphärendienst des EU-Programms Copernicus, betrieben vom EZMW). Sie ist das Referenzmodell in Europa, auf einem Raster von ~11 km.
Sie wird über Open-Meteo abgefragt, das CAMS als Open Data ohne Konto und ohne API-Schlüssel weiterverbreitet.
Die eingegebenen Gemeinden werden von der Geokodierungs-API von Open-Meteo in Koordinaten umgewandelt, gestützt auf die Datenbank GeoNames — ebenfalls offen, ohne Authentifizierung und weltweit, daher muss in dieser Integration nirgends ein Land gewählt werden.
Und Atmo France? Atmo France veröffentlicht zwar einen Pollenindex für Frankreich, aber seine API erfordert ein Konto und ein Authentifizierungstoken, das jeder Benutzer anlegen müsste, bevor die Integration überhaupt funktioniert. CAMS wurde gewählt, weil es offiziell und ohne jede Einrichtung nutzbar ist.
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 Haus einen Ort an — ohne eine Gemeinde einzugeben. Um nur eines davon hinzuzufügen, wähle es in der Liste Haus der Schaltfläche; lass die Liste leer, um alle hinzuzufügen.
Vier Dinge sind gut zu wissen:
- Der Zugriff ist eine Berechtigung. Wo du wohnst, sind personenbezogene Daten: Gladys teilt sie nur, wenn du die Anfrage auf dem Installationsbildschirm der Integration akzeptiert hast. Antwortet die Schaltfläche, dass der Zugriff verweigert wird, entferne die Integration und installiere sie neu, indem du die dort angezeigte Anfrage akzeptierst.
- 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 klicke erneut auf die Schaltfläche.
- Ein Haus außerhalb des europäischen CAMS-Gebiets wird ebenfalls genannt und ausgelassen: Keine Pollenvorhersage deckt es ab (siehe „Geografische Abdeckung“ unten).
- Es ist keine Synchronisierung. Die Häuser werden im Moment des Klicks gelesen. Heraus kommt ein gewöhnlicher Ort, den du wie jeden anderen umbenennst und entfernst, und ein später in Gladys verschobenes Haus verschiebt seinen Ort nicht.
Erneutes Klicken ist unbedenklich: Ein bereits überwachtes Haus wird gemeldet, nicht doppelt hinzugefügt.
Das Lesen der Häuser benötigt die Hauskoordinaten, die Gladys mit 4.85.0 freigegeben hat, und die Liste Haus benötigt Gladys 5.2.0 — die Version, die diese Integration voraussetzt.
Einen Ort hinzufügen
- Öffne den Tab Konfiguration der Integration.
- Klicke auf Ort hinzufügen.
- Gib die Gemeinde ein, z. B.
Montauban. Den Ort zu benennen ist optional: Bleibt das Feld leer, wird der Name der Gemeinde verwendet. - Bestätige.
Die meisten Ortsnamen teilen sich mehrere Gemeinden — allein in Frankreich gibt
es zwei Montauban und weltweit ein Dutzend Paris. In diesem Fall listet die
Integration die Kandidaten auf, statt zu raten: Führe die Aktion erneut aus,
mit einem Komma und der Region, dem Land oder der Postleitzahl, z. B.
Montauban, Tarn-et-Garonne oder Paris, France.
Du kannst auch direkt einen Punkt hinzufügen: Gib den Breitengrad und
den Längengrad ein (Dezimalgrad WGS-84, beide — einer allein ergibt keinen
Punkt). Beide Dezimaltrennzeichen werden gelesen, 48,8566 funktioniert also
ebenso wie 48.8566. Die Koordinaten haben Vorrang vor der Gemeinde, die dann nur
noch als Bezeichnung des Ortes dient.
Der Ort erscheint dann im Tab Entdecken unter dem Namen
Pollens — <Name>. Klicke auf Zu Gladys hinzufügen, um das Gerät anzulegen — erst
dann ist es in Dashboards und Szenen nutzbar.
Du kannst bis zu 20 Orte hinzufügen.
Deine Orte anzeigen und entfernen
Meine Orte anzeigen gibt sie nummeriert aus:
• 1. Zuhause — Montauban, Tarn-et-Garonne, France (44.01810, 1.35490)
• 2. Büro — Toulouse, Haute-Garonne, France (43.60426, 1.44367)
Diese Nummern bietet die Auswahlliste zum Entfernen an, denn eine in einem Manifest deklarierte Auswahlliste kann nur feste Optionen enthalten — nie die Namen deiner Orte.
Um einen Ort zu entfernen: Klicke auf Ort entfernen, wähle seine Nummer, hake Ich bestätige an und bestätige. Ohne den Haken sagt dir die Aktion, welcher Ort entfernt würde. Der Ort verschwindet sofort aus dem Tab „Entdecken“, und die Orte darunter rücken um einen Rang nach oben — lass die Liste also erneut anzeigen, bevor du einen zweiten entfernst.
Wenn du das Gerät bereits zu Gladys hinzugefügt hattest, lösche es auch auf der Geräteseite: Eine Integration darf kein Gerät löschen, das du angelegt hast. Umgekehrt: Löschst du das Gerät, ohne den Ort zu entfernen, erscheint es wieder im Tab „Entdecken“, bereit, erneut hinzugefügt zu werden.
Was das Gerät misst
Jedes Gerät stellt sechzehn Messwerte bereit: ein Gesamtrisiko, seine Formulierung, den Hauptpollen, das Datum der Daten, dann für jede der sechs Pollenarten einen Risikoindex und dasselbe Risiko in Worten.
| Messwert | Beschreibung |
|---|---|
| Pollenrisiko gesamt | Das höchste der sechs Risiken unten (0 bis 3) |
| Pollenrisiko gesamt (Text) | Das gemessene Risiko in Worten: „4/5 (hoch)“ |
| Hauptpollen | Der Name der Pollenart, die dieses Risiko bestimmt |
| Letzte Datenaktualisierung | Datum und Uhrzeit, für die die Vorhersage gilt |
| Pollenrisiko — Erle | Risiko von 0 bis 3 |
| Pollenrisiko — Erle (Text) | Das gemessene Risiko in Worten: „4/5 (hoch)“ |
| Pollenrisiko — Birke | Risiko von 0 bis 3 |
| Pollenrisiko — Birke (Text) | Das gemessene Risiko in Worten: „4/5 (hoch)“ |
| Pollenrisiko — Gräser | Risiko von 0 bis 3 |
| Pollenrisiko — Gräser (Text) | Das gemessene Risiko in Worten: „4/5 (hoch)“ |
| Pollenrisiko — Beifuß | Risiko von 0 bis 3 |
| Pollenrisiko — Beifuß (Text) | Das gemessene Risiko in Worten: „4/5 (hoch)“ |
| Pollenrisiko — Olive | Risiko von 0 bis 3 |
| Pollenrisiko — Olive (Text) | Das gemessene Risiko in Worten: „4/5 (hoch)“ |
| Pollenrisiko — Ambrosia | Risiko von 0 bis 3 |
| Pollenrisiko — Ambrosia (Text) | Das gemessene Risiko in Worten: „4/5 (hoch)“ |
Die „(Text)“-Messwerte sind das, was eine Benachrichtigung, ein Textfeld im
Dashboard oder ein Sprachassistent vorliest: Eine Szene, die den Index liest,
erhält eine 3, und 3 ist dann das, was in ihrer Nachricht steht. Für eine
Pollenart, für die das Modell keinen Wert hat, wird gar nichts veröffentlicht,
weder Index noch Formulierung.
Index und Formulierung stehen absichtlich nicht auf derselben Skala. Der Index
steht auf der Skala von Gladys, 0 bis 3 — der einzigen, die der Kern benennen
kann. Die Formulierung ist ein einfacher Text, den nachgelagert niemand neu
interpretiert, daher trägt sie den Messwert selbst, 0 bis 5, die europäischen
Stufen, denen die CAMS-Daten folgen. Ein „hoher“ und ein „sehr hoher“ Tag zeigen
beide 3 im Index, aber „4/5 (hoch)“ und „5/5 (sehr hoch)“ im Text.
Das sind die Namen bei der Einstellung Sprache der Gerätenamen auf Deutsch. Standardmäßig ist sie auf Französisch gestellt (
Risque pollinique — Bouleau) — siehe Die Sprache der Namen unten.
Die numerischen Messwerte behalten ihren Verlauf, sodass du die Pollensaison deiner Gemeinde als Diagramm darstellen können.
Hat das Modell für eine Art an dieser Position keinen Wert, wird nichts veröffentlicht — ein fehlender Messwert ist kein Risiko von null.
Wie alt sind diese Zahlen?
Das beantwortet der Messwert Letzte Datenaktualisierung. Er zeigt Datum und
Uhrzeit, für die die angezeigte Vorhersage gilt, im Format 06.08.2026 13:00.
Es ist das Datum der Daten, nicht der letzten Anfrage: CAMS veröffentlicht seine Vorhersage einmal täglich und Open-Meteo interpoliert sie Stunde für Stunde, daher liest eine erfolgreiche Aktualisierung meist genau dieselben Zahlen erneut. Was du wissen willst, ist, wie alt diese Zahlen sind, nicht wann sie zuletzt abgerufen wurden.
Die angezeigte Uhrzeit ist die des Ortes selbst: Eine Vorhersage liest man nach der Uhr der Gemeinde, die sie abdeckt. Für einen Ort in deiner Zeitzone ist das einfach deine Uhrzeit; für einen weiter entfernten ist es die dortige Ortszeit. Deshalb sitzt dieser Messwert auch auf jedem Gerät und nicht auf einem einzigen, das die ganze Integration teilt: Zwei Orte tragen nicht unbedingt dieselbe.
Bleibt das Datum in der Vergangenheit hängen, schlägt die Aktualisierung fehl: Die Schaltfläche Pollenanbieter testen zeigt für jeden Ort dasselbe Datum und sagt, was schiefläuft, falls etwas schiefläuft.
Die Risikoskala
Es ist die Skala von Gladys, keine eigene. Gladys kann vier Risikoniveaus benennen, und Gladys schreibt die Bezeichnung neben den Messwert in der Box „Geräte im Raum“:
| Niveau | Was Gladys anzeigt | Farbe |
|---|---|---|
| 0 | Kein Risiko | Grün |
| 1 | Niedrig | Gelb |
| 2 | Mittel | Orange |
| 3 | Hoch | Rot |
Die Integration veröffentlicht genau diese vier Niveaus und nichts anderes. So sagen die Gerätebox, die Widgets, die Szenenauslöser und die Benachrichtigungen alle dasselbe über dieselbe Zahl. Die Textmesswerte und die Widgets fügen dem Wort die Skala hinzu — „2/3 (mittel)“ —, sodass du ein Niveau einordnen kannst, ohne die Skala auswendig zu kennen.
Die CAMS-Daten folgen den Stufen des European Aeroallergen Network (EAN), das sechs davon hat. Sie werden auf die vier Niveaus von Gladys gefaltet:
| EAN-Stufe (Textmesswert) | Veröffentlichter Index | Name in Gladys |
|---|---|---|
| 0/5 (keine) | 0 | Kein Risiko |
| 1/5 (sehr niedrig) | 1 | Niedrig |
| 2/5 (niedrig) | 1 | Niedrig |
| 3/5 (mittel) | 2 | Mittel |
| 4/5 (hoch) | 3 | Hoch |
| 5/5 (sehr hoch) | 3 | Hoch |
Bei der Faltung geht nichts Wichtiges verloren: Die beiden ruhigen Stufen bedeuten beide „es gibt kaum welche“, und die beiden starken bedeuten beide „bleib drinnen, wenn du darauf reagierst“.
Die gemessene Stufe bleibt lesbar: Die „(Text)“-Messwerte des Geräts zeigen sie unverändert, von 0 bis 5. Das ist der einzige Ort, an dem sie erhalten bleibt, denn ein Text wird genau so angezeigt, wie er gespeichert wurde, während Gladys eine Zahl mit seinen eigenen Worten neu beschriftet.
Das Niveau wird aus der Konzentration in Pollenkörnern pro Kubikmeter Luft abgeleitet, mit Schwellenwerten pro Art: 30 Körner/m³ sind ein ruhiger Tag für die Birke (Niveau 2), aber ein starker für Ambrosia (Niveau 3), deren allergene Wirkung weit stärker ist.
Du kommst von einer Version mit 0-5?
Die ersten Versionen veröffentlichten die sechs EAN-Stufen unverändert, von 0 bis 5. Das funktionierte nicht: Gladys kann nur vier Niveaus benennen, daher erschien ein Niveau 3 als „Hoch“, obwohl es „mittel“ bedeutete, und die Niveaus 4 und 5 erschienen als „Unbekannt“. Die veröffentlichte Skala ist jetzt die von Gladys.
Zwei Dinge solltest du nach dem Update prüfen:
- Das Gerät. Es erscheint im Tab Entdecken mit einer Schaltfläche Aktualisieren: Ein Klick genügt. Verlauf, Räume und Szenen bleiben erhalten.
- Deine Szenen. Ein Auslöser oder eine Bedingung für Niveau 4 oder 5 trifft nichts mehr: Ziele stattdessen auf Niveau 3 („hoch“). Ein Niveau 3, das „mittel“ bedeutete, wird zu einer 2.
Der bereits aufgezeichnete Verlauf behält seine alten Werte: In einem Diagramm über den Wechsel hinweg liegen die Punkte davor auf der Skala 0-5 und die danach auf der Skala 0-3. Es bleibt lesbar, aber ein Vergleich über diesen Zeitraum ist nicht fair.
Die gemessene Stufe 0-5 ist aber nicht verschwunden: Sie ist das, was die „(Text)“-Messwerte des Geräts neben dem Index anzeigen. Nur die Zahlen, die eine Szene oder ein Diagramm liest, stehen auf der Skala 0-3.
Die Sprache der Namen
Geräte- und Funktionsnamen werden standardmäßig auf Französisch geschrieben:
Die Messwerte heißen Risque pollinique global, Risque pollinique — Bouleau, und
der Hauptpollen erscheint als Bouleau. Stelle Sprache der Gerätenamen im
Tab „Konfiguration“ auf Deutsch, um die Namen aus der Tabelle oben zu erhalten
(Englisch und Spanisch werden ebenfalls angeboten).
Warum eine Einstellung statt der Sprache deines Kontos? Alles, was die Integration anzeigt — die Nachricht unter einer Schaltfläche, der Status im Tab „Überwachung“ —, wird Gladys auf Englisch, Französisch, Deutsch und Spanisch gesendet, und Gladys wählt die Sprache der lesenden Person. Ein Gerätename ist keine Nachricht: Er ist ein einfacher Text, der so gespeichert wird, wie er am Tag der Geräteerstellung ist, und nichts in der Integrations-API sagt, welche Sprache du liest. Daher wird er einmal hier gewählt.
Eine Folge: Eine Änderung der Einstellung benennt die Funktionen der noch anzulegenden Geräte um. Ein bereits zu Gladys hinzugefügtes Gerät behält die Namen, mit denen es angelegt wurde — lösche es und füge es über den Tab „Entdecken“ erneut hinzu, um es umzubenennen (sein Verlauf geht mit dem gelöschten Gerät).
Auf deinem Dashboard
Zwei Widgets werden mit der Integration geliefert. Füge sie von einem Gladys-Dashboard aus hinzu: Bearbeiten, Neues Widget, dann wähle sie aus der Liste.
Pollen — ein Ort
Die Karte eines Ortes: das Gesamtniveau auf einer Messanzeige, eine Kachel Hauptpollen, die die Art nennt, von der dieses Niveau stammt, das Risiko in Worten — „3/3 (hoch)“ —, dann die tatsächlich in der Luft befindlichen Pollen, die Kurve für heute und morgen und eine Schaltfläche Aktualisieren. Eine Art auf null belegt keine Zeile: Eine Karte, die nichts zeigt, bedeutet, dass nichts in der Luft ist, und sie sagt es — ohne Pollen in der Luft gibt es keinen Hauptpollen, und die Kachel verschwindet.
Ist die Karte auf einige Arten beschränkt, beziehen sich der Hauptpollen und das Risiko in Worten auf diese Arten, wie die Messanzeige.
Drei Einstellungen pro Karte:
| Einstellung | Wirkung |
|---|---|
| Ort | Das anzuzeigende Gerät. Angeboten werden nur die Geräte, die du bereits über den Tab „Entdecken“ hinzugefügt hast. |
| Verfolgte Pollenarten | Hake die Arten an, auf die du reagierst: Messanzeige, Liste und Kurve berücksichtigen dann nur diese. Nichts angehakt bedeutet alle. |
| Zwei-Tage-Vorhersage anzeigen | Die stündliche Kurve. Entferne den Haken für eine kompakte Karte. |
Die Kurve zeigt heute und morgen, Stunde für Stunde, mit einer Markierung zur aktuellen Uhrzeit. Es ist eine Vorhersage: Gladys speichert keinen Verlauf davon, daher wird sie zusammen mit dem aktuellen Niveau an der Quelle gelesen — in derselben Anfrage —, und eine weniger als 30 Minuten alte Antwort wird wiederverwendet, statt erneut angefragt zu werden. Bei vier oder weniger verfolgten Arten erhält jede ihre eigene Kurve; darüber zeigt eine einzige Kurve die schlimmste davon.
Wenn du alle Arten verfolgst, ist die Messanzeige an den Messwert des Geräts selbst gebunden und folgt den veröffentlichten Werten in Echtzeit. Bei einer Auswahl von Arten entspricht ihr kein Messwert — die Messanzeige zeigt dann die von der Karte berechnete Zahl.
Pollen — alle Orte
Eine Zeile pro konfiguriertem Ort, mit seinem Niveau und seinem Hauptpollen, und eine Schaltfläche Aktualisieren, die alle erneut liest. Keine Einstellungen: Die Karte zeigt die Liste, die der Tab „Konfiguration“ verwaltet. Sie endet nach zehn Zeilen und sagt es.
Beide Karten werden in der Sprache der Person geschrieben, die sie ansieht: Anders als bei einem Gerätenamen teilt Gladys uns hier mit, welche Sprache du liest.
Das Risiko in einer Szene verwenden
Drei Wege, vom einfachsten zum feinsten.
1. Die Messwerte, wie jeder Sensor
Das Gesamtrisiko ist ein Messwert der Kategorie „Risiko“: Er verhält sich wie jeder numerische Sensor. Einige Ideen:
- die Rollläden schließen oder die Lüftung abschalten, wenn das Gesamtrisiko über 3 steigt;
- morgens eine Benachrichtigung senden, wenn das Risiko „Gräser“ ≥ 4 ist;
- den Luftreiniger einschalten, wenn der Hauptpollen der ist, auf den du reagierst.
2. Die Auslöser
Im Szeneneditor, in der Kategorie Integrationen:
| Auslöser | Wann er auslöst |
|---|---|
| Gesamtes Pollenrisiko hat sich geändert | Das Gesamtniveau eines Ortes wechselt von einem Niveau zum anderen |
| Pollenrisiko einer Art hat sich geändert | Das Niveau einer Pollenart ändert sich an einem Ort |
Beide lösen nur bei einer Änderung aus, nie bei jeder Aktualisierung: Die CAMS-Vorhersage wird einmal täglich neu veröffentlicht, eine Szene, die bei jedem Lesen auslöst, würde also vierundzwanzigmal für denselben Wert auslösen.
Jeder Auslöser lässt sich filtern: der Ort (leer bedeutet jeder), die Niveaus, die dich interessieren (hake 3 an, um nur auf Spitzen zu reagieren), die Richtung (steigend, um die Fenster zu schließen, fallend, um sie wieder zu öffnen), und beim zweiten die Arten.
Die Szene erhält dann, was sie zum Schreiben ihrer Nachricht braucht:
{{triggerEvent.data.summary}} enthält den fertigen Satz „Pollen in Montauban:
Risiko 3/3 (hoch), vorherrschend Birke.“, und location_name, level,
level_label, previous_level, direction, taxon, taxon_name und
measured_at stehen einzeln zur Verfügung.
Zwei Details:
- beim Start löst nichts aus: Das vorherige Niveau ist dann unbekannt, und „unbekannt → 3“ ist keine Änderung. Die erste echte Änderung löst normal aus;
- eine Art ohne Wert löst nichts aus: Ein fehlender Messwert ist kein Rückfall auf null, und das letzte bekannte Niveau bleibt erhalten.
3. Die Aktionen
Ebenfalls im Szeneneditor, unter Integrationen:
| Aktion | Wirkung |
|---|---|
| Pollenrisiko lesen | Liest einen Ort sofort und übergibt das Niveau, den Hauptpollen und den fertigen Satz an die nächsten Aktionen |
| Pollendaten aktualisieren | Liest die Vorhersage erneut und veröffentlicht die Messwerte neu; Ort leer lassen für alle Orte |
„Pollenrisiko lesen“ macht aus „jeden Morgen um 7 Uhr“ ein „jeden Morgen um 7 Uhr,
sag mir das Risiko“: Wähle den Ort, lass Gesamtrisiko (oder wähle eine Art) und sende dann eine Nachricht mit der Ausgabe summary. Die
Ausgaben level (0 bis 3), level_label, taxon, taxon_name, concentration,
location_name und measured_at stehen bereit, wenn du lieber deinen eigenen
Satz schreibst.
Wenn die Quelle nichts antwortet, schlägt die Aktion nicht fehl: Sie gibt ein leeres
levelund einesummaryzurück, die sagt, dass die Daten nicht verfügbar sind. Was damit geschieht, entscheidet die Szene.
Aktualisierungsintervall
Jeder Ort wird standardmäßig stündlich aktualisiert. Die CAMS-Vorhersage wird einmal täglich neu berechnet und stündlich interpoliert, unter einer Stunde bringt es also nichts. Das Intervall lässt sich im Tab „Konfiguration“ zwischen 15 Minuten und 24 Stunden einstellen. Ein gerade angelegtes Gerät wird sofort aktualisiert — nur sein Ort —, ohne auf den nächsten Zyklus zu warten.
Einige Dinge sorgen dafür, dass die Integration beide Dienste schont:
- Alle deine Orte werden in einer einzigen Anfrage an Open-Meteo gelesen, und eine weniger als 30 Minuten alte Antwort wird von den Dashboard-Karten und den Szenenaktionen wiederverwendet, statt erneut angefragt zu werden.
- Eine Aktualisierung nach der anderen: Eine Schaltfläche, die während einer laufenden Aktualisierung gedrückt wird, wartet auf diese oder schließt sich ihr an, statt eine zweite zu starten.
- Eine Wiederverbindung oder ein gespeichertes Formular liest nicht alles neu, wenn die letzte Aktualisierung kurz zurückliegt: Der Zyklus läuft einfach in seinem gewohnten Takt weiter.
- Die Messwerte werden Gladys in seinem eigenen Takt gesendet: Gladys nimmt 300 Werte pro Minute und Integration an, und jeder Ort veröffentlicht 16. Zwanzig Orte werden daher über zwei Minuten gesendet statt auf einmal, und eine Antwort „zu viele Anfragen“ von Gladys wird einmal wiederholt.
- Eine Quelle, die stockt (ausgelastet, Neustart), wird einige Sekunden später noch einmal gefragt, bevor die Aktualisierung als fehlgeschlagen gilt.
Geografische Abdeckung
Die CAMS-Vorhersage deckt das europäische Gebiet ab. Ein Ort außerhalb dieses Gebiets wird beim Hinzufügen abgelehnt, statt ein Gerät anzulegen, das nie einen Wert hätte.
Fehlerbehebung
- Schaltfläche „Pollenanbieter testen“: Sie fragt die Quelle für jeden Ort ab (eine weniger als 30 Minuten alte Antwort wird wiederverwendet) und gibt eine Zeile pro Ort aus, nummeriert wie die Liste. Jede Zeile endet mit dem Datum der gelesenen Daten, sodass eine in der Vergangenheit hängende Quelle auch hier auffällt. Der schnellste Weg, ein Netzwerkproblem von einem Konfigurationsproblem zu unterscheiden.
- Der Tab „Überwachung“ sagt, wer fehlgeschlagen ist: „Pollenvorhersage nicht verfügbar“ ist die Quelle (Open-Meteo), „Ratenlimit von Gladys erreicht“ oder „Gladys hat die Zustände nicht akzeptiert“ ist dein Gladys — die Quelle trifft dann keine Schuld, und die nächste Aktualisierung veröffentlicht die Werte.
- Die Protokolle: Lies sie im Tab „Protokolle“ der Integration
oder mit
docker logs. SetzeLOG_LEVELaufdebug, um jede Anfrage an die Quelle und die genaue an Gladys gesendete Gerätenutzlast zu sehen. Die Koordinaten deiner Orte erscheinen nie in den Protokollen, auf keiner Stufe. - Im Tab „Entdecken“ erscheint nichts: Prüfe den Status der Integration im Tab „Überwachung“ — lehnt Gladys ein Gerät ab, wird der Grund dort gemeldet.
- Ein Gerät bleibt leer: Prüfe, ob sein Ort noch von „Meine Orte anzeigen“ aufgelistet wird. Ein Gerät, dessen Ort entfernt wurde, wird nicht mehr aktualisiert.
Konfigurationseinstellungen
Diese Einstellungen fragt Pollens 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 Gemeinde ein, sie wird geokodiert, und ein Pollengerät erscheint im Tab „Entdecken“, bereit, zu Gladys hinzugefügt zu werden. Die Pollendaten stammen aus der europäischen CAMS-Luftqualitätsvorhersage (Copernicus), die Open-Meteo als Open Data weiterverbreitet, und Orte werden über die Geokodierungs-API von Open-Meteo gesucht: Es werden weder ein Konto noch ein API-Schlüssel benötigt. Abgedeckt ist Europa, so weit das CAMS-Modell reicht. |
| Allgemeine Einstellungen | section | Nein | Diese Einstellungen gelten für alle konfigurierten Orte. |
| Sprache der Gerätenamen | select | Nein | Die Sprache, in der die Pollennamen geschrieben werden: „Birke“ oder „Birch“. 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, daher muss er 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 Vorhersage wird einmal täglich aktualisiert und stündlich interpoliert: Unter einer Stunde bringt es nichts. |
| Deine Orte | section | Nein | Verwende die Schaltflächen unten, um deine Orte hinzuzufügen, aufzulisten und zu entfernen. „Meine Gladys-Häuser hinzufügen“ verwandelt die Häuser, die du in Gladys bereits auf der Karte platziert hast, mit einem Klick in Orte. 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 Pollens in Gladys
- Öffne in Gladys Integrationen: Pollens erscheint im Katalog neben den nativen Integrationen, mit einem Community-Badge.
- Klicke auf Installieren. Gladys lädt das Docker-Image (
ghcr.io/prohand/gladys-pollen:2.4.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-pollen.
Pollens 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
Pollens 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