Aller au contenu principal

Intégration domotique Marées Canada, gratuite et open source

Intégration Marées Canada pour Gladys Assistant

Connecteur non officiel : marées du Canada, pleines et basses mers, niveaux observés.

Voir sur GitHubToutes les intégrations

Pas pour la navigation. Les prédictions de marée viennent du Service hydrographique du Canada (SHC) ; pour une sortie en bateau, la pêche ou toute activité sur l'eau, suivez les tables des marées, les cartes et les avis officiels du SHC (marees.gc.ca).

Connecteur non officiel, sans lien avec Pêches et Océans Canada et non approuvé par le Service hydrographique du Canada. Il amène dans Gladys les stations de marée et de niveau d'eau du SHC : Halifax, Saint John, Rimouski, Québec, le Saint-Laurent, Victoria, Vancouver, Tofino, les Grands Lacs, l'Arctique et environ 1 000 autres stations.

État : essayé contre le vrai service dans un Gladys de test, mais il n'a jamais été lancé par une installation Gladys en service. Le 2026-10-29, le module a tourné contre la vraie API IWLS (lectures seules) dans un Gladys de test local (appareils découverts, statut, bouton de test), et ses tests rejouent des réponses de même forme (synthétiques : aucune donnée du SHC dans ce dépôt). Les scènes et le tableau de bord n'ont pas été essayés. Merci de signaler ce que vous voyez.

Source : Service hydrographique du Canada, API IWLS (Integrated Water Level System, système intégré des niveaux d'eau). Données publiques, sans compte, sans clé.

Ce que vous obtenez​

Un appareil par station, avec ce que la station a : jusqu'à 10 fonctions pour une station qui a prédictions, pleines et basses mers et marégraphe (wlp, wlp-hilo, wlo) ; moins sinon (un limnimètre de lac sans prédiction en a 3 ; une station sans prédiction des pleines et basses mers n'a ni « prochaine marée » ni événement de marée) :

FonctionUnitéRemarques
Niveau d'eau préditmLe niveau prédit officiel, un point toutes les 15 minutes (le dernier en vigueur), pour un historique léger. Gladys garde la dernière valeur si le service ne donne plus la courbe (le statut le dit).
Hauteur de la prochaine pleine mermD'après les prédictions officielles des pleines et basses mers.
Prochaine pleine mertexteSon heure dans le fuseau de la station, avec l'abréviation (« 2026-10-29 23:25 ADT »), quel que soit le fuseau de votre Gladys.
Minutes avant la pleine merminutesMis à jour chaque minute ; 0 à l'heure de la marée.
Basse mer : hauteur, heure, minutesm, texte, minutesPareil pour la basse mer.
Niveau d'eau observémSeulement les stations qui mesurent (un marégraphe en service). La dernière mesure, publiée tant qu'elle a moins de 2 heures et n'est pas jugée douteuse.
Heure de l'observationtexteL'heure de cette mesure, heure de la station.
Écart observé - préditmL'écart entre la mesure et la prédiction au même instant (une onde de tempête, une rivière en crue…).

Les hauteurs sont en mètres au-dessus du zéro des cartes de la station (la référence des cartes marines et des tables des marées, proche des plus basses mers), telles que le SHC les donne : aucune conversion. Une valeur que le service ne donne pas n'est pas publiée (jamais un 0). Une fois l'appareil créé, une fonction ne disparaît plus de lui.

Configuration​

  1. Installez l'intégration depuis le store, puis ouvrez sa configuration.
  2. Stations : codes de stations du SHC (5 chiffres), séparés par des virgules, par exemple 00490, 02985 (Halifax, Rimouski). 490 est lu 00490. 20 stations au maximum.
  3. Pour trouver un code, tapez un lieu dans le bouton Chercher des stations (par exemple Rimouski, Saint-Joseph, Tofino), ou utilisez la carte des stations du SHC.
  4. Observations lues toutes les : 10 minutes par défaut, de 5 à 60. Seules les stations qui mesurent sont lues aussi souvent ; les prédictions sont lues toutes les 6 heures (48 heures de courbe, 72 heures de pleines et basses mers), et la station elle-même (nom, fuseau, avis) une fois par semaine.
  5. Cliquez sur Tester les stations, puis ajoutez les appareils depuis l'onglet Découverte.

