Intégration domotique Open-Meteo Marine, gratuite et open source
Météo marine Open-Meteo : vagues, houle, température de l’eau, vent et état de la mer de vos spots.
Publiée par William-De71
- Appareils
- Version 0.1.0
- Nécessite Gladys >=5.3.0
- ★ 0
Présentation
Cette intégration apporte dans Gladys la météo marine d’Open-Meteo sur cinq spots au plus, n’importe où dans le monde : un spot de surf, un port, une zone de navigation, une plage de kitesurf. Pour chaque spot, vous obtenez les vagues (hauteur significative, période, direction), la houle et la mer du vent, la température de l’eau, le courant, le niveau de la mer avec la marée, le vent et ses rafales, ainsi que la force Beaufort et l’état de la mer (Douglas) calculés par l’intégration. Chaque spot devient un appareil à afficher sur un tableau de bord et à utiliser dans les scènes.
Open-Meteo construit ces données à partir des modèles de vagues, d’océan et de météo des services météorologiques nationaux (Météo-France, CEPMMT, DWD, NOAA…). Ni compte ni clé : l’API gratuite est réservée à un usage non commercial, moins de 10 000 appels par jour. Données météo par Open-Meteo.com, sous licence CC BY 4.0. Cette intégration communautaire n’est pas affiliée à Open-Meteo.
Ce sont des prévisions de modèle, pas des observations, et elles sont inadaptées à la sécurité de la navigation. La précision près des côtes est limitée. Avant de sortir, consultez le bulletin météo marine officiel de Météo-France.
C’est une intégration cloud : elle lit chaque spot toutes les 15 ou 30 minutes avec deux requêtes (données marines, puis vent) et garde les prévisions sur 7 jours dans /data, si bien qu’un redémarrage ne coûte aucune requête.
Prérequis
- Gladys Assistant 5.3.0 ou plus récent.
- Un accès à Internet depuis Gladys.
- Les coordonnées de vos spots, en mer.
Configuration
| Champ | Quoi saisir |
|---|---|
| Spot 1 … 5 : nom | Le nom affiché dans l’appareil et les widgets, par exemple « Quiberon ». Facultatif. |
| Spot 1 … 5 : latitude, longitude | Degrés décimaux, 47.45, -3.20 (la virgule décimale marche avec une espace : 47,45 -3,20). Spot 1 requis. |
| Intervalle de lecture | 15 ou 30 minutes (30 par défaut) : les modèles sont mis à jour quelques fois par jour. |
| Unité du vent | Nœuds (par défaut), km/h ou m/s, dans les widgets et les textes des scènes. |
| Langue des textes | Noms d’appareils et résumés des scènes. Automatique : la langue de votre tableau de bord. |
Placez le point en mer, à quelques km de la côte, là où arrivent les vagues : clic droit sur la mer dans Google Maps (ou OpenStreetMap), puis copiez les coordonnées. Open-Meteo prend la maille en mer la plus proche de ses modèles de vagues, larges de 5 à 25 km : un point sur la plage marche donc en général aussi. Un point à l’intérieur des terres n’a pas de données marines : l’intégration le refuse et l’indique en haut de la page.
Enregistrez : l’état en haut de la page affiche chaque spot, son état de la mer actuel et l’heure de la prochaine lecture. Lire maintenant relit tout de suite, y compris un spot refusé car à terre (pas de nouvelle lecture dans les cinq minutes si les données sont fraîches). Diagnostic écrit l’état de l’intégration dans l’onglet Journaux.
Utilisation
Appareils
Dans l’onglet Découverte, créez l’appareil « Météo marine … » de chaque spot. Il contient 15 fonctionnalités :
| Fonctionnalité | Unité | Remarque |
|---|---|---|
| Hauteur, période, direction des vagues | m, s, degrés | hauteur significative ; direction d’où viennent les vagues |
| Hauteur, période, direction de la houle | m, s, degrés | vagues nées au loin |
| Hauteur de la mer du vent | m | vagues levées par le vent local |
| Température de l’eau | °C | en surface ; hors de la température des pièces |
| Vitesse du courant | km/h | pas disponible dans toutes les mers |
| Niveau de la mer | m | au-dessus du niveau moyen mondial, marée comprise |
| Vent moyen, rafales, direction du vent | km/h, degrés | à 10 m ; Gladys n’a pas d’unité en nœuds |
| Force Beaufort | 0 … 12 | d’après le vent moyen (bornes de l’OMM en nœuds) |
| État de la mer (Douglas) | 0 … 9 | d’après la hauteur significative des vagues |
État de la mer (Douglas) : 0 calme, 1 calme (ridée) jusqu’à 0,1 m, 2 belle jusqu’à 0,5 m, 3 peu agitée jusqu’à 1,25 m, 4 agitée jusqu’à 2,5 m, 5 forte jusqu’à 4 m, 6 très forte jusqu’à 6 m, 7 grosse jusqu’à 9 m, 8 très grosse jusqu’à 14 m, 9 énorme.
Les valeurs sont celles de la dernière lecture tant qu’elle a moins d’une heure (données de modèle au pas de 15 minutes), puis la prévision horaire de l’heure en cours. Une valeur qu’Open-Meteo ne donne pas n’est pas publiée. Renommer un spot garde son appareil ; le déplacer vers d’autres eaux (environ 1 km ou plus) crée un nouvel appareil.
Widgets du tableau de bord
- Conditions en mer : tuiles pour les vagues, leur période, la houle (et d’où elle vient), l’eau et le vent ; l’état de la mer, la force Beaufort, les rafales, la houle et le courant ; l’avertissement de navigation.
- Courbe météo marine : les 48 ou 72 prochaines heures des vagues, de la houle et de la mer du vent (en mètres), ou du vent moyen et des rafales ; les plus hautes vagues et le vent le plus fort avec leur heure.
- Mer sur 7 jours : jour par jour, les vagues max, la houle et sa période, le vent max et sa force Beaufort, et l’état de la mer en badge coloré.
Choisissez le spot dans les réglages du widget (vide : le premier). Chaque widget cite sa source, Open-Meteo.com (CC BY 4.0).
Scènes
Trois déclencheurs, un événement par transition. La première lecture d’un spot sert de référence et ne déclenche rien. Une valeur à moins de 5 % d’un seuil garde son niveau : les petits mouvements du modèle ne déclenchent rien.
- Open-Meteo Marine : état de la mer changé : l’état de la mer (Douglas) d’un spot change. Filtrez par spot et par nouvel état (« forte » et au-delà, par exemple).
- Open-Meteo Marine : force Beaufort changée : la force du vent moyen change. Filtrez par spot et par nouvelle force.
- Open-Meteo Marine : vent fort prévu : dans les 24 prochaines heures, la prévision atteint la force 7 (grand frais) ou plus, seuil des avis de grand frais, ou une force plus haute que celle déjà annoncée. Il n’est annoncé de nouveau qu’après que la prévision est repassée sous la force 7.
Chacun donne une phrase toute prête, {{triggerEvent.data.summary}}, et ses valeurs (hauteurs, périodes, vent en km/h et en nœuds…).
L’action Open-Meteo Marine : lire la météo marine renvoie la mer et le vent d’un spot maintenant, ou dans 1 à 168 heures : vagues, houle, mer du vent, eau, vent, rafales, force Beaufort, état de la mer et un résumé. Elle lit la prévision gardée et ne fait aucune requête.
Exemples :
- Quand l’état de la mer devient « forte » ou plus au port → envoyer
{{triggerEvent.data.summary}}au skipper. - Quand un vent fort est prévu → prévenir, et rentrer le salon de jardin.
- Chaque samedi à 7 h → lire la météo marine dans 3 heures ; si la houle dépasse 1 m avec une période de plus de 10 s, envoyer « Ça rentre ! ».
Transport
Cloud uniquement : les données viennent de marine-api.open-meteo.com et api.open-meteo.com. Seules les coordonnées des spots quittent votre réseau, avec un user agent qui nomme l’intégration.
Dépannage
- « pas de données marines à cet endroit » : le point est à terre, ou dans un lac ou un estuaire étroit que les modèles de vagues ne couvrent pas. Déplacez-le de quelques km vers le large, enregistrez, puis appuyez sur Lire maintenant.
- « coordonnées illisibles » : saisissez
latitude, longitudeen degrés décimaux, la latitude d’abord :47.45, -3.20. Les degrés-minutes (47°27'N) ne sont pas lus. - Le courant ou le niveau de la mer reste vide : Open-Meteo n’a pas de valeur pour cette mer. C’est normal.
- Les valeurs diffèrent de la bouée ou du bulletin officiel : ce sont des données de modèle sur une grille de 5 à 25 km ; près des côtes, elles sont moins précises.
- « Open-Meteo limite les requêtes (HTTP 429) » : le quota gratuit est compté par adresse IP. L’intégration attend au moins une heure. Choisissez 30 minutes et vérifiez qu’aucun autre logiciel de votre réseau n’appelle beaucoup Open-Meteo.
- « Open-Meteo est indisponible » ou « injoignable » : l’intégration réessaie après 5, 10, 20 et 40 minutes ; en attendant, les appareils suivent la prévision horaire déjà gardée.
- Pour signaler un problème : appuyez sur Diagnostic, puis copiez les lignes commençant par « Marine diagnostic » de l’onglet Journaux dans une issue GitHub ou une réponse sur le forum. Indiquez les versions de Gladys et de l’intégration.
Paramètres de configuration
Voici les paramètres demandés par Open-Meteo Marine dans son écran de configuration dans Gladys.
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
| Open-Meteo Marine | section | Non | Météo marine d’Open-Meteo pour vos spots : vagues, houle, mer du vent, température de l’eau, courant, niveau de la mer avec la marée, vent, force Beaufort et état de la mer (Douglas), maintenant et sur 7 jours. Ni compte ni clé : l’API gratuite d’Open-Meteo est réservée à un usage non commercial, et l’intégration lit chaque spot toutes les 15 ou 30 minutes. Les coordonnées des spots sont envoyées à Open-Meteo. Données météo par Open-Meteo.com, sous licence CC BY 4.0. Ce sont des prévisions de modèle, inadaptées à la sécurité de la navigation : avant de sortir, consultez le bulletin météo marine officiel (Météo-France). |
| Spots | section | Non | Saisissez jusqu’à cinq spots : un nom et ses coordonnées en « latitude, longitude » en degrés décimaux (47.45, -3.20). Placez le point EN MER, à quelques km de la côte, là où arrivent les vagues : sur terre, Open-Meteo n’a pas de données marines et le spot est refusé. Trouvez les coordonnées d’un clic droit sur la mer dans Google Maps ou sur OpenStreetMap. Chaque spot devient un appareil dans l’onglet Découverte ; renommer un spot garde son appareil, le déplacer vers d’autres eaux en crée un nouveau. |
| Spot 1 : nom | string | Non | |
| Spot 1 : latitude, longitude | string | Oui | En mer, à quelques km de la côte. |
| Spot 2 : nom | string | Non | |
| Spot 2 : latitude, longitude | string | Non | |
| Spot 3 : nom | string | Non | |
| Spot 3 : latitude, longitude | string | Non | |
| Spot 4 : nom | string | Non | |
| Spot 4 : latitude, longitude | string | Non | |
| Spot 5 : nom | string | Non | |
| Spot 5 : latitude, longitude | string | Non | |
| Options | section | Non | |
| Intervalle de lecture | select | Non | Deux requêtes par spot à chaque lecture. Les modèles sont mis à jour quelques fois par jour : 30 minutes suffisent largement. |
| Unité du vent | select | Non | Dans les widgets et les textes des scènes. Les appareils restent en km/h, l’unité de vent de Gladys. |
| Langue des textes | select | Non | Langue des noms d’appareils et des textes des scènes. Automatique : la langue de votre tableau de bord. |
Comment installer Open-Meteo Marine dans Gladys
- Dans Gladys, ouvrez Intégrations : Open-Meteo Marine 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/william-de71/gladys-open-meteo-marine:0.1.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/William-De71/gladys-open-meteo-marine.
Open-Meteo Marine nécessite Gladys >=5.3.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
Open-Meteo Marine 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 William-De71, 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