Aller au contenu principal

Intégration domotique SMHI, gratuite et open source

Intégration SMHI pour Gladys Assistant

Météo officielle du SMHI, Suède et pays nordiques : mesures, prévisions, avertissements.

Les prévisions météo officielles de l'Institut météorologique et hydrologique suédois (SMHI) dans Gladys : valeurs actuelles, prévisions heure par heure et jour par jour, et les avertissements météo du SMHI pour la Suède. Données publiques, sans compte ni clé d'API.

Sans lien avec le SMHI. Développée sans test réel contre le SMHI : vos retours sont les bienvenus sur le forum Gladys.

Ce que fait l'intégration​

  • Un appareil par lieu : chaque maison localisée de Gladys, plus, en option, un lieu donné par ses coordonnées (un chalet, un port…).
  • Le temps actuel du lieu, rafraîchi toutes les 30 minutes : température, ressenti, humidité, pression, vent (moyen, rafales, direction), nébulosité, précipitations (intensité et type), visibilité, probabilité d'orage et le temps en toutes lettres.
  • Les avertissements météo du SMHI (jaune, orange, rouge) dont la zone couvre le lieu : un niveau que les scènes de Gladys peuvent comparer, un texte, et un déclencheur de scène.
  • Un widget de tableau de bord avec les prochaines 24 heures et les jours à venir.
  • Une action de scène qui lit une journée de prévision (aujourd'hui, demain, après-demain) pour un message du matin ou une alerte gel.

La prévision couvre la zone du modèle du SMHI : les pays nordiques et la région balte (Suède, Norvège, Finlande, Danemark, pays baltes et les mers alentour). Les avertissements n'existent que pour la Suède et ses eaux.

Prérequis​

  • Gladys Assistant 5.1.0 ou plus récent.
  • Gladys doit joindre opendata-download-metfcst.smhi.se et opendata-download-warnings.smhi.se en HTTPS.
  • Pour les maisons : une position renseignée dans Paramètres → Maisons de Gladys.

Installation​

  1. Dans Gladys, ouvrez Intégrations → Installer depuis GitHub et saisissez https://github.com/guim31/gladys-smhi, ou installez SMHI depuis le store.
  2. Acceptez l'accès à la position des maisons : il sert à demander au SMHI la prévision de chaque maison, rien d'autre.
  3. Ouvrez l'onglet Découverte de l'intégration et ajoutez les appareils des lieux voulus.

Configuration​

ChampDéfautUsage
Prévoir pour les maisonsactivéUn appareil par maison localisée dans Gladys.
Autre lieu : latitudevideDegrés décimaux (59.3293, la virgule marche aussi). Vide : les maisons seules.
Autre lieu : longitudevideDegrés décimaux, positifs vers l'est (18.0686).
Autre lieu : nomSMHINom de l'appareil de ce lieu.
Comté pour les avertissementsAutomatiqueAutomatique : les avertissements dont la zone dessinée contient le lieu.
Intervalle de rafraîchissement30 min15 min, 30 min ou 1 heure. Le SMHI met à jour sa prévision environ chaque heure.
LangueFrançaisNoms des fonctionnalités des nouveaux appareils, textes de temps, résumés.

Choisir un comté garde aussi tous les avertissements qui touchent le comté, même quand leur zone dessinée ne contient pas le lieu : utile en bordure d'une zone, au prix d'avertissements pour l'autre bout du comté.

Les noms des fonctionnalités sont figés à l'ajout de l'appareil : changez d'abord la langue, puis ajoutez les appareils.

L'appareil d'un lieu​

FonctionnalitéUnitéRemarques
Température°CTempérature de l'air à 2 m.
Ressenti°CCalculé (formule de Steadman : température, humidité, vent).
Humidité%Humidité relative.
PressionhPaAu niveau de la mer.
Vitesse du ventm/sVent moyen à 10 m.
Rafalesm/s
Direction du vent°D'où vient le vent (0 nord, 90 est).
Nébulosité%Part du ciel couverte.
Précipitationsmm/hIntensité moyenne de l'heure.
Type de précipitationstextePluie, neige, neige mouillée, bruine… « Pas de précipitations » sinon.
Visibilitékm
Probabilité d'orage%
TempstexteLe symbole météo du SMHI en toutes lettres (Couvert, Pluie faible…).
Niveau d'avertissement0 à 30 aucun, 1 jaune, 2 orange, 3 rouge : le plus haut avertissement du lieu.
AvertissementstexteLes avertissements en cours, le plus grave d'abord, avec la fin du premier.

Toutes les fonctionnalités sont en lecture seule. Les valeurs sont celles de la prévision pour l'heure en cours : le SMHI publie une prévision de modèle, pas les mesures d'une station météo. Gladys convertit température, vitesse et distance dans les unités de chaque utilisateur.

Widget de tableau de bord​

Ajoutez le widget Prévisions SMHI à un tableau de bord et choisissez le lieu (le premier si aucun n'est choisi). Il montre le temps en toutes lettres et l'heure de la dernière lecture, la température, le ressenti et le vent, une courbe des prochaines 24 heures, les avertissements en cours et six jours (temps, températures minimale et maximale, précipitations). Il suit la langue et les unités de l'utilisateur.

Déclencheur de scène : nouvel avertissement météo du SMHI​

Se déclenche quand le SMHI émet un avertissement dont la zone couvre un lieu, ou relève le niveau d'un avertissement en cours (jaune vers orange…). Filtres : le lieu, les niveaux. Variables pour les actions suivantes : le niveau (yellow, orange, red), le phénomène, la zone, la description, le début et la fin. Le SMHI écrit phénomènes et descriptions en suédois et en anglais : l'intégration transmet l'anglais.

Un avertissement n'est annoncé qu'une fois : ni une nouvelle lecture ni un redémarrage de l'intégration ne relancent le déclencheur pour le même avertissement au même niveau.

Action de scène : lire la prévision du SMHI​

Choisissez le lieu et le jour (aujourd'hui, demain, après-demain). L'action renvoie, pour les actions suivantes de la scène : les températures minimale et maximale (°C), les précipitations (mm), la plus forte rafale (m/s), la plus haute probabilité d'orage (%), le temps en toutes lettres, et une phrase de résumé dans la langue de la configuration.

Action de configuration : vérifier la prévision​

Le bouton Vérifier la prévision interroge le SMHI tout de suite pour chaque lieu, ajouté ou non, et affiche la réponse : température, temps et niveau d'avertissement, ou la raison d'un échec (lieu hors de la zone de prévision, SMHI qui ne répond pas).

Exemples de scènes​

  • Message du matin : à 7 h, Lire la prévision du SMHI (aujourd'hui), puis envoyer la sortie résumé à la famille par message.
  • Alerte gel : à 18 h, Lire la prévision du SMHI (demain) ; si la température minimale est sous 0, envoyer « Couvrez les plantes ce soir ».
  • Tempête : déclencheur Nouvel avertissement météo du SMHI avec les niveaux orange et rouge, puis envoyer le phénomène et la description, et replier le store.
  • Orage : quand la probabilité d'orage dépasse 50 %, éteindre les appareils sensibles.

Rafraîchissement et quotas​

L'intégration se rafraîchit d'elle-même, à l'intervalle choisi (30 minutes par défaut), même quand Gladys n'interroge pas l'appareil. Chaque rafraîchissement fait une requête par lieu ajouté et une pour les avertissements (toute la Suède d'un coup). Les lieux dont l'appareil n'est pas ajouté ne sont jamais lus, sauf par le bouton Vérifier la prévision. Le SMHI ne publie pas de quota pour ses données ouvertes et met à jour son modèle environ une fois par heure : un intervalle plus court n'apporte rien. Les données sont publiées par le SMHI sous licence Creative Commons Attribution 4.0.

Dépannage​

  • « Aucun lieu » : aucune maison de Gladys n'est localisée et aucune coordonnée n'est saisie. Localisez une maison (Paramètres → Maisons), ou saisissez une latitude et une longitude.
  • « Coordonnées illisibles » : saisissez des degrés décimaux, comme 59.3293 et 18.0686, pas des degrés et minutes.
  • « Hors de la zone de prévision du SMHI » : le lieu est hors de la zone du modèle du SMHI (pays nordiques et baltes). Une autre intégration est nécessaire là-bas.
  • « Le SMHI ne répond pas » : Gladys ne joint pas le SMHI (réseau, DNS, panne du SMHI). La dernière prévision est gardée tant qu'elle couvre le présent, et un nouvel essai suit au prochain rafraîchissement.
  • Pas d'avertissement alors que le SMHI en affiche un : la zone dessinée de l'avertissement peut ne pas contenir le point exact du lieu. Choisissez votre comté dans Comté pour les avertissements.
  • Plus de détails : réglez LOG_LEVEL=debug sur l'intégration pour voir chaque lecture dans ses journaux.

Limites​

  • Une prévision, pas une mesure : les valeurs viennent du modèle du SMHI pour le point le plus proche de sa grille (environ 2,5 km).
  • Les avertissements ne couvrent que la Suède ; leurs textes sont en anglais.
  • Les noms des fonctionnalités et des appareils sont figés à l'ajout de l'appareil.
  • Ni indice UV, ni pollen, ni risque d'incendie : le SMHI les publie ailleurs.
  • Changer les coordonnées de l'autre lieu crée un nouvel appareil (un nouveau lieu a son propre historique).

Crédits et licence​

Données : © SMHI, Creative Commons Attribution 4.0. La lecture de l'API suit l'intégration Home Assistant smhi et la bibliothèque pysmhi de G Johansson (MIT). Intégration sous licence Apache 2.0. Sans lien avec le SMHI.

Paramètres de configuration​

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

ParamètreTypeObligatoireDescription
Prévisions du SMHIsectionNonPrévisions de l'Institut météorologique suédois (SMHI) pour les pays nordiques et baltes, et ses avertissements météo pour la Suède. Données publiques, sans compte. Un appareil par lieu : chaque maison localisée de Gladys, et les coordonnées saisies ci-dessous. Sans lien avec le SMHI.
Prévoir pour les maisons de GladysbooleanNonUn appareil par maison localisée dans Gladys (Paramètres → Maisons).
Autre lieu : latitudestringNonDegrés décimaux, la virgule est acceptée. Laissez vide pour les seules maisons.
Autre lieu : longitudestringNonDegrés décimaux, positifs vers l'est.
Autre lieu : nomstringNonNom de son appareil, SMHI si vide.
Comté pour les avertissementsselectNonAutomatique : les avertissements dont la zone contient le lieu. Un comté : aussi tous ceux qui le touchent.
Intervalle de rafraîchissementselectNonLe SMHI met à jour sa prévision environ une fois par heure.
Langue des noms et des textesselectNonNoms des fonctionnalités des nouveaux appareils, textes de temps et d'avertissement, résumé de l'action de scène.

Comment installer SMHI dans Gladys​

  1. Dans Gladys, ouvrez Intégrations : SMHI 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/guim31/gladys-smhi:1.0.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/guim31/gladys-smhi.

SMHI 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​

SMHI 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.

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 🙂