Scènes​

Un déclencheur, Pleine ou basse mer (Marées Canada) : une pleine ou basse mer prédite d'une station arrive dans le délai choisi : 3 heures, 2 heures, 1 heure, 30 ou 15 minutes avant, ou à l'heure de la marée. Choisissez la station, la marée (pleine ou basse) et quand. Il donne la station, la hauteur prédite, l'heure de la marée (heure de la station), les minutes restantes et un résumé en anglais et en français.

  • Il suit les prédictions, pas les observations : une tempête peut amener l'eau plus tôt ou plus haut. Pas pour la navigation.
  • Un événement par marée et par « quand », retenu dans /data : pas envoyé deux fois, même après un redémarrage.
  • Un événement part avec au plus 10 minutes de retard (conteneur arrêté, Gladys qui redémarre) ; au-delà, il est abandonné, une alerte en retard étant une fausse alerte.
  • Pour un niveau (le niveau observé au-dessus de 4 m, par exemple), utilisez le déclencheur d'appareil habituel sur la fonction.

Limites et comportement​

  • Un marégraphe muet. Certaines stations cessent de mesurer pendant des heures (Halifax le soir du 2026-10-29) : le niveau observé n'est alors pas publié, le statut nomme la station, et les prédictions continuent. Gladys garde la dernière valeur observée reçue : regardez « Heure de l'observation ».
  • Une requête à la fois, espacées d'au moins 6 secondes : 10 par minute, le tiers des 30 que l'API permet par adresse (plusieurs installations peuvent partager une adresse). Un premier démarrage avec 20 stations prend environ 10 minutes.
  • L'API ne donne ni ETag ni Last-Modified : chaque lecture ne demande que ce qui est nouveau (les observations depuis la dernière).
  • Si le service répond « trop de requêtes » (429), l'intégration se met en pause le temps demandé (d'une minute à six heures), même à travers un redémarrage. Un échec ne la fait jamais lire plus tôt, reconnexions comprises, et redémarrages aussi tant que /data est inscriptible (l'instant de chaque lecture y est écrit avant la requête ; sans lui, un conteneur redémarré attend quand même 6 secondes avant sa première requête). Une lecture en échec est retentée après 2 minutes, puis 4, 8… (30 minutes au plus pour les prédictions, une heure pour la station) ; un 429 n'ajoute pas cette attente à sa pause ; le bouton de test redemande une minute après le dernier essai ; un identifiant de station que le service ne connaît plus est recherché à nouveau, une fois par jour au plus.
  • Une partie qui échoue sur une autre erreur qu'un 429 (les métadonnées, les pleines et basses mers) n'arrête pas les autres : sans les métadonnées, les heures sont affichées en UTC, ce que dit le bouton de test.
  • Si Gladys ne donne pas la configuration, l'intégration le dit dans son statut et la redemande après 1 minute, puis 2, 4… jusqu'à 30, sans fin.
  • Si l'horloge du conteneur s'écarte de plus de 5 minutes de celle du service, le statut le dit : les comptes à rebours et les événements de marée suivent l'horloge du conteneur.
  • Rien n'est envoyé que les codes et identifiants des stations. L'intégration n'écrit que son fichier d'état dans /data, de façon asynchrone (un /data figé ne la fige jamais) ; un fichier d'état illisible est laissé tel quel et relu au démarrage suivant ; un fichier qui n'est pas du JSON valide est mis de côté sous marees-canada-state.json.bad, et l'intégration repart de zéro (dit dans le statut).
  • Une marée prédite ni plus haute ni plus basse que ses voisines, que la courbe ne départage pas non plus, est écartée (aucun événement pour elle), ce que dit le statut.

Crédits et licence des données​

Données : Service hydrographique du Canada, Pêches et Océans Canada, API IWLS. Utiliser cette intégration vaut acceptation de l'accord de licence du SHC : chaque installation lit l'API elle-même, comme « l'Utilisateur » de cette licence. En bref : pas pour la navigation, pas de produit dérivé commercial, le droit d'auteur des données reste à la Couronne. Si le SHC met fin à la licence (avis public sur son site), les utilisateurs doivent détruire leurs copies des données sous 15 jours : désinstallez l'intégration, ou supprimez son fichier d'état dans /data (il garde les prédictions et les dernières observations). L'avis que demande la licence (texte anglais de l'accord) :

