Aller au contenu principal

Intégration domotique Weather Underground, gratuite et open source

Intégration Weather Underground pour Gladys Assistant

Stations météo personnelles Weather Underground : température, vent, pluie, pression, UV, soleil.

Voir sur GitHubToutes les intégrations

Votre station météo personnelle, telle que publiée sur Weather Underground, dans Gladys : température, humidité, vent, pluie, pression, UV et soleil, relevés toutes les 5 minutes par l'API officielle que The Weather Company donne aux propriétaires de stations. Toute autre station publique peut aussi être suivie, celle d'un voisin par exemple.

Cette intégration n'est ni affiliée à Weather Underground, The Weather Company ou IBM, ni approuvée par eux. Elle a été développée sans le matériel et sans clé d'API : vos retours sont les bienvenus.

Présentation​

  • Un appareil par station, avec ses capteurs comme fonctionnalités : température, température ressentie, point de rosée, humidité, pression, vitesse, rafales et direction du vent, intensité de pluie et pluie du jour, indice UV, luminosité (tirée du rayonnement solaire) et âge de la dernière observation.
  • Un widget de tableau de bord qui montre la dernière observation d'une station et son âge.
  • Une station muette est signalée : ses valeurs ne sont plus rafraîchies, l'âge de son observation continue de grandir et sa pastille passe à l'orange dans la liste des appareils.
  • Lecture seule : rien n'est piloté, rien n'est envoyé à Weather Underground.

Toute station convient, quelle que soit sa marque (Ecowitt, Davis, Ambient Weather, Netatmo par une passerelle, WeeWX…), du moment qu'elle envoie ses données à Weather Underground.

Prérequis​

  • Gladys 5.1 ou plus récent.
  • Une clé d'API Weather Underground. Elle est gratuite, mais réservée aux membres dont la station météo personnelle envoie des données à Weather Underground : connectez-vous sur wunderground.com, ouvrez Member settings, puis API Keys, et générez une clé (32 caractères).
  • L'identifiant de chaque station à suivre : il figure sur la page de la station (par exemple IPARIS123 ou KCASANFR1234). C'est l'ID, pas le nom de la station.
  • Gladys doit accéder à Internet (api.weather.com).

Configuration​

  1. Dans Intégrations, installez Weather Underground puis ouvrez son onglet Configuration.
  2. Collez la clé d'API.
  3. Saisissez les identifiants des stations, séparés par des virgules (10 au plus).
  4. Choisissez l'intervalle de rafraîchissement (5 minutes par défaut) et la langue des noms de fonctionnalités.
  5. Enregistrez, puis cliquez sur Tester la connexion : chaque station répond avec sa température et l'âge de son observation.
  6. Ouvrez l'onglet Découverte et ajoutez les stations.

Les noms des fonctionnalités sont choisis à l'ajout d'une station : changez la langue avant de l'ajouter.

Les appareils station​

Chaque station est un appareil nommé d'après son quartier et son identifiant (« Les Chartreux (IPARIS123) »), avec ces fonctionnalités, en unités métriques :

FonctionnalitéUnitéRemarque
Température°C
Température ressentie°Crefroidissement éolien par temps froid et venteux, indice de chaleur sinon
Point de rosée°C
Humidité%
Pression atmosphériquehPapression ramenée au niveau de la mer
Vitesse du vent, rafaleskm/hseulement pour une station équipée d'un anémomètre
Direction du vent°0 = nord, 90 = est
Intensité de pluiemm/hseulement pour une station équipée d'un pluviomètre
Pluie du jourmm/jdepuis minuit, heure locale
Indice UVseulement pour une station équipée d'un capteur UV
Luminosité (rayonnement solaire)luxW/m² × 126,7, voir les limites
Âge de l'observationminminutes écoulées depuis la dernière observation de la station

Une fonctionnalité pour laquelle la station n'a pas de capteur n'est pas créée. Seules les valeurs qui changent sont envoyées à Gladys, et chaque valeur est renvoyée au moins toutes les 6 heures pour ne jamais paraître périmée.

Quand une station n'envoie plus de données (coupure de courant, Wi-Fi en panne), Weather Underground garde sa dernière observation une heure. Après 30 minutes sans nouvelle observation, l'intégration cesse de rafraîchir les valeurs (une vieille température semblerait actuelle), continue de mettre à jour l'âge de l'observation et signale la station par une pastille orange dans la liste des appareils. Tout revient à l'observation suivante.

Widget de tableau de bord​

Ajoutez le widget Station météo à un tableau de bord et choisissez une station (vide : la première). Il affiche :

  • la température, l'humidité, le vent, la pluie du jour et la pression, en direct ;
  • la courbe de température des dernières 24 heures (une fois la station ajoutée à Gladys) ;
  • l'heure de l'observation et son âge (en orange quand la station est muette), la température ressentie, le point de rosée, les rafales, la direction du vent, l'intensité de pluie, l'indice UV et le rayonnement solaire en W/m².

Le widget n'appelle jamais l'API : il montre la dernière observation relevée.

Déclencheurs et actions de scène​

