Met Office Smart-Home-Integration, kostenlos und Open Source
Vorhersagen des britischen Met Office: Temperatur, Wind, Regen, UV, Sicht und 7 Tage.
Veröffentlicht von guim31
- Geräte
- Version 1.0.1
- Erfordert Gladys >=5.1.0
- ★ 0
Die Vorhersagen des Met Office, des nationalen Wetterdienstes des Vereinigten Königreichs, in Gladys: Temperatur, gefühlte Temperatur, Luftfeuchtigkeit, Luftdruck, Wind, Wahrscheinlichkeit und Intensität von Niederschlag, Sichtweite, UV-Index und das Wetter der Stunde, für dein Zuhause oder jeden anderen Ort, dazu die nächsten 7 Tage auf dem Dashboard. Die Daten stammen aus dem kostenlosen Tarif des Met Office Weather DataHub (die „Site-specific“-Vorhersage, die Home Assistant nutzt, seit der alte Dienst DataPoint eingestellt wurde).
Diese Integration ist nicht mit dem Met Office verbunden und wird nicht von ihm unterstützt. Entwickelt wurde sie ohne die Hardware und ohne DataHub-Konto (es wird nur der API-Schlüssel gebraucht, kein Gerät): Die Antworten der API stammen aus ihrer Dokumentation und aus den Tests von Home Assistant. Rückmeldungen sind willkommen.
Überblick
- Ein Gerät pro Ort: die Häuser von Gladys (ihr Standort in den Einstellungen) oder bis zu 3 als Koordinaten eingegebene Orte.
- Jedes Gerät trägt die Vorhersage der aktuellen Stunde: Temperatur, gefühlte Temperatur, Luftfeuchtigkeit, Luftdruck, Windgeschwindigkeit, Böen und Windrichtung, Niederschlagswahrscheinlichkeit, Niederschlagsintensität, Sichtweite, UV-Index und die Wetterlage als Text („Leichter Regen“, „Sonnig“…).
- Ein Dashboard-Widget: jetzt, dann die nächsten 7 Tage (tippe auf einen Tag für die Details) oder die nächsten 24 Stunden (die Temperaturkurve und die kommenden Stunden).
- Eine Szenenaktion: die Vorhersage für heute, morgen oder übermorgen (Höchst- und Tiefstwert, Regenrisiko, Böen, UV, Wetter) für die nächsten Schritte einer Szene.
- Nur lesend: Nichts wird gesteuert, an das Met Office wird nur die Position der Orte gesendet.
Das Modell des Met Office deckt die ganze Welt ab („Global Spot“) und ist über dem Vereinigten Königreich am genauesten.
Voraussetzungen
- Gladys 5.1 oder neuer.
- Ein kostenloses Konto und ein API-Schlüssel des Met Office Weather DataHub: Registriere dich auf datahub.metoffice.gov.uk, öffne das Produkt Site Specific, abonniere seinen kostenlosen Tarif (Global Spot) und kopiere den API-Schlüssel des Abonnements. Er wird nur einmal angezeigt: Wenn er verloren ist, setze ihn unter My subscriptions zurück.
- Ein Ort: ein Haus von Gladys mit Standort unter Einstellungen → Häuser oder Koordinaten.
- Gladys muss das Internet erreichen (
data.hub.api.metoffice.gov.uk).
Konfiguration
- Installiere Met Office unter Integrationen. Der Installationsbildschirm zeigt, dass sie den Standort deiner Häuser liest: So erstellt sie Vorhersagen für sie, ohne erneut nach Koordinaten zu fragen.
- Öffne den Tab Konfiguration und füge den API-Schlüssel ein.
- Orte für die Vorhersage: Die Häuser von Gladys (Standard) nimmt jedes Haus mit Standort,
höchstens 3; ein Haus ohne Standort wird übersprungen. Koordinaten verwendet das Feld
Koordinaten: Breite und Länge in Dezimalgrad, ein optionaler Name vor einem Doppelpunkt, Orte
durch Semikolons getrennt, zum Beispiel
Exeter: 50.7184, -3.5339; Leeds: 53.7997, -1.5492. - Wähle das Aktualisierungsintervall (standardmäßig 30 Minuten) und die Sprache der Texte.
- Speichere und klicke auf Verbindung testen: Jeder Ort antwortet mit seiner Temperatur, seinem Wetter und der Entfernung zum Modellpunkt, und der Bericht sagt, wie viele API-Aufrufe pro Tag die Einstellungen verbrauchen.
- Öffne den Tab Erkennung und füge die Orte hinzu.
Die Funktionsnamen werden beim Hinzufügen eines Orts festgelegt: Ändere die Sprache vorher. Ein Haus behält sein Gerät, wenn sein Standort verschoben wird; eingegebene Koordinaten, die um mehr als etwa 100 m geändert werden, ergeben ein neues Gerät.
Die Ortsgeräte
Jeder Ort ist ein Gerät namens „Met Office“ mit dem Namen des Hauses, dem eingegebenen Namen oder sonst dem Namen, den das Met Office seinem Modellpunkt gibt („Met Office Wavertree“). Seine Funktionen, in metrischen Einheiten:
| Funktion | Einheit | Hinweis |
|---|---|---|
| Temperatur | °C | in 1,5 m Höhe |
| Gefühlte Temperatur | °C | mit Wind und Luftfeuchtigkeit |
| Luftfeuchtigkeit | % | relative Luftfeuchtigkeit |
| Luftdruck | hPa | auf Meereshöhe reduziert |
| Windgeschwindigkeit, Windböen | km/h | in 10 m Höhe |
| Windrichtung | ° | woher der Wind kommt: 0 = Nord, 90 = Ost |
| Niederschlagswahrscheinlichkeit | % | der Stunde |
| Niederschlagsintensität | mm/h | |
| Sichtweite | km | |
| UV-Index | ||
| Wetterlage | Text | „Leichter Regen“, „Teilweise bewölkt“… in der eingestellten Sprache |
Das sind Vorhersagen für die aktuelle Stunde, keine Messungen: Das Modell des Met Office liefert einen Wert für jede Stunde, und das Gerät folgt der Stunde, die der Uhrzeit am nächsten liegt. Nur geänderte Werte werden an Gladys gesendet, und jeder Wert wird mindestens alle 6 Stunden erneut gesendet, damit er nie veraltet wirkt.
Kann das Met Office 6 Stunden lang nicht gelesen werden, wird das Gerät nicht mehr aktualisiert (eine alte Vorhersage würde aktuell wirken), und sein Badge in der Geräteliste wird orange, oder rot, solange der Dienst nicht antwortet. Mit der nächsten erfolgreichen Abfrage ist alles wieder da.
Dashboard-Widget
Füge das Widget Met Office Vorhersage zu einem Dashboard hinzu, wähle einen Ort (leer: der erste) und eine Ansicht:
- Nächste 7 Tage (Standard): Temperatur, Regenrisiko und Wind von jetzt, dann eine Zeile pro Tag mit seinem Wetter, seinem Höchstwert und dem Tiefstwert der folgenden Nacht sowie seinem Regenrisiko. Tippe auf einen Tag: Wetter am Tag und in der Nacht, Wind, Böen, UV-Index.
- Nächste 24 Stunden: die Temperaturkurve mit Höchst- und Tiefstwert, dann die nächsten 6 Stunden.
Die Uhrzeit des Modelllaufs steht unter dem Namen. Das Widget folgt den Einheiten deines Gladys-Profils (°F und mph bei imperialen Einheiten) und ruft nie die API auf: Es zeigt die zuletzt gelesenen Vorhersagen.
Szenenauslöser und -aktionen
Met Office: Vorhersage eines Tages (Szenenaktion) — wähle einen Ort (leer: der erste) und einen Tag (heute, morgen als Standard, übermorgen). Die nächsten Schritte der Szene können verwenden: den Ort, das Datum, das Wetter des Tages (Text) und seinen Met-Office-Code, die Höchsttemperatur, den Tiefstwert der folgenden Nacht, das Regenrisiko am Tag und in der Nacht (%), die Böen am Mittag (km/h) und den maximalen UV-Index. Die Texte sind in der Sprache der Konfiguration. Die Aktion liest die bereits abgerufene Vorhersage (alle 3 Stunden aktualisiert) und kostet keinen API-Aufruf.
Es gibt keinen Szenenauslöser: Das Wetter von jetzt ist eine Funktion des Ortsgeräts, die die Standardkarte Ein Gerätezustand ändert sich bereits abdeckt (zum Beispiel „Niederschlagswahrscheinlichkeit über 80“).
Szenenbeispiele
- Gartenbewässerung: Starte jeden Abend um 20 Uhr Met Office: Vorhersage eines Tages für morgen und bewässere nur, wenn das Regenrisiko am Tag unter 40 % liegt.
- Frostwarnung: Hole jeden Abend die Vorhersage für morgen und sende „Heute Nacht Frost, deck die Pflanzen ab“, wenn die Tiefsttemperatur unter 1 °C liegt.
- Markise: Wenn die Windböen des Orts 40 km/h überschreiten, fahre die Markise ein.
- Wäscheleine: Sende jeden Morgen „Guter Tag zum Wäscheaufhängen“, wenn das Regenrisiko des Tages unter 20 % liegt.
- Morgenbriefing: Sende um 7 Uhr „Heute: {Wetter}, {Max} °C, {Regen} % Regenrisiko“ mit den Ergebnissen der Aktion.
API-Kontingent und Aktualisierung
Der kostenlose Tarif der Site-specific-Vorhersage erlaubt 360 API-Aufrufe pro Tag, für alle Werkzeuge, die den Schlüssel nutzen (ein ungenutzter Aufruf wird nicht auf den nächsten Tag übertragen). Jeder Ort kostet einen Aufruf pro Aktualisierung der stündlichen Vorhersage und einen Aufruf alle 3 Stunden für die 7-Tage-Vorhersage: 56 Aufrufe pro Tag für einen Ort bei 30 Minuten, 104 bei 15 Minuten. Höchstens 3 Orte passen bei jedem Intervall ins Kontingent; die Integration hält etwa 10 % für Neustarts und Tests zurück und verlangsamt sich bei Bedarf selbst. Nur die zu Gladys hinzugefügten Orte werden aktualisiert. Wenn der Schlüssel woanders genutzt wird (ein anderes Smart-Home-System, ein Skript), wähle ein langsameres Intervall.
Ist das Kontingent trotzdem aufgebraucht (HTTP 429), pausieren die Abfragen eine Stunde. Ein abgelehnter Schlüssel wird jede Stunde erneut versucht oder sobald die Konfiguration gespeichert wird. Das Modell des Met Office läuft stündlich: Schneller als alle 15 Minuten zu aktualisieren, brächte nichts Neues.
Fehlerbehebung
- „Das Met Office lehnt den API-Schlüssel ab“: Kopiere den Schlüssel erneut aus dem DataHub unter My subscriptions (setze ihn zurück, wenn er verloren ist), und prüfe, dass es das Abonnement Site Specific ist.
- „Kein Ort für die Vorhersage“: Lege den Standort eines Hauses unter Einstellungen → Häuser in Gladys fest, oder wähle Koordinaten und fülle das Feld aus.
- „Ignoriert, keine Koordinaten“ im Testbericht: Ein Eintrag des Felds konnte nicht gelesen werden;
schreibe
Breite, Längein Dezimalgrad (51.5072, -0.1276). - „Tägliches API-Kontingent aufgebraucht“: siehe „API-Kontingent und Aktualisierung“; die Abfragen gehen nach einer Stunde weiter.
- „Der Met Office Weather DataHub antwortet nicht“: Gladys erreicht
data.hub.api.metoffice.gov.uknicht: Prüfe die Internetverbindung und das DNS. - Der Modellpunkt ist weit weg (Testbericht): Die Vorhersage gilt für den nächsten Punkt des Met-Office-Gitters, meist wenige Kilometer entfernt.
- Details: Setze
LOG_LEVEL=debugfür den Container, um jede Abfrage in den Protokollen der Integration zu sehen. Der API-Schlüssel wird dort nie geschrieben.
Grenzen
- Vorhersagen, keine Beobachtungen: Die Werte von „jetzt“ sind die Modellvorhersage für die aktuelle Stunde.
- Wind in km/h auf den Geräten (die Geschwindigkeitssensoren von Gladys kennen km/h und m/s, nicht mph); das Widget zeigt mph für Profile mit imperialen Einheiten.
- Höchstens 3 Orte, die Grenze des kostenlosen Kontingents. Ein kostenpflichtiger Tarif wird nicht berücksichtigt.
- Der Text der Wetterlage ist in der Sprache der Konfiguration, nicht in der jedes Profils.
- Der Tag einer Tagesvorhersage ist das Datum des Met Office (britische Zeit): Für einen Ort weit weg vom Vereinigten Königreich kann das „Heute“ des Widgets einige Stunden früher oder später beginnen.
- Keine Unwetterwarnungen: Die Warnungen des Met Office sind nicht Teil dieser API.
- Die Daten und ihre Verfügbarkeit hängen vom Met Office ab, das seine Tarife jederzeit ändern kann.
- Ohne die Hardware und ohne Konto entwickelt: Die Antworten stammen aus der API-Dokumentation und den Tests von Home Assistant, noch nicht von einem echten Schlüssel. Rückmeldungen sind im GitHub-Repository willkommen.
Konfigurationseinstellungen
Diese Einstellungen fragt Met Office in seinem Konfigurationsbildschirm in Gladys ab.
| Einstellung | Typ | Pflichtfeld | Beschreibung |
|---|---|---|---|
| Dein kostenloser API-Schlüssel | section | Nein | Erstelle ein kostenloses Konto im Met Office Weather DataHub, abonniere den kostenlosen Tarif von Site Specific Global Spot und kopiere den API-Schlüssel, der nur einmal angezeigt wird. Der kostenlose Tarif erlaubt 360 Aufrufe pro Tag. |
| API-Schlüssel | secret | Ja | Der Schlüssel des Site-Specific-Abonnements (ein langer Text, nicht dein Passwort). |
| Orte für die Vorhersage | select | Nein | Die in den Gladys-Einstellungen verorteten Häuser oder die Koordinaten unten. Höchstens 3 Orte. |
| Koordinaten | string | Nein | Nur mit Koordinaten verwendet. Breite, Länge, ein optionaler Name vor einem Doppelpunkt; Orte durch Semikolons getrennt. |
| Aktualisierungsintervall | select | Nein | Wie oft die stündliche Vorhersage jedes Orts gelesen wird; die 7-Tage-Vorhersage alle 3 Stunden. Passt in 360 Aufrufe pro Tag. |
| Sprache der Texte | select | Nein | Funktionsnamen beim Hinzufügen eines Orts und die Wetterlage (Leichter Regen…). |
So installierst du Met Office in Gladys
- Öffne in Gladys Integrationen: Met Office erscheint im Katalog neben den nativen Integrationen, mit einem Community-Badge.
- Klicke auf Installieren. Gladys lädt das Docker-Image (
ghcr.io/guim31/gladys-met-office: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-met-office.
Met Office benötigt Gladys >=5.1.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
Met Office 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