NOAA Tides Smart-Home-Integration, kostenlos und Open Source
Gezeiten an den NOAA-Stationen der USA: Hoch- und Niedrigwasser, Wasserstand, Warnungen.
Veröffentlicht von guim31
- Geräte
- Version 1.0.0
- Erfordert Gladys >=5.1.0
- ★ 0
Bringt die Gezeitenvorhersagen der NOAA (CO-OPS, Tides & Currents) nach Gladys, für die 3.500 Gezeitenstationen der USA und ihrer Gebiete: das nächste Hoch- und Niedrigwasser, den vorhergesagten Wasserstand jetzt, ob das Wasser steigt oder fällt und, wo die Station sie misst, den gemessenen Wasserstand und die Wassertemperatur. Kein Konto, kein Schlüssel.
Für die Häfen Frankreichs nimm die Integration Marées France von William-De71: Diese hier ist ihr Gegenstück für die USA, mit denselben Funktionen, soweit die NOAA es erlaubt.
Nicht für die Navigation. Die Vorhersagen sind astronomisch: Wind, Luftdruck und Abfluss der Flüsse können den echten Wasserstand deutlich verschieben. Die Integration hängt von deinem Gladys, deinem Internetzugang und einem öffentlichen Dienst ab. Nutze die offiziellen Produkte der NOAA und die Warnungen des National Weather Service für alles, was zählt. Diese Integration ist nicht mit der NOAA verbunden.
Was du bekommst
- Ein Gerät pro verfolgter Station, „Gezeiten <Station>“ genannt: der vorhergesagte Wasserstand jetzt, die Gezeit (steigend oder fallend), die nächste Gezeit als Satz („Hochwasser um 17:39 (1,80 m)“), die Minuten bis zum nächsten Hochwasser und bis zum nächsten Niedrigwasser und ihre Höhen.
- An den Stationen, die sie messen: der gemessene Wasserstand (alle 6 Minuten) und die Wassertemperatur.
- Höhen über MLLW (Mean Lower Low Water, das Kartennull der US-Seekarten), in Metern oder Fuß; Temperaturen in °C oder °F.
- Zwei Szenen-Auslöser: ein Hoch- oder Niedrigwasser (zu seiner Zeit oder bis zu 6 Stunden vorher) und ein Hochwasser über einem Warnpegel (deinem oder dem NOAA-Pegel für leichte Überflutung der Station), bis zu 24 Stunden vorher.
- Eine Szenen-Aktion, die den folgenden Aktionen die nächste Gezeit gibt (Uhrzeit, Höhe, Satz).
- Ein Dashboard-Widget: die Gezeitenkurve des Tages mit Hoch- und Niedrigwasser, die nächsten vier Gezeiten und Live-Werte.
- Eine Schaltfläche „Stationen suchen“: die Stationen nahe deinem Haus, nahe einem Punkt, nach Name oder Kennung.
Voraussetzungen
- Gladys Assistant 5.1.0 oder neuer (Widget, Szenen-Auslöser und Aktion).
- Internetzugang von Gladys zu
api.tidesandcurrents.noaa.gov. - Der Standort deines Hauses in Gladys, nur für „Stationen suchen“ ohne Text.
Konfiguration
Einstellungen
- Stationen: Kennungen oder Namen der Stationen, durch Kommas getrennt, höchstens 10. Eine
Kennung (9414290) ist eindeutig. Ein Name („Boston“, „San Francisco“) nimmt die passende
Station, zuerst eine Referenzstation. Eine Seite von tidesandcurrents.noaa.gov mit
?id=geht auch. - Einheiten: Meter und °C (Standard) oder Fuß und °F. Gladys legt die Einheit einer Funktion beim Anlegen des Geräts fest: Klicke nach einer Änderung im Tab „Entdecken“ bei den Geräten auf Aktualisieren.
- Warnpegel der Hochwasser: für den Auslöser „Hochwasser über dem Warnpegel“, in den Einheiten
oben, über MLLW. Ein Pegel für alle Stationen (
2,1), einer pro Station (9414290=2,1; 8443970=3,6) oder beides. Leer: der NOAA-Pegel für leichte Überflutung der Station, falls sie einen hat (Pegelstationen). - Sprache der Texte: der Geräte- und Funktionsnamen (beim Anlegen festgelegt) und der Texte für die Szenen. Standardmäßig Französisch.
Speichere, öffne den Tab Entdecken und lege die gewünschten Geräte an.
Deine Stationen finden
Die Schaltfläche Stationen suchen listet bis zu 10 Stationen mit Kennung, Bundesstaat, Entfernung und Art auf:
- lass das Feld leer für die Stationen, die deinem Haus am nächsten sind;
- gib Breiten- und Längengrad ein (
37.8, -122.47) für die Stationen nahe diesem Punkt; - gib einen Namen ein, bei Bedarf mit Bundesstaat (
Sausalito CA), oder eine Kennung.
Eine Referenzstation hat die vollständige Kurve alle 6 Minuten. Eine Nebenstation hat nur ihr Hoch- und Niedrigwasser (Abweichungen von einer Referenzstation): Der Stand dazwischen wird mit der Kosinus-Interpolation der Gezeitentafeln berechnet, auf wenige Zentimeter genau.
Geräte
| Funktion | Typ | Hinweise |
|---|---|---|
| Vorhergesagter Wasserstand | Pegel | jetzt, Kurve der Referenzstationen, sonst interpoliert |
| Gezeit | Text | Steigend / Fallend |
| Nächste Gezeit | Text | „Hochwasser um 17:39 (1,80 m)“ |
| Nächstes Hochwasser in | Dauer | Minuten |
| Höhe des nächsten Hochwassers | Pegel | |
| Nächstes Niedrigwasser in | Dauer | Minuten |
| Höhe des nächsten Niedrigwassers | Pegel | |
| Gemessener Wasserstand | Pegel | Stationen mit aktivem Pegelsensor, alle 6 Minuten |
| Wassertemperatur | Temperatur | Stationen mit aktivem Wassertemperatursensor |
Die Zustände werden jede Minute von der Integration selbst aktualisiert (die Countdowns laufen jede Minute weiter). Eine Messung, die älter als eine Stunde ist (drei für die Temperatur), wird nicht erneut gesendet. Die Uhrzeiten stehen in der Zeitzone deines Gladys, egal in welcher Zeitzone die Station liegt.
Dashboard-Widget
Nächste Gezeiten: für die in den Einstellungen gewählte Station (oder die zuerst angelegte) der vorhergesagte Wasserstand und die Messwerte als Live-Kacheln, die Kurve von 2 Stunden vorher bis 22 Stunden danach mit Hoch- und Niedrigwasser und einer „Jetzt“-Markierung, die nächsten vier Gezeiten, der Warnpegel des Hochwasser-Auslösers und ein Link zur Seite der Station auf Tides & Currents.
Szenen-Auslöser
- Gezeiten: Hoch- oder Niedrigwasser: wähle die Station, Hochwasser, Niedrigwasser oder beides und wann: zur Zeit der Gezeit oder 15, 30, 45 Minuten, 1, 1,5, 2, 3, 4 oder 6 Stunden vorher. Die Szene erhält die Station, die Gezeit, ihre Uhrzeit, ihre Höhe, die Einheit und einen fertigen Satz.
- Gezeiten: Hochwasser über dem Warnpegel: ein vorhergesagtes Hochwasser erreicht den Warnpegel der Konfiguration (oder den NOAA-Pegel für leichte Überflutung): zu seiner Zeit oder 30 Minuten bis 24 Stunden vorher. Die Szene erhält auch den Warnpegel.
Ein Schwellwert für den gemessenen Stand braucht keinen Auslöser: Nutze die Gladys-Bedingung „ein Gerätewert steigt über“ auf der Funktion Gemessener Wasserstand.
Szenen-Aktion
Gezeiten: nächste Gezeit abrufen: für eine Station das nächste Hochwasser, Niedrigwasser oder eines von beiden. Die folgenden Aktionen können ihre Uhrzeit, ihre Höhe, die verbleibenden Minuten, den vorhergesagten Stand jetzt, die Tendenz und einen Satz („Hochwasser um 17:39 (1,80 m)“) verwenden.
Szenen-Beispiele
- Spaziergang bei Niedrigwasser: Auslöser „Gezeiten: Hoch- oder Niedrigwasser“, Niedrigwasser, 1 Stunde vorher → den Satz des Auslösers an dein Handy senden, Zeit für den Strand.
- Warnung vor Springflut: Auslöser „Gezeiten: Hochwasser über dem Warnpegel“, 12 Stunden vorher → den Satz an die Familie senden und das Garagentor rechtzeitig schließen.
- Morgenbriefing: um 7 Uhr Aktion „Gezeiten: nächste Gezeit abrufen“, dann ihren Satz mit dem Wetter senden.
Datenquellen und Kontingente
- Daten: NOAA CO-OPS (Center for Operational Oceanographic Products and Services), API
api.tidesandcurrents.noaa.gov, gemeinfrei. Kein Schlüssel; jede Anfrage nennt die Anwendung (application=gladys-noaa-tides), wie die NOAA es wünscht. - Anfragen pro Station: die Details einmal pro Woche, die Vorhersagen alle 6 Stunden (2
Anfragen), die letzten Messungen alle 6 Minuten für die angelegten Geräte, deren Station misst
(1 oder 2 Anfragen). Die Stationsliste (etwa 3.500 Stationen) einmal pro Woche, in
/datagespeichert. - Die Vorhersagen folgen der Epoche und den Bezugshöhen der NOAA; sie decken die nächsten zwei Tage ab, ein kurzer Ausfall der NOAA ändert also nichts.
Fehlerbehebung
- „Unbekannte Station“ auf dem Konfigurationsbildschirm: Kennung oder Name stehen nicht in der NOAA-Liste der Gezeitenstationen. Nutze Stationen suchen und kopiere die Kennung.
- Kein gemessener Stand, keine Temperatur: Die Station hat keinen aktiven Sensor (die meisten haben nur Vorhersagen). Die NOAA markiert einen defekten Sensor als inaktiv: Die Funktion kommt nach „Aktualisieren“ im Tab „Entdecken“ zurück, sobald er repariert ist.
- Höhen in Metern, obwohl Fuß gewählt: Klicke im Tab „Entdecken“ beim Gerät auf Aktualisieren.
- „NOAA Tides & Currents antwortet nicht“: Der Dienst ist ausgefallen oder von Gladys aus nicht erreichbar; Countdowns und Auslöser laufen mit den bekannten Vorhersagen weiter.
- Ausführliche Protokolle: setze
LOG_LEVEL=debugam Container.
Grenzen
- Nur Gezeitenstationen der NOAA (USA, Puerto Rico, Pazifikinseln…): keine Strömungen, keine Pegel der Großen Seen.
- Nur Höhen über MLLW; andere Bezugshöhen werden nicht angeboten.
- Nicht für die Navigation: astronomische Vorhersagen, ohne Wind und Luftdruck.
- Den NOAA-Pegel für leichte Überflutung gibt es nur an den Pegelstationen.
- Diese Integration ist nicht mit der NOAA verbunden.
Konfigurationseinstellungen
Diese Einstellungen fragt NOAA Tides in seinem Konfigurationsbildschirm in Gladys ab.
| Einstellung | Typ | Pflichtfeld | Beschreibung |
|---|---|---|---|
| Deine Gezeitenstationen | section | Nein | Verfolge die Gezeitenvorhersagen der NOAA (Tides & Currents) an den Stationen der USA und ihrer Gebiete. „Stationen suchen“ unten zeigt ihre Kennungen. Speichere und lege dann die Geräte im Tab „Entdecken“ an. |
| Stationen | string | Nein | Kennungen oder Namen der Stationen, durch Kommas getrennt (höchstens 10). Eine Kennung ist eindeutig; ein Name nimmt die beste Übereinstimmung. |
| Einheiten | select | Nein | Der Höhen und Temperaturen. Klicke nach einer Änderung im Tab „Entdecken“ bei den Geräten auf „Aktualisieren“. |
| Warnpegel der Hochwasser | string | Nein | Für den Auslöser „Hochwasser über dem Warnpegel“, über MLLW, in den Einheiten oben: ein Pegel (2,1) oder einer pro Station (9414290=2,1; 8443970=3,6). Leer: der Pegel für leichte Überflutung der NOAA, falls die Station einen hat. |
| Sprache der Texte | select | Nein | Der Geräte- und Funktionsnamen (beim Anlegen der Geräte festgelegt) und der Texte für die Szenen. |
So installierst du NOAA Tides in Gladys
- Öffne in Gladys Integrationen: NOAA Tides erscheint im Katalog neben den nativen Integrationen, mit einem Community-Badge.
- Klicke auf Installieren. Gladys lädt das Docker-Image (
ghcr.io/guim31/gladys-noaa-tides:1.0.0) 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-noaa-tides.
NOAA Tides 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
NOAA Tides 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