L'intégration ne déclare ni déclencheur ni action de scène propres : chaque valeur est une fonctionnalité de l'appareil station, que les cartes de scène standard savent déjà traiter (Changement d'état d'un appareil, avec un seuil, et Récupérer la valeur d'un appareil). Un déclencheur « il commence à pleuvoir » ne ferait que répéter « intensité de pluie supérieure à 0 ».

Exemples de scènes​

  • Alerte pluie : quand l'Intensité de pluie de votre station dépasse 0 mm/h, envoyer « Il pleut, rentrez le linge » et fermer le velux.
  • Risque de gel : quand la Température passe sous 1 °C le soir, envoyer un message pour couvrir les plantes.
  • Arrosage inutile : avant la scène d'arrosage du jardin, lire la Pluie du jour et s'arrêter si elle dépasse 5 mm.
  • Station en panne : quand l'Âge de l'observation dépasse 60 minutes, envoyer un message pour vérifier l'alimentation et le Wi-Fi de la station.
  • Store banne : quand les Rafales dépassent 40 km/h, rentrer le store.

Quota de l'API et rafraîchissement​

Une clé Weather Underground permet 1 500 appels par jour et 30 par minute, pour tous les outils qui l'utilisent. Chaque station coûte un appel par rafraîchissement : 288 appels par jour à 5 minutes. Au-delà de 4 stations, l'intégration ralentit d'elle-même le rafraîchissement (5 stations : toutes les 6 minutes ; 10 stations : toutes les 11 minutes) et garde environ 10 % du quota pour les redémarrages et les tests. Si vous utilisez la même clé ailleurs (autre domotique, script), choisissez un intervalle plus long.

Si le quota est malgré tout dépassé, les relevés s'interrompent 15 minutes. Une clé refusée est réessayée toutes les heures, ou dès que la configuration est enregistrée.

Les observations viennent des stations elles-mêmes, toutes les quelques minutes : rafraîchir plus vite que 5 minutes n'apporterait rien de neuf.

Dépannage​

  • « Weather Underground refuse la clé d'API » : recopiez la clé depuis Member settings → API Keys. Weather Underground peut désactiver la clé d'une station qui n'envoie plus rien depuis longtemps.
  • « Aucune observation depuis une heure (station hors ligne ou identifiant inconnu) » : l'API ne distingue pas une station hors ligne d'un identifiant erroné. Vérifiez l'identifiant sur la page de la station (lettres et chiffres, comme IPARIS123) et que la station affiche des données récentes sur wunderground.com.
  • « Identifiant refusé par l'API » : l'identifiant contient quelque chose que l'API rejette : ressaisissez-le.
  • « Quota de l'API dépassé » : voir « Quota de l'API et rafraîchissement » ; les relevés reprennent après 15 minutes.
  • « L'API Weather Underground ne répond pas » : Gladys n'atteint pas api.weather.com : vérifiez sa connexion Internet et son DNS.
  • Une fonctionnalité manque : la station n'envoyait aucune valeur pour ce capteur quand elle a été ajoutée. Si le capteur est arrivé ensuite, lancez une recherche dans l'onglet Découverte et mettez l'appareil à jour.
  • Détails : réglez LOG_LEVEL=debug sur le conteneur pour voir chaque relevé dans les journaux de l'intégration. La clé d'API n'y est jamais écrite.

Limites​

  • Unités métriques uniquement (°C, km/h, hPa, mm).
  • La luminosité est calculée à partir du rayonnement solaire (W/m² × 126,7, le facteur qu'utilisent les stations Ecowitt pour envoyer leur mesure en lux sous forme de W/m²) : exacte pour ces stations, approximation de la lumière du jour pour un pyranomètre (Davis). Le widget affiche aussi la valeur en W/m².
  • Pas de prévisions : les services météo de Gladys (OpenWeather, Météo-France…) les fournissent déjà ; cette intégration apporte ce qu'ils ne peuvent pas, les mesures d'une station toute proche.
  • 10 stations au plus par clé.
  • Les données et leur disponibilité dépendent de The Weather Company, qui peut modifier ou arrêter cette API gratuite à tout moment.
  • Développée sans le matériel et sans clé d'API : les réponses de l'API sont tirées de sa documentation, pas encore d'une vraie station. Vos retours sont les bienvenus sur le dépôt GitHub.

Paramètres de configuration​

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

ParamètreTypeObligatoireDescription
Votre clé d'APIsectionNonWeather Underground donne une clé d'API gratuite à qui lui envoie les données d'une station météo personnelle : connectez-vous sur wunderground.com, puis Member settings, API Keys. La clé lit votre station et toute autre station publique.
Clé d'APIsecretOui32 caractères. 1 500 appels par jour et par clé : l'intervalle est allongé pour rester en dessous.
Identifiants des stationsstringOuiSéparés par des virgules, 10 au plus : la vôtre ou des voisines (l'ID de la page de la station, pas son nom).
Intervalle de rafraîchissementselectNonFréquence de lecture de chaque station. Au-delà de 4 stations, 5 minutes dépasseraient le quota du jour : ralenti automatiquement.
Langue des noms de fonctionnalitésselectNonNoms donnés aux fonctionnalités à l'ajout d'une station (Température, Vitesse du vent…).

Comment installer Weather Underground dans Gladys​

  1. Dans Gladys, ouvrez Intégrations : Weather Underground 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-wunderground: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-wunderground.

Weather Underground 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​

Weather Underground 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 🙂
Dernière mise à jour le