AEMET Smart-Home-Integration, kostenlos und Open Source
Offizielles Wetter für Spanien (AEMET): Vorhersagen, Messstation, Meteoalerta-Warnungen pro Ort.
Veröffentlicht von guim31
- Geräte
- Version 1.0.1
- Erfordert Gladys >=5.2.0
- ★ 0
Das offizielle Wetter Spaniens in Gladys, von AEMET OpenData, dem Open-Data-Dienst des spanischen staatlichen Wetterdienstes: die Vorhersage der aktuellen Stunde, die Extremwerte des Tages, die Meteoalerta-Warnungen (gelb, orange, rot) und die Messung der nächsten Wetterstation, für das Festland, die Balearen, die Kanaren, Ceuta und Melilla. Gedacht für Ferienhäuser und Grenzgänger.
Diese Integration ist nicht mit AEMET verbunden. Entwickelt wurde sie ohne AEMET-Konto, anhand echter veröffentlichter Antworten der API: Rückmeldungen sind willkommen.
Überblick
- Ein Gerät pro Gemeinde (höchstens fünf), nur lesend.
- Vorhersage der aktuellen Stunde: Temperatur, gefühlte Temperatur, Luftfeuchtigkeit, Wind, Böen, Windrichtung, Regenwahrscheinlichkeit, erwarteter Regen dieser Stunde, Himmel (übersetzt).
- Heute: UV-Index (Tagesmaximum), Tiefst- und Höchsttemperatur.
- Warnungen: aktuelle Stufe, höchste kommende Stufe und ein Text, der sie auflistet.
- Station: Temperatur, Luftfeuchtigkeit, Luftdruck, Regen der letzten Stunde und Wind, gemessen an der nächsten AEMET-Station (höchstens 40 km).
- Ein Dashboard-Widget und ein Szenen-Auslöser „Neue AEMET-Warnung“.
Voraussetzungen
- Gladys 5.2.0 oder neuer (die Aktion „Nächste Gemeinde finden“ wählt ein Gladys-Zuhause).
- Ein kostenloser API-Schlüssel von AEMET OpenData.
- Internetzugang für Gladys: Die Integration spricht nur mit
opendata.aemet.es.
Konfiguration
API-Schlüssel
Öffne die Schlüsselanfrage von AEMET OpenData, gib
deine E-Mail-Adresse ein und löse das Captcha. AEMET schickt einen Bestätigungslink und kurz darauf den
Schlüssel selbst per E-Mail: einen langen Text, der mit eyJ beginnt. Füge ihn in das Feld API-Schlüssel
ein.
Gemeinden
Das Feld Gemeinden nimmt die fünfstelligen INE-Codes der Gemeinden, durch Kommas getrennt (28079 für
Madrid, 07040 für Palma). Der Code steht in der Adresse der Gemeindeseite auf aemet.es (…/madrid-id28079):
Diese Adresse kann so eingefügt werden. Höchstens fünf Gemeinden.
Ohne Suche geht es mit der Aktion Nächste Gemeinde finden: sie nimmt ein Gladys-Zuhause (seine Position wird in den Gladys-Einstellungen festgelegt) und fügt die nächste spanische Gemeinde in das Feld ein. Lade die Seite neu, um sie zu sehen, und füge das Gerät dann im Tab Entdecken hinzu.
Die Aktion Verbindung testen prüft den Schlüssel und nennt jede Gemeinde und ihre Station.
Sprache
Das Feld Sprache legt die Sprache der Funktionsnamen fest (beim Hinzufügen des Geräts festgelegt: Lösche das Gerät und füge es erneut hinzu, um sie umzubenennen), des Himmelszustands, der Warnungen und der Szenentexte. Standardmäßig Französisch. Das Widget folgt der Sprache jedes Benutzers.
Das Gerät der Gemeinde
Jede Gemeinde ergibt ein Gerät AEMET <Gemeinde> mit diesen Funktionen.
Vorhersage
| Funktion | Einheit |
|---|---|
| Temperatur (Vorhersage), gefühlte Temperatur | °C |
| Luftfeuchtigkeit (Vorhersage) | % |
| Wind, Windböen (Vorhersage) | km/h |
| Windrichtung (woher er kommt, 0 = Norden; nichts bei Windstille) | ° |
| Regenwahrscheinlichkeit (das 6-Stunden-Fenster der aktuellen Stunde) | % |
| Regen dieser Stunde (Vorhersage) | mm |
| Himmel (Text, z. B. „Bedeckt mit Schnee“) | |
| UV-Index (Tagesmaximum), Tiefstwert heute, Höchstwert heute | Index, °C |
Die Vorhersage ist die, die AEMET Stunde für Stunde für die Gemeinde veröffentlicht: Die Werte ändern sich jede Stunde, auch zwischen zwei Abfragen.
Warnungen
| Funktion | Werte |
|---|---|
| Aktuelle Warnstufe | 0 keine, 1 gelb, 2 orange, 3 rot: die aktiven Warnungen |
| Höchste kommende Warnstufe | gleiche Skala, aktive und angekündigte Warnungen |
| Warnungen | Text, z. B. „Rot: Schnee; Orange: Tiefe Temperaturen (ab Mo 00:00)“ |
Eine Gemeinde erhält die Warnungen ihrer Meteoalerta-Zone (die zona_comarcal, die AEMET der Gemeinde gibt).
Messung der Station
Temperatur, Luftfeuchtigkeit, Luftdruck (auf Meereshöhe, wenn die Station ihn berechnet), Regen der letzten Stunde und mittlerer Wind der nächsten Station im Umkreis von 40 km. Eine Messung, die älter als drei Stunden ist, wird nicht veröffentlicht.
Aktualisierung und Kontingent
AEMET begrenzt die Anfragen jedes Schlüssels, und jede Abfrage kostet zwei Anfragen (AEMET antwortet mit der Adresse der Daten, die danach heruntergeladen werden). Die Integration liest für jede in Gladys hinzugefügte Gemeinde:
- die Vorhersagen alle 30 Minuten;
- die Station alle 30 Minuten (eine Messung pro Stunde bei AEMET);
- die Warnungen alle 10 Minuten, einmal pro Region für alle ihre Gemeinden.
Das sind etwa 24 Anfragen pro Stunde und Gemeinde. Nach einem Fehler wartet der nächste Versuch 5 Minuten, 15 nach einer Ablehnung wegen des Kontingents. Nur geänderte Werte werden an Gladys geschickt, jeder Wert mindestens alle 6 Stunden. Die Integration aktualisiert sich selbst: sie hängt nicht von der Abfrage durch Gladys ab.
Dashboard-Widget
AEMET-Vorhersage: Wähle die Gemeinde in den Einstellungen. Es zeigt live Temperatur, Regenwahrscheinlichkeit, Wind und UV, die nächsten fünf Tage (Himmel, Min / Max, Regenwahrscheinlichkeit) und die Warnungen in der Sprache des Benutzers. Keine Schaltflächen.
Szenen-Auslöser: neue AEMET-Warnung
Löst einmal pro Warnung aus, sobald AEMET sie veröffentlicht, auch Tage im Voraus, und erneut, wenn AEMET ihre Stufe erhöht. Warnungen, die beim Start der Integration oder beim Hinzufügen einer Gemeinde schon aktiv sind, werden nicht angekündigt.
Filter (alle optional): Gemeinde, Stufe (gelb, orange, rot), Ereignis (Regen, Schnee, Wind, Gewitter, hohe und tiefe Temperaturen, Küstenereignisse, Nebel, Staub, Lawinen, Rissaga, Tauwetter, anderes).
An die Szene weitergegebene Informationen: Gemeinde, Stufe (yellow, orange, red), Zusammenfassung (Stufe,
Ereignis und Zeitraum in der konfigurierten Sprache), AEMET-Überschrift (Spanisch), Beginn und Ende (ISO),
bereits aktiv.
Szenen-Beispiele
- Mich bei einer orangen oder roten Warnung am Ferienhaus benachrichtigen: Auslöser „Neue AEMET-Warnung“, Gemeinde = das Ferienhaus, Stufe = orange, rot; Aktion „Nachricht senden“ mit der Zusammenfassung.
- Die Rollläden vor einem Sturm schließen: Auslöser „Neue AEMET-Warnung“, Ereignis = Wind, Stufe = orange, rot; dann die Rollläden schließen.
- Frostwarnung: Auslöser auf die Funktion „Tiefstwert heute“ unter 0 °C, abends eine Nachricht senden.
Fehlerbehebung
- „AEMET hat den API-Schlüssel abgelehnt“: Prüfe den Schlüssel (eine Zeile, ohne Leerzeichen); fordere bei Bedarf einen neuen an.
- „AEMET begrenzt die Anfragen dieses Schlüssels“: Der Schlüssel wird mit einem anderen Werkzeug geteilt, oder es sind zu viele Gemeinden: Die Abfragen laufen von selbst weiter.
- Kein Gerät in „Entdecken“: Starte Verbindung testen; ein falscher Code wird dort genannt.
- Keine Stationswerte: keine AEMET-Station im Umkreis von 40 km, oder ihre Messungen sind verspätet.
- Protokolle: Die Integration schreibt nur Fehler und ihren Lebenszyklus; setze
LOG_LEVEL=debug, um jede Abfrage zu sehen. Der Schlüssel wird nie protokolliert.
Einschränkungen
- Nur Spanien (die Abdeckung von AEMET).
- Küstenwarnungen betreffen Küstenzonen, die sich von der Landzone einer Gemeinde unterscheiden: sie erreichen eine Gemeinde am Meer vielleicht nicht.
- Die nächste Station wird automatisch gewählt und passt vielleicht nicht zu einer Gemeinde in den Bergen.
- Die Funktionsnamen werden beim Hinzufügen des Geräts festgelegt.
- Ohne AEMET-Konto entwickelt: Die Warndateien wurden nach dem CAP-Format gebaut, das AEMET dokumentiert. Rückmeldungen sind willkommen.
Konfigurationseinstellungen
Diese Einstellungen fragt AEMET in seinem Konfigurationsbildschirm in Gladys ab.
| Einstellung | Typ | Pflichtfeld | Beschreibung |
|---|---|---|---|
| API-Schlüssel von AEMET OpenData | section | Nein | Der AEMET-Schlüssel ist kostenlos: Gib deine E-Mail-Adresse auf der AEMET-OpenData-Seite unten ein, öffne den erhaltenen Link, und der Schlüssel kommt kurz darauf per E-Mail. Die Integration fragt AEMET alle 30 Minuten ab (Warnungen: alle 10 Minuten), um im Kontingent des Schlüssels zu bleiben. Nicht mit AEMET verbunden. |
| API-Schlüssel | secret | Ja | |
| Gemeinden (INE-Codes) | string | Nein | Fünfstellige INE-Codes, durch Kommas getrennt: ein Gerät pro Gemeinde, höchstens fünf. Die Aktion „Nächste Gemeinde finden“ füllt das Feld anhand eines Gladys-Zuhauses aus. |
| Sprache der Gerätetexte | select | Nein | Namen der Funktionen (beim Hinzufügen des Geräts festgelegt), Himmelszustand, Warnungen und Szenentexte. |
So installierst du AEMET in Gladys
- Öffne in Gladys Integrationen: AEMET erscheint im Katalog neben den nativen Integrationen, mit einem Community-Badge.
- Klicke auf Installieren. Gladys lädt das Docker-Image (
ghcr.io/guim31/gladys-aemet:1.0.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/guim31/gladys-aemet.
AEMET 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
AEMET 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