IPMA Smart-Home-Integration, kostenlos und Open Source
Offizielles Wetter Portugals vom IPMA: Vorhersagen, Stationen, Warnungen, UV, Waldbrandgefahr.
Veröffentlicht von guim31
- Geräte
- Version 1.0.1
- Erfordert Gladys >=5.2.0
- ★ 0
Das offizielle Wetter Portugals — Festland, Madeira und Azoren — in Gladys, vom IPMA (Instituto Português do Mar e da Atmosfera), dem portugiesischen Wetterdienst: Vorhersagen, Stationsbeobachtungen, Wetterwarnungen, UV-Index und Waldbrandgefahr. Für das Familienhaus dort, oder einfach für das Leben in Portugal.
Die Integration liest die kostenlosen offenen Daten des IPMA: kein Konto, kein API-Schlüssel. Die Integration ist nicht mit dem IPMA verbunden.
Entwickelt ohne echte Gladys-Instanz und ohne Netzwerkzugang zum IPMA: gebaut und getestet mit echten IPMA-Antworten, die die Bibliothek
pyipmaveröffentlicht. Rückmeldungen willkommen — öffne ein Issue auf GitHub, wenn dir ein Wert falsch vorkommt.
Was du bekommst
- Ein Gerät pro Ort (eine Gemeinde, unter den 423 Vorhersageorten des IPMA), genannt
IPMA <Ort>, mit:- aktueller Temperatur, Luftfeuchtigkeit, Luftdruck, Wind und Regen der nächsten Wetterstation;
- Minimum und Maximum, Regenwahrscheinlichkeit und Wetter für heute und morgen;
- Wind (Stärke und Richtung) und UV-Index von heute;
- der Waldbrandgefahr von heute (nur Festland);
- der Warnstufe (grün, gelb, orange, rot) und den aktuellen Warnungen in Worten.
- Ein Dashboard-Widget: 5-Tage-Vorhersage mit Wettersymbolen, Live-Temperatur, UV, Waldbrandgefahr und Warnungen.
- Ein Szenen-Auslöser „IPMA-Wetterwarnung ausgegeben“, mit Stufe, Phänomen und Zeitraum.
Alles ist nur lesend: Nichts in Gladys kann beim IPMA etwas ändern.
Voraussetzungen
- Gladys 5.2.0 oder neuer.
- Internetzugang von Gladys zu
api.ipma.pt(HTTPS). - Sonst nichts: kein Konto, kein Schlüssel.
Konfiguration
Einstellungen
| Einstellung | Wirkung |
|---|---|
| Ort | Der zu verfolgende IPMA-Ort: eine Gemeinde auf dem Festland, auf Madeira oder den Azoren (portugiesische Namen, mit Distrikt oder Insel). |
| Weitere Orte | Optional. Weitere Orte, durch Kommas getrennt: Funchal, Ponta Delgada, Lagoa (Faro). Namen werden ohne Akzente und Groß-/Kleinschreibung erkannt; gib den Distrikt an, wenn ein Name mehrdeutig ist. Höchstens 10 Orte. |
| Aktualisierungsintervall | 15 Minuten, 30 Minuten (Standard) oder 1 Stunde. |
| Sprache der Namen und Texte | Sprache der Funktionsnamen neuer Geräte, der Wetter- und Warntexte und der Szenenvariablen. Standardmäßig Französisch. |
Öffne dann den Tab Entdecken und füge das Gerät jedes Ortes hinzu. Die Werte kommen innerhalb weniger Sekunden.
Ort nächst einem Haus
Die Schaltfläche Ort nächst einem Haus verwenden wählt den IPMA-Ort, der einem Haus von Gladys am nächsten liegt, und speichert ihn als Hauptort. Gladys fragt bei der Installation, ob die Position der Häuser mit der Integration geteilt werden darf: Die Position wird nur gelesen, wenn du diese Schaltfläche drückst, und nie in die Logs geschrieben. Ein Haus, das mehr als 60 km von jedem IPMA-Ort entfernt ist (zum Beispiel ein Haus in Frankreich), wird abgelehnt: Das IPMA deckt nur Portugal ab.
Das Gerät
| Funktion | Typ in Gladys | Quelle |
|---|---|---|
| Temperatur (Station) | Temperatur, °C | nächste IPMA-Station (höchstens 50 km), letzter Stundenwert der letzten 3 h |
| Luftfeuchtigkeit (Station) | Luftfeuchtigkeit, % | dieselbe Station |
| Luftdruck (Station) | Druck, hPa | dieselbe Station (nicht jede misst ihn) |
| Wind (Station) | Geschwindigkeit, km/h | dieselbe Station |
| Regen letzte Stunde (Station) | Niederschlag, mm/h | dieselbe Station (nicht jede hat einen Regenmesser) |
| Min / Max heute, Min / Max morgen | Minimum / Maximum, °C | IPMA-Vorhersage des Ortes |
| Regenwahrscheinlichkeit heute / morgen | Zähler, % | IPMA-Vorhersage |
| Wetter heute / morgen | Text | IPMA-Wettertyp, übersetzt („Leichter Regen oder Niesel“) |
| Wind heute | Text | IPMA-Windklasse und -richtung („Mäßig, NW“) |
| UV-Index | UV-Index | IPMA-Vorhersage, Tagesmaximum |
| Waldbrandgefahr (1-5) | Zähler | RCM des IPMA: 1 gering, 2 mäßig, 3 hoch, 4 sehr hoch, 5 maximal (Festland) |
| Warnstufe | Risikostufe | höchste aktive Warnung: 0 keine (grün), 1 gelb, 2 orange, 3 rot |
| Wetterwarnungen | Text | „Orange: Hoher Seegang · Gelb: Wind“, oder die nächste kommende Warnung |
Die Warnstufe nutzt das Risiko-Abzeichen von Gladys: grün, gelb, orange, rot — die Farben des IPMA. Ein Wert, den das IPMA nicht liefert (keine Station in der Nähe, keine UV-Vorhersage für den Tag), wird einfach nicht aktualisiert. Die Wettertexte folgen der Sprache der Konfiguration; die Funktionsnamen werden beim Hinzufügen des Geräts festgelegt.
Dashboard-Widget
Füge das Widget IPMA-Vorhersage zu einem Dashboard hinzu und wähle den Ort (leer: der erste). Es zeigt:
- die verwendete Station und die Uhrzeit ihres letzten Messwerts;
- die Live-Temperatur, den UV-Index, die Waldbrandgefahr und die Warnstufe;
- die noch nicht beendeten Warnungen (aktiv oder bevorstehend), mit dem Text des IPMA (auf Portugiesisch) per Tippen;
- fünf Tage: Wetter mit Symbol, Minimum / Maximum, Regenwahrscheinlichkeit.
Szenen-Auslöser
IPMA-Wetterwarnung ausgegeben löst einmal für jede Warnung aus, die das IPMA für einen Ort ausgibt — oft am Vortag. Eine auf eine höhere Stufe angehobene Warnung (von gelb auf orange) löst erneut aus. Ein Neustart der Integration löst dieselben Warnungen nicht noch einmal aus.
Filter: der Ort (Gerät), die Stufen (gelb, orange, rot), die Phänomene (Regen, Gewitter, Wind, hoher Seegang, Hitze, Kälte, Schnee, Nebel, Sonstiges).
Variablen für die folgenden Aktionen der Szene:
| Variable | Beispiel |
|---|---|
location | Aveiro |
level | orange |
level_label | Orange |
phenomenon | coastal |
phenomenon_label | Hoher Seegang |
starts_at | 2022-07-29T05:00:00.000Z |
ends_at | 2022-07-29T20:00:00.000Z |
active | false (noch nicht begonnen) |
description | der Text des IPMA, portugiesisch |
Schaltflächen der Konfiguration
- Ort nächst einem Haus verwenden: siehe oben.
- IPMA jetzt prüfen: liest das IPMA für jeden konfigurierten Ort (zu Gladys hinzugefügt oder nicht) und sagt, was zurückkam: Stationstemperatur, Minimum und Maximum von heute, Anzahl der Warnungen, unbekannte Ortsnamen, nicht erreichbare Dateien.
Szenen-Beispiele
- Sturm am Familienhaus: Auslöser „IPMA-Wetterwarnung ausgegeben“, Ort Aveiro, Stufen orange
und rot → eine Nachricht mit den Variablen
level_label,phenomenon_labelundlocationsenden: „IPMA-Warnung Orange in Aveiro: Hoher Seegang“. - Hitzewelle: Auslöser „IPMA-Wetterwarnung ausgegeben“, Phänomen Hitze → den Nachbarn ans Gießen des Gartens erinnern.
- Waldbrandgefahr: Wenn die Funktion „Waldbrandgefahr (1-5)“ über 3 steigt → Benachrichtigung „heute kein Grillen“.
- Regenwahrscheinlichkeit: jeden Abend um 20 Uhr, wenn „Regenwahrscheinlichkeit morgen“ über 70 % liegt → die Markise einfahren.
Daten und Aktualisierung
Die Integration aktualisiert sich selbst (sie hängt nicht vom Abfragen durch Gladys ab): alle 15, 30 oder 60 Minuten liest sie fünf Dateien des IPMA — die Stationen (einmal am Tag), die Beobachtungen der letzten 24 Stunden, die Warnungen, die heutige Waldbrandgefahr und eine Vorhersage pro Ort. Diese Dateien decken das ganze Land ab: Zehn Orte kosten zehn Vorhersagedateien plus vier gemeinsame pro Aktualisierung. Das IPMA veröffentlicht kein Kontingent für seine offenen Daten; die Integration bleibt weit unter dem, was seine eigene Website lädt. Für einen Ort, dessen Gerät nicht zu Gladys hinzugefügt ist, wird nichts gelesen.
Das IPMA aktualisiert seine Vorhersagen mehrmals am Tag, seine Stationen einmal pro Stunde und seine Warnungen nach Bedarf. Ein unveränderter Wert wird alle 6 Stunden erneut an Gladys gesendet, damit nie „Kein aktueller Wert“ erscheint. Die Daten sind © IPMA, weiterverwendet nach seinen Bedingungen für offene Daten, mit Quellenangabe.
Fehlerbehebung
- „Wähle einen Ort in der Konfiguration“: Kein Ort ist gewählt — wähle einen, oder nutze die Haus-Schaltfläche.
- „IPMA antwortet nicht“: Keine einzige Datei des IPMA konnte gelesen werden. Prüfe, ob Gladys das Internet erreicht, und drücke dann IPMA jetzt prüfen. Die Integration versucht es bei jeder Aktualisierung erneut und meldet in ihren Logs, wenn das IPMA wieder antwortet.
- Die Stationswerte bleiben leer: Keine IPMA-Station im Umkreis von 50 km hat in den letzten 3 Stunden einen Wert gesendet (häufig auf kleinen Inseln). Die Vorhersage funktioniert trotzdem.
- Ein Ort unter „Weitere Orte“ wird ignoriert: Der Name ist unbekannt — prüfe die
Schreibweise, oder gib den Distrikt an:
Lagoa (Faro). Die Schaltfläche IPMA jetzt prüfen listet die unbekannten Namen auf. - Mehr Details: Setze
LOG_LEVEL=debugbei der Integration, um jede Aktualisierung in ihren Logs zu sehen.
Grenzen
- Nur Portugal (Festland, Madeira, Azoren): Das IPMA deckt nichts anderes ab.
- Keine Waldbrandgefahr auf Madeira und den Azoren: Das IPMA sagt sie nur für das Festland vorher.
- Die verwendete Vorhersagedatei ist die der IPMA-Website (
public-data), wie bei der Home Assistant-Integration; das IPMA kann sie ohne Vorankündigung ändern. - Das IPMA verfasst seine Warnungen auf Portugiesisch: Stufe und Phänomen werden übersetzt, der freie Text nicht.
- Nicht mit dem IPMA verbunden. Entwickelt ohne echte Gladys-Instanz: Rückmeldungen willkommen.
Konfigurationseinstellungen
Diese Einstellungen fragt IPMA in seinem Konfigurationsbildschirm in Gladys ab.
| Einstellung | Typ | Pflichtfeld | Beschreibung |
|---|---|---|---|
| Wetter in Portugal | section | Nein | Vorhersagen, Beobachtungen, Wetterwarnungen, UV-Index und Waldbrandgefahr vom IPMA, dem portugiesischen Wetterdienst: Festland, Madeira und Azoren. Kostenlose offene Daten, ohne Konto. Wähle einen Ort und füge dann sein Gerät im Tab Entdecken hinzu. Nicht mit dem IPMA verbunden. |
| Ort | select | Ja | Zu verfolgender IPMA-Ort (Gemeinde). Die Schaltfläche „Ort nächst einem Haus verwenden“ unten kann ihn für dich wählen. |
| Weitere Orte | string | Nein | Optional: weitere IPMA-Orte, durch Kommas getrennt, je ein Gerät (insgesamt 10 Orte). |
| Aktualisierungsintervall | select | Nein | Wie oft das IPMA gelesen wird. Seine Stationen melden einmal pro Stunde. |
| Sprache der Namen und Texte | select | Nein | Funktionsnamen neuer Geräte, Wetter- und Warntexte, Szenenvariablen. |
So installierst du IPMA in Gladys
- Öffne in Gladys Integrationen: IPMA erscheint im Katalog neben den nativen Integrationen, mit einem Community-Badge.
- Klicke auf Installieren. Gladys lädt das Docker-Image (
ghcr.io/guim31/gladys-ipma: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-ipma.
IPMA 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
IPMA 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