Météo Bénélux Smart-Home-Integration, kostenlos und Open Source
Aktuelles Wetter, Vorhersagen und Warnungen des IRM/KMI für Belgien, Luxemburg und die Niederlande.
Veröffentlicht von gboulvin
- Geräte
- Version 1.1.1
- Erfordert Gladys >=4.86.0
- ★ 0
Überblick
Diese Integration bringt die Wetterdaten des Königlichen Meteorologischen Instituts von Belgien (IRM/KMI) für unterstützte Standorte in Belgien, Luxemburg und den Niederlanden nach Gladys.1 Gladys übermittelt den angefragten Standort: Sie müssen weder Ort noch Station noch API-Schlüssel konfigurieren.
Das IRM/KMI veröffentlicht keine offizielle Dokumentation der hier genutzten mobilen API. Ihr Verhalten kann sich ohne Vorankündigung ändern; ist der Dienst nicht erreichbar, schreibt die Integration eine eindeutige Fehlermeldung in ihre Protokolle.2
| Verfügbare Daten | Anzeige in Gladys |
|---|---|
| Aktuelles Wetter | Temperatur, Himmelszustand, Luftdruck, Wind, Böen und UV-Index, sofern der Anbieter sie liefert. |
| Stundenvorhersagen | Bis zu 24 Zeitpunkte mit Temperatur, Niederschlag, Niederschlagswahrscheinlichkeit, Wind und Luftdruck. |
| Tagesvorhersagen | Bis zu 8 volle Tage mit Tiefst- und Höchsttemperatur, Niederschlag, Wind sowie Sonnenauf- und -untergang. |
| Warnungen | Wind, Regen, Schnee/Glätte, Gewitter, Nebel, Kälte, Hitze und Küstenwarnungen, sofern verfügbar. |
Installation
Installieren Sie die Integration aus dem Gladys-Katalog, sobald ihr Docker-Image veröffentlicht ist. Wenn Sie das Repository manuell installieren, bauen Sie zuerst ein Image für die Architektur Ihres Servers und tragen Sie es im Manifest der Integration ein.
Das Projekt folgt der offiziellen Gladys-Vorlage für Integrationen. Wenn Sie eine eigene Kopie veröffentlichen, richten Sie docker_image und cover_image in gladys-assistant-integration.json auf Ihr eigenes GitHub-Repository aus. Der mitgelieferte Release-Workflow baut für jede Version ein Multi-Architektur-Image.3
Konfiguration
Es werden keine persönlichen Daten benötigt. Die optionale Einstellung Cache-Dauer beträgt standardmäßig 600 Sekunden. Sie bestimmt, wie lange eine heruntergeladene Vorhersage für denselben Standort und dasselbe Einheitensystem wiederverwendet werden darf. Mit 0 wird der Cache deaktiviert; dadurch steigt die Zahl der Anfragen an das IRM/KMI.
| Wert | Empfohlene Verwendung |
|---|---|
0 | Gelegentliche Fehlersuche oder ausnahmsweise jede Netzwerkanfrage erzwingen. |
300 bis 900 | Normaler Betrieb; weniger Anfragen, ohne veraltete Vorhersagen. |
3600 | Nur für Installationen, die sehr häufig denselben Standort abfragen. |
Funktionsweise und Einheiten
Gladys sendet eine Anfrage mit Breitengrad, Längengrad, Sprache und den bevorzugten Einheiten des Benutzers. Die Integration rundet die Koordinaten, fragt die IRM/KMI-API ab und gibt das Ergebnis im Standard-Wetterformat von Gladys zurück. Die Quelldaten sind metrisch; der Wind wird im metrischen System in Metern pro Sekunde zurückgegeben, und die Werte werden in Fahrenheit, Meilen pro Stunde und Zoll umgerechnet, wenn Gladys US-Einheiten anfordert.4
Warnungen werden in der Sprache des Benutzers angezeigt, sofern das IRM/KMI sie liefert (Deutsch, Französisch, Niederländisch oder Englisch), andernfalls auf Englisch. Die IRM/KMI-Warnstufen 1, 2 und 3 werden zu den Schweregraden minor, moderate und severe. Warnungen ohne verlässlichen Typ oder Schweregrad werden bewusst ausgelassen, um mehrdeutige Meldungen zu vermeiden.
Einschränkungen
Die Referenz-API liefert weder Luftfeuchtigkeit noch Taupunkt; diese Werte werden daher nicht angezeigt. Eine Tagesvorhersage kann zwei Wetterzustände enthalten; nur der erste wird übernommen. Regenradar-Animation und Pollenflug sind nicht Teil dieser Version, da die Wetterschnittstelle von Gladys sie nicht in geeigneter Form überträgt.1 2
Fehlerbehebung
Wird keine Vorhersage angezeigt, prüfen Sie zuerst, ob der Gladys-Standort im unterstützten Benelux-Gebiet liegt. Sehen Sie dann in die Protokolle der Integration: Eine fehlgeschlagene HTTP-Antwort, eine ungültige Antwort oder eine Zeitüberschreitung wird dort ausdrücklich vermerkt. Bei einem vorübergehenden Ausfall des Anbieters hilft ein späterer erneuter Versuch; eine längere Cache-Dauer kann Fehler durch wiederholte Anfragen ebenfalls verringern.
Referenzen
Konfigurationseinstellungen
Diese Einstellungen fragt Météo Bénélux in seinem Konfigurationsbildschirm in Gladys ab.
| Einstellung | Typ | Pflichtfeld | Beschreibung |
|---|---|---|---|
| IRM/KMI-Daten | section | Nein | Diese Integration nutzt die undokumentierte mobile API des Königlichen Meteorologischen Instituts von Belgien. Es werden weder ein Konto noch ein persönlicher Schlüssel benötigt. Der Dienst deckt Belgien, Luxemburg und die Niederlande ab; seine Schnittstelle kann sich ohne Vorankündigung ändern. |
| Cache-Dauer (Sekunden) | number | Nein | Wie lange eine Vorhersage für denselben Ort aufbewahrt wird. 0 deaktiviert den Cache. |
So installierst du Météo Bénélux in Gladys
- Öffne in Gladys Integrationen: Météo Bénélux erscheint im Katalog neben den nativen Integrationen, mit einem Community-Badge.
- Klicke auf Installieren. Gladys lädt das Docker-Image (
ghcr.io/gboulvin/gladys-irm-kmi-v2:1.1.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/gboulvin/Gladys-IRM-KMI-V2.
Météo Bénélux benötigt Gladys >=4.86.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
Météo Bénélux 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 gboulvin 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