This product is not to be used for navigation. This product was made by or for the User [the gladys-marees-canada project] and contains intellectual property (Data) of the Canadian Hydrographic Service of the Department of Fisheries and Oceans. The copyrights in the Data are and remain the property of His Majesty the King in Right of Canada and shall not be sold, licensed, leased, assigned or given to a third party. The incorporation of the Data in this product does not constitute an endorsement or an approval of this product by the Canadian Hydrographic Service, the Department of Fisheries and Oceans or His Majesty the King in Right of Canada.

Code : Apache-2.0, écrit d'après la description OpenAPI publiée de l'API IWLS. Voir THIRD_PARTY_NOTICES.md.

Paramètres de configuration​

Voici les paramètres demandés par Marées Canada dans son écran de configuration dans Gladys.

ParamètreTypeObligatoireDescription
Les marées du Canada dans GladyssectionNonPas pour la navigation : suivez les tables des marées et les avis officiels du Service hydrographique du Canada. Connecteur non officiel, sans lien avec Pêches et Océans Canada et non approuvé par le Service hydrographique du Canada (SHC). Pour chaque station choisie (Halifax, Rimouski, Victoria, le Saint-Laurent, les Grands Lacs…), il amène dans Gladys le niveau d'eau prédit, les prochaines pleine et basse mers (hauteur, heure, minutes restantes) et, là où la station mesure, le niveau observé et son écart à la prédiction. Des scènes peuvent se lancer avant une pleine ou une basse mer. Données publiques du SHC (API IWLS), sans compte ; l'utiliser vaut acceptation de l'accord de licence du SHC (lien ci-dessous). Essayé contre le vrai service dans un Gladys de test, jamais lancé par une installation Gladys en service pour l'instant.
StationsstringNonCodes de stations du Service hydrographique du Canada (5 chiffres), séparés par des virgules (20 au maximum). Le bouton « Chercher des stations » les donne.
Observations lues toutes les (minutes)numberNonPour les stations qui mesurent le niveau d'eau. Les prédictions sont lues toutes les 6 heures quelle que soit cette valeur.

Comment installer Marées Canada dans Gladys​

  1. Dans Gladys, ouvrez Intégrations : Marées Canada apparaît dans le catalogue, aux côtés des intégrations natives, avec un badge communautaire.
  2. Cliquez sur Installer. Gladys télécharge l'image Docker (ghcr.io/lm1lc3n7/gladys-marees-canada:0.1.1), 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).
  3. Ouvrez l'écran Configuration de l'intégration, remplissez les paramètres, puis enregistrez.
  4. Vous pouvez aussi l'installer directement depuis l'URL de son dépôt : https://github.com/LM1LC3N7/gladys-marees-canada.

Marées Canada 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​

Marées Canada 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 LM1LC3N7, et non par l'équipe cœur de Gladys.

Inscrivez-vous à la newsletter Gladys Assistant

Quelques emails par mois sur les nouveautés et l'actualité du projet. Envoyés par Pierre-Gilles Leymarie, le fondateur du projet. Désinscription possible à tout moment 🙂
Dernière mise à jour le