Intégration domotique NOAA Tides, gratuite et open source
Marées aux stations NOAA des États-Unis : pleines et basses mers, hauteur d’eau, alertes.
Publiée par guim31
- Appareils
- Version 1.0.0
- Nécessite Gladys >=5.1.0
- ★ 0
Apporte dans Gladys les prédictions de marée de la NOAA (CO-OPS, Tides & Currents), aux 3 500 stations de marée des États-Unis et de leurs territoires : prochaines pleines et basses mers, hauteur d'eau prédite maintenant, marée montante ou descendante et, quand la station les mesure, la hauteur d'eau observée et la température de l'eau. Pas de compte, pas de clé.
Pour les ports de France, utilisez l'intégration Marées France de William-De71 : celle-ci est son pendant pour les États-Unis, avec les mêmes fonctionnalités autant que la NOAA le permet.
Pas pour la navigation. Les prédictions sont astronomiques : le vent, la pression et le débit des fleuves peuvent écarter nettement la hauteur réelle. L'intégration dépend de votre Gladys, de votre accès à Internet et d'un service public. Utilisez les produits officiels de la NOAA et les alertes du National Weather Service pour tout ce qui compte. Intégration non affiliée à la NOAA.
Ce que vous obtenez
- Un appareil par station suivie, nommé « Marée <station> » : la hauteur prédite maintenant, la marée (montante ou descendante), la prochaine marée en phrase (« Pleine mer à 17:39 (1,80 m) »), les minutes avant la prochaine pleine mer et avant la prochaine basse mer, et leurs hauteurs.
- Aux stations qui les mesurent : la hauteur d'eau mesurée (toutes les 6 minutes) et la température de l'eau.
- Hauteurs au-dessus de MLLW (Mean Lower Low Water, le zéro des cartes marines américaines), en mètres ou en pieds ; températures en °C ou °F.
- Deux déclencheurs de scène : une pleine ou basse mer (à son heure ou jusqu'à 6 heures avant), et une pleine mer au-dessus d'un seuil d'alerte (le vôtre, ou le seuil de crue mineure de la NOAA pour la station), jusqu'à 24 heures avant.
- Une action de scène qui donne la prochaine marée aux actions suivantes (heure, hauteur, phrase).
- Un widget de tableau de bord : la courbe de marée du jour avec ses pleines et basses mers, les quatre prochaines marées et les hauteurs en direct.
- Un bouton « Chercher des stations » : les stations près de votre maison, près d'un point, par nom ou par numéro.
Prérequis
- Gladys Assistant 5.1.0 ou plus récent (widget, déclencheurs et action de scène).
- Un accès à Internet de Gladys vers
api.tidesandcurrents.noaa.gov. - La position de votre maison dans Gladys, seulement pour « Chercher des stations » sans texte.
Configuration
Réglages
- Stations : numéros ou noms des stations, séparés par des virgules, 10 au plus. Un numéro
(9414290) est exact. Un nom (« Boston », « San Francisco ») prend la station correspondante, une
station de référence d'abord. Une page de tidesandcurrents.noaa.gov avec
?id=fonctionne aussi. - Unités : mètres et °C (par défaut) ou pieds et °F. Gladys fige l'unité d'une fonctionnalité à la création de l'appareil : après un changement, cliquez sur Mettre à jour sur les appareils dans l'onglet Découverte.
- Seuils d'alerte des pleines mers : pour le déclencheur « Pleine mer au-dessus du seuil »,
dans les unités ci-dessus, au-dessus de MLLW. Un seuil pour toutes les stations (
2,1), un par station (9414290=2,1 ; 8443970=3,6), ou les deux. Vide : le seuil de crue mineure de la NOAA pour la station, quand elle en a un (stations marégraphiques). - Langue des textes : des noms d'appareils et de fonctionnalités (figés à la création) et des textes envoyés aux scènes. Français par défaut.
Enregistrez, ouvrez l'onglet Découverte et créez les appareils voulus.
Trouver vos stations
Le bouton Chercher des stations liste jusqu'à 10 stations avec leur numéro, leur État, leur distance et leur type :
- laissez le champ vide pour les stations les plus proches de votre maison ;
- tapez une latitude et une longitude (
37.8, -122.47) pour les stations les plus proches de ce point ; - tapez un nom, avec son État si besoin (
Sausalito CA), ou un numéro.
Une station de référence a la courbe complète toutes les 6 minutes. Une station secondaire n'a que ses pleines et basses mers (décalages d'une station de référence) : sa hauteur entre deux est calculée par l'interpolation en cosinus des annuaires de marée, à quelques centimètres près.
Appareils
| Fonctionnalité | Type | Remarques |
|---|---|---|
| Hauteur prédite | niveau | maintenant, courbe des stations de référence, sinon calculée |
| Marée | texte | Montante / Descendante |
| Prochaine marée | texte | « Pleine mer à 17:39 (1,80 m) » |
| Prochaine pleine mer dans | durée | minutes |
| Hauteur de la prochaine pleine mer | niveau | |
| Prochaine basse mer dans | durée | minutes |
| Hauteur de la prochaine basse mer | niveau | |
| Hauteur d'eau mesurée | niveau | stations à marégraphe actif, toutes les 6 minutes |
| Température de l'eau | température | stations à capteur de température de l'eau actif |
Les états sont rafraîchis chaque minute par l'intégration elle-même (les comptes à rebours avancent chaque minute). Une mesure de plus d'une heure (trois pour la température) n'est pas renvoyée. Les heures sont données dans le fuseau de votre Gladys, quel que soit celui de la station.
Widget de tableau de bord
Prochaines marées : pour la station choisie dans ses réglages (ou la première créée), la hauteur prédite et les valeurs mesurées en tuiles en direct, la courbe de 2 heures avant à 22 heures après avec ses pleines et basses mers et un repère « maintenant », les quatre prochaines marées, le seuil d'alerte du déclencheur de pleine mer, et un lien vers la page de la station sur Tides & Currents.
Déclencheurs de scène
- Marée : pleine ou basse mer : choisissez la station, pleine mer, basse mer ou les deux, et quand : à l'heure de la marée, ou 15, 30, 45 minutes, 1, 1,5, 2, 3, 4 ou 6 heures avant. La scène reçoit la station, la marée, son heure, sa hauteur, l'unité et une phrase toute prête.
- Marée : pleine mer au-dessus du seuil : une pleine mer prédite atteint le seuil d'alerte de la configuration (ou le seuil de crue mineure de la NOAA) : à son heure, ou de 30 minutes à 24 heures avant. La scène reçoit aussi le seuil.
Un seuil sur la hauteur mesurée n'a pas besoin de déclencheur : utilisez la condition de Gladys « la valeur d'un appareil dépasse » sur la fonctionnalité Hauteur d'eau mesurée.
Action de scène
Marée : obtenir la prochaine marée : pour une station, la prochaine pleine mer, basse mer ou l'une ou l'autre. Les actions suivantes peuvent utiliser son heure, sa hauteur, les minutes qui restent, la hauteur prédite maintenant, la tendance et une phrase (« Pleine mer à 17:39 (1,80 m) »).
Exemples de scènes
- Promenade à marée basse : déclencheur « Marée : pleine ou basse mer », basse mer, 1 heure avant → envoyer la phrase du déclencheur sur votre téléphone, c'est l'heure d'aller à la plage.
- Alerte grande marée : déclencheur « Marée : pleine mer au-dessus du seuil », 12 heures avant → envoyer la phrase à la famille et fermer la porte du garage à temps.
- Point du matin : à 7 h, action « Marée : obtenir la prochaine marée », puis envoyer sa phrase avec la météo.
Sources des données et quotas
- Données : NOAA CO-OPS (Center for Operational Oceanographic Products and Services), API
api.tidesandcurrents.noaa.gov, domaine public. Pas de clé ; chaque requête nomme l'application (application=gladys-noaa-tides), comme le demande la NOAA. - Requêtes, par station : le détail une fois par semaine, les prédictions toutes les 6 heures (2
requêtes), les dernières mesures toutes les 6 minutes pour les appareils créés dont la station
mesure (1 ou 2 requêtes). La liste des stations (environ 3 500) une fois par semaine, gardée dans
/data. - Les prédictions suivent l'époque et les repères publiés par la NOAA ; elles couvrent les deux jours suivants : une courte panne de la NOAA ne change rien.
Dépannage
- « Station inconnue » sur l'écran de configuration : le numéro ou le nom n'est pas dans la liste NOAA des stations de marée. Utilisez Chercher des stations et copiez le numéro.
- Ni hauteur mesurée ni température : la station n'a pas de capteur actif (la plupart n'ont que des prédictions). La NOAA marque un capteur en panne comme inactif : la fonctionnalité revient après « Mettre à jour » dans l'onglet Découverte une fois le capteur réparé.
- Hauteurs en mètres après avoir choisi les pieds : cliquez sur Mettre à jour sur l'appareil dans l'onglet Découverte.
- « NOAA Tides & Currents ne répond pas » : le service est en panne ou injoignable depuis Gladys ; les comptes à rebours et les déclencheurs continuent sur les prédictions déjà connues.
- Journaux détaillés : réglez
LOG_LEVEL=debugsur le conteneur.
Limites
- Stations de marée de la NOAA seulement (États-Unis, Porto Rico, îles du Pacifique…) : ni courants, ni niveaux des Grands Lacs.
- Hauteurs au-dessus de MLLW seulement ; les autres repères ne sont pas proposés.
- Pas pour la navigation : prédictions astronomiques, sans vent ni pression.
- Le seuil de crue mineure de la NOAA n'existe qu'aux stations marégraphiques.
- Intégration non affiliée à la NOAA.
Paramètres de configuration
Voici les paramètres demandés par NOAA Tides dans son écran de configuration dans Gladys.
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
| Vos stations de marée | section | Non | Suivez les prédictions de marée de la NOAA (Tides & Currents) aux stations des États-Unis et de leurs territoires. « Chercher des stations » ci-dessous donne leurs numéros. Enregistrez, puis créez les appareils dans l’onglet Découverte. |
| Stations | string | Non | Numéros ou noms de stations, séparés par des virgules (10 au plus). Un numéro est exact ; un nom prend la station la plus proche du texte. |
| Unités | select | Non | Des hauteurs et des températures. Après un changement, cliquez sur « Mettre à jour » sur les appareils dans l’onglet Découverte. |
| Seuils d’alerte des pleines mers | string | Non | Pour le déclencheur « Pleine mer au-dessus du seuil », au-dessus de MLLW, dans les unités ci-dessus : un seuil (2,1) ou un par station (9414290=2,1 ; 8443970=3,6). Vide : le seuil de crue mineure de la NOAA, si la station en a un. |
| Langue des textes | select | Non | Des noms d’appareils et de fonctionnalités (fixés à la création des appareils) et des textes envoyés aux scènes. |
Comment installer NOAA Tides dans Gladys
- Dans Gladys, ouvrez Intégrations : NOAA Tides apparaît dans le catalogue, aux côtés des intégrations natives, avec un badge communautaire.
- Cliquez sur Installer. Gladys télécharge l'image Docker (
ghcr.io/guim31/gladys-noaa-tides:1.0.0), la démarre dans un bac à sable isolé du cœur, et génère l'interface de l'intégration (appareils, découverte et configuration). - Ouvrez l'écran Configuration de l'intégration, remplissez les paramètres, puis enregistrez.
- Vous pouvez aussi l'installer directement depuis l'URL de son dépôt : https://github.com/guim31/gladys-noaa-tides.
NOAA Tides nécessite Gladys >=5.1.0. Le catalogue dans Gladys se rafraîchit toutes les heures : une nouvelle version est donc disponible au plus tard une heure après sa sortie.
Vous n'utilisez pas encore Gladys ? C'est gratuit et open source : suivez le guide d'installation pour démarrer.
À propos des intégrations externes
NOAA Tides est une intégration externe : une intégration communautaire empaquetée dans un conteneur Docker et publiée sur GitHub, que Gladys installe en un clic et exécute dans un bac à sable isolé de son cœur. Elle est publiée et maintenue par guim31, et non par l'équipe cœur de Gladys.
- Parcourir toutes les intégrations, natives et communautaires
- Créer et publier votre propre intégration externe
- Code source sur GitHub — source de cette documentation