Intégration domotique Météo France, gratuite et open source
Prévisions météo et vigilance officielle Météo France pour la France.
Publiée par William-De71
- Appareils
- Version 1.4.0
- Nécessite Gladys >=5.1.0
- ★ 0
Cette intégration fournit à Gladys les prévisions météo et la vigilance officielle de Météo France. Elle alimente le widget météo du tableau de bord, l'assistant vocal et les scènes déclenchées par une alerte météo.
Prêt à l'emploi
Aucune configuration n'est nécessaire. Les prévisions et la vigilance passent par le service public de Météo France : installez l'intégration, elle fonctionne immédiatement.
Une clé d'API optionnelle permet d'afficher en plus la carte de vigilance nationale (voir plus bas).
Ce que l'intégration fournit
- Prévisions heure par heure sur les 24 prochaines heures : température, ressenti, humidité, pression, vent (vitesse, rafales, direction), pluie et probabilité de précipitations.
- Prévisions journalières sur 8 jours : températures mini/maxi, conditions, cumul de pluie, indice UV, lever et coucher du soleil.
- Vigilance officielle : les neuf phénomènes de Météo France (vent violent, pluie-inondation, orages, crues, neige-verglas, canicule, grand froid, avalanches, vagues-submersion), avec le nom du département et le bulletin complet.
- Carte de vigilance du jour et du lendemain (nécessite la clé d'API).
Icône d'une journée
L'icône d'une journée résume le phénomène le plus marquant de cette journée, et non le temps qu'il fait à midi.
Météo France publie deux informations différentes : les prévisions heure par heure, et un résumé daté de midi. Ce résumé décrit le ciel à un instant précis, si bien qu'il peut annoncer « Ensoleillé » sur une journée dont les heures portent de la pluie et plusieurs millimètres de cumul. L'intégration se fonde donc sur les heures de la journée, comme le fait le site de Météo France, et retient le phénomène qui la caractérise le mieux : une averse l'emporte sur une éclaircie, un orage sur une averse.
Au-delà du quatrième jour, Météo France ne publie plus le détail horaire : l'icône provient alors du résumé de midi, seule information disponible.
L'icône peut malgré tout différer de celle de l'application Météo France : Gladys dispose d'un jeu d'icônes plus restreint, et plusieurs ciels distincts y partagent la même image.
Scènes déclenchées par la vigilance
Vous pouvez créer une scène qui se déclenche quand une vigilance est émise, par exemple pour recevoir un SMS en cas de vigilance orange.
Dans l'éditeur de scène, ajoutez un déclencheur « Alerte météo émise » ou « Alerte météo terminée », puis choisissez la maison, éventuellement le type de phénomène et le niveau minimum.
Gladys vérifie les alertes toutes les 30 minutes. Cette intégration surveille en plus la vigilance toutes les 15 minutes et prévient Gladys dès qu'elle change : votre scène se déclenche donc en quelques secondes plutôt qu'en attendant la vérification suivante.
Scènes : déclencheurs Météo France
En plus des alertes de vigilance, l'intégration ajoute ses propres déclencheurs dans l'éditeur de scène (Gladys 5.1 ou plus récent), dans la rubrique Météo France :
| Déclencheur | Se déclenche quand… | Filtres |
|---|---|---|
| Pluie imminente | la prévision radar annonce de la pluie dans l'heure, alors qu'elle n'en annonçait pas | maison, intensité (faible / modérée / forte) |
| Fin de la pluie | la pluie en cours s'arrête | maison |
| Gel annoncé | les 24 prochaines heures descendent à 0 °C, à -5 °C, ou au seuil de votre choix (de -20 à 5 °C) | maison, niveau, seuil personnalisé |
| Forte chaleur annoncée | les 24 prochaines heures montent à 30 °C, à 35 °C, ou au seuil de votre choix (de 20 à 45 °C) | maison, niveau, seuil personnalisé |
| Vent fort annoncé | les rafales des 24 prochaines heures atteignent 60, 80, 100 km/h, ou le seuil de votre choix (de 20 à 150 km/h, par pas de 5) | maison, niveau, seuil personnalisé |
| Verglas annoncé | les 24 prochaines heures annoncent de la pluie sur une surface proche ou en dessous de 0 °C | maison, niveau (risque / probable) |
| Neige annoncée | de la neige (ou de la pluie et neige) apparaît dans les 24 prochaines heures | maison |
| Orage annoncé | un orage (ou de la grêle) apparaît dans les 12 prochaines heures | maison |
| UV élevé annoncé | l'indice UV de la journée à venir atteint 6, 8, 11, ou le seuil de votre choix (de 1 à 11) | maison, niveau, seuil personnalisé |
Exemples : fermer les velux et rentrer le store sur Pluie imminente, passer le chauffage en hors-gel sur Gel annoncé, fermer les volets côté sud la veille d'une Forte chaleur annoncée.
Chaque déclencheur met à disposition des actions suivantes un Résumé prêt à envoyer (« Pluie modérée prévue dans 15 min. », « Gel annoncé : -2 °C prévus demain à 06:00. »), ainsi que les valeurs chiffrées (minutes avant la pluie, température, heure du pic…).
Quelques points à connaître :
- Maison : laissez le champ vide pour surveiller toutes vos maisons. Pour n'en viser qu'une, saisissez son nom exactement comme dans Gladys.
- Niveau : chaque niveau se déclenche séparément. Une scène « Gel annoncé » réglée sur 0 °C se déclenche une fois quand le gel apparaît dans la prévision, pas à chaque mise à jour. Elle se réarme quand la prévision remonte nettement (2 °C au-dessus du seuil pour le gel et la chaleur, 15 km/h en dessous pour le vent), pour ne pas se déclencher en boucle sur une prévision qui hésite autour de 0 °C.
- Seuil personnalisé : pour une autre valeur que celles de la liste, choisissez le niveau « Seuil personnalisé » et saisissez la valeur dans le champ du même nom, par exemple -10 °C pour le gel, 25 °C pour la chaleur ou 40 km/h pour le vent. La valeur doit être un nombre entier (un multiple de 5 pour le vent) et s'exprime toujours en °C et en km/h. Avec « Seuil personnalisé », remplissez toujours le champ : laissé vide, la scène se déclencherait à chaque degré franchi. Avec les autres niveaux, laissez-le vide : une valeur saisie empêcherait la scène de se déclencher.
- Pluie dans l'heure : elle vient du radar de Météo France, vérifié toutes les 5 minutes. Elle n'est pas disponible partout (certaines zones de montagne, l'outre-mer) : les deux déclencheurs de pluie restent alors silencieux. Un même déclencheur de pluie ne se répète pas avant 30 minutes, pour ne pas vous prévenir trois fois pour une averse qui hésite.
- Après un redémarrage, la première vérification sert de référence et ne déclenche rien, comme pour les alertes de vigilance de Gladys : un redémarrage en plein épisode de gel ne vous renvoie pas la notification.
- Verglas, neige, orage : chacun se déclenche une fois quand le phénomène apparaît dans la prévision, puis se réarme quand il en disparaît. Une prévision qui hésite d'une mise à jour à l'autre ne vous prévient pas deux fois : un même déclencheur ne se répète pas avant 6 heures. La neige se déclenche sur sa présence et non sur une quantité, l'unité des cumuls de neige de Météo France n'étant pas documentée.
- UV élevé : Météo France ne publie qu'un indice UV par jour. Avant midi, le déclencheur regarde l'indice du jour ; après midi, celui du lendemain. Il se déclenche donc une fois par jour et par niveau, en général vers midi la veille (ou plus tard si la prévision augmente). Le Seuil personnalisé fonctionne comme pour le gel.
- Localisation : ces déclencheurs surveillent la météo en continu. L'intégration a donc besoin de la position de vos maisons, et c'est pourquoi l'écran d'installation demande l'accès à la localisation. Une maison sans position n'est pas surveillée.
Scènes : actions Météo France
Sept actions permettent de lire la météo au milieu d'une scène. Leurs résultats sont utilisables dans les actions suivantes, par exemple dans un message ou une condition :
| Action | Ce qu'elle renvoie |
|---|---|
| Obtenir les prévisions d'un jour | températures mini/maxi, ciel, pluie et probabilité, vent et rafales, UV, humidité, lever et coucher du soleil |
| Obtenir la pluie des prochaines heures | temps sec ou non, cumul de pluie, nombre d'heures de pluie, heure de la première pluie (sur 1 à 24 h) |
| Obtenir la pluie dans l'heure | pluie en cours, pluie prévue, intensité, minutes avant la pluie ou avant la fin de la pluie |
| Obtenir la vigilance | couleur et niveau, phénomènes en cours, département, résumé officiel et bulletin complet |
| Obtenir le risque de givre | niveau (0 aucun, 1 risque, 2 probable), heure la plus critique, température, points de rosée et de givre, humidité, nuages, vent |
| Obtenir le risque de verglas | niveau (0 aucun, 1 risque, 2 probable), heure de début, température, pluie verglaçante, pluie des 6 dernières heures, probabilité de gel |
| Obtenir la météo d'une heure | à une heure d'aujourd'hui, demain ou après-demain : température, ressenti, ciel, pluie et probabilité, vent, rafales et direction, nuages |
Chaque action renvoie aussi un Résumé en une phrase, par exemple « Demain : pluie, 14 à 21 °C, 4,2 mm de pluie (80 %), rafales à 55 km/h. »
Exemples :
- Bulletin du matin : un déclencheur horaire à 7 h, puis Obtenir les prévisions d'un jour (aujourd'hui) et Obtenir la vigilance, puis un message qui reprend les deux résumés.
- Arrosage malin : avant d'ouvrir la vanne, Obtenir la pluie des prochaines heures sur 12 h, puis une condition sur Temps sec.
- Linge dehors ? : Obtenir la pluie dans l'heure, puis une condition sur Pluie dans l'heure.
- Alerte verglas : même scène que l'alerte givre, avec Obtenir le risque de verglas.
- Trajet du matin : à 21 h, Obtenir la météo d'une heure (demain, 8 h), puis un message avec le Résumé (« Demain à 08:00 : éclaircies, 11 °C (ressenti 8 °C), vent de sud-ouest à 14 km/h, rafales à 40 km/h, 1,2 mm de pluie. »).
- Alerte givre : un déclencheur horaire à 18 h, puis Obtenir le risque de givre, puis « Continuer seulement si » Niveau ≥ 1, puis un message avec le Résumé (« Givre probable demain matin : 0,4 °C vers 06:00, point de givre -2,1 °C. »).
Risque de givre : Météo France ne publie pas de point de rosée. L'action le calcule heure par heure à partir de la température et de l'humidité, puis en déduit le point de givre. Elle regarde de maintenant jusqu'à 10 h de la prochaine matinée (ce matin avant 10 h, demain matin après) et retient l'heure la plus critique. Givre probable : température ≤ 1 °C et point de givre ≤ 0 °C, ou température ≤ 0 °C et point de givre ≤ -2 °C. Risque de givre : température ≤ 3 °C et point de givre ≤ 0 °C. Le givre se forme par ciel dégagé et vent faible : un ciel couvert (80 % de nuages ou plus) ou un vent moyen de 20 km/h ou plus abaisse le niveau d'un cran, ce qu'indique la sortie Atténué par le ciel ou le vent.
Risque de verglas : Météo France ne prévoit ni verglas ni température du sol, et sa « probabilité de gel » n'est que la probabilité d'une température négative (elle est renvoyée à titre indicatif). L'action cherche donc de l'eau sur une surface froide, heure par heure, sur la même fenêtre que le givre. Verglas probable : pluie verglaçante annoncée, pluie avec une température ≤ 0 °C, ou sol mouillé (pluie dans les 6 heures précédentes) avec une température ≤ -1 °C. Risque de verglas : sol mouillé et température ≤ 1 °C. La température de l'air remplace celle du sol, d'où la marge de 1 °C.
Météo d'une heure : jusqu'à demain, Météo France prévoit heure par heure ; au-delà, par pas de 3 heures. L'action prend alors le pas qui couvre l'heure demandée, et la sortie Heure de la prévision indique lequel.
Le champ Maison est facultatif : vide, l'action utilise la première maison localisée. Les températures, le vent et la pluie suivent le système d'unités de Gladys, et les textes sa langue (français ou anglais). La sortie Disponible de Obtenir la pluie dans l'heure indique si la prévision radar couvre votre maison.
Carte de vigilance (optionnel)
L'affichage de la carte nationale nécessite une clé d'API personnelle, gratuite :
- Créez un compte sur le portail API de Météo France.
- Souscrivez à l'API « Données Publiques de Vigilance » (gratuite). Elle apparaît aussi sous le nom « Bulletin Vigilance », et
DPVigilancedans les adresses techniques : c'est la même API. - Sur l'écran de configuration de l'API, choisissez le type de token API Key (et non OAuth2), saisissez une durée de validité longue, puis générez la clé — voir les deux points ci-dessous, c'est là que ça se joue.
- Dans Gladys, ouvrez l'écran Configuration de l'intégration Météo France, collez la clé et enregistrez.
Clé d'API, et non jeton OAuth2
Sur l'écran « Configurer l'API Bulletin Vigilance », le portail demande un type de token. Son guide de démarrage rapide met en avant celui qui ne convient pas ici :
| Utilisable ici | Durée de validité | |
|---|---|---|
| API Key | ✅ oui | celle que vous saisissez |
| OAuth2 (jeton du bouton Generate Token) | ❌ non | environ 1 heure, non renouvelable ici |
Cochez donc API Key. Un jeton OAuth2 semble fonctionner au début, puis cesse de marcher au bout d'une heure environ : la carte disparaît sans message d'erreur particulier. Si votre carte s'affichait et ne s'affiche plus, c'est presque toujours la cause.
Durée de validité de la clé
Une fois API Key coché, le portail affiche un champ « Durée » obligatoire, vide par défaut, à renseigner en secondes. C'est la durée au bout de laquelle la clé cessera de fonctionner — et donc la carte de vigilance avec elle.
Comme l'intégration utilise cette clé en permanence, saisissez la durée la plus longue possible, sans quoi vous devrez la régénérer et la recoller régulièrement.
Saisissez
94672800(environ 3 ans). C'est la valeur maximale acceptée par le portail : au-delà, il refuse la saisie.
Pour information, si vous préférez une durée plus courte :
| Durée | Valeur à saisir |
|---|---|
| 1 mois | 2592000 |
| 6 mois | 15552000 |
| 1 an | 31536000 |
| ~3 ans | 94672800 — maximum |
Notez la date d'expiration quelque part : le jour venu, la carte s'arrêtera sans prévenir, exactement comme avec un jeton OAuth2. Il suffira alors de générer une nouvelle clé et de la recoller dans Gladys.
Sans cette clé, tout le reste continue de fonctionner normalement : seule la carte n'est pas disponible.
Durée du cache
Le tableau de bord et l'assistant conversationnel demandent tous les deux la météo, et chaque demande représente deux appels à Météo France. L'intégration réutilise donc une réponse récente pendant la durée du cache, réglable dans l'écran Configuration (600 secondes par défaut, entre 0 et 3600).
Vous n'avez normalement pas à y toucher : les 600 secondes par défaut conviennent à la grande majorité des installations.
Quelle valeur choisir
Le réglage s'exprime en secondes, entre 0 et 3600 (1 heure).
| Valeur | Effet |
|---|---|
| 0 | aucun cache, chaque demande appelle Météo France |
| 300 (5 min) | données plus fraîches, davantage d'appels |
| 600 (10 min) — défaut | bon équilibre, recommandé |
| 1800 (30 min) | moins d'appels, tableau de bord très réactif |
| 3600 (1 h) | maximum, prévisions pouvant dater d'une heure |
Augmenter la valeur n'a rien de risqué : Météo France ne met ses prévisions à jour que quelques fois par heure, donc un cache de 10 à 30 minutes ne vous fait pratiquement rien perdre en fraîcheur, tout en accélérant l'affichage.
Deux points à connaître :
- une vigilance qui change est détectée indépendamment du cache : l'intégration vide le cache et demande à Gladys de recharger immédiatement, donc vos scènes d'alerte se déclenchent sans attendre l'expiration du cache, même avec un cache réglé à 1 heure ;
- la valeur 0 désactive le cache et appelle Météo France à chaque demande. L'API de prévisions pouvant mettre jusqu'à 20 secondes à froid, l'affichage du tableau de bord peut alors être nettement plus lent. Réservez-la au diagnostic ponctuel plutôt qu'à un usage permanent.
Zone couverte
Météo France couvre la France métropolitaine et les départements d'outre-mer. Pour une maison située en dehors de cette zone, l'intégration ne renvoie pas de données et Gladys bascule automatiquement sur un autre service météo si vous en avez configuré un.
Priorité sur OpenWeather
Si vous aviez déjà configuré OpenWeather, l'installation de Météo France prend automatiquement le relais, sans réglage. Si vous arrêtez ou désinstallez l'intégration, Gladys revient tout aussi automatiquement à OpenWeather.
Paramètres de configuration
Voici les paramètres demandés par Météo France dans son écran de configuration dans Gladys.
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
| Prêt à l'emploi | section | Non | Les prévisions et la vigilance fonctionnent sans aucune configuration. La clé d'API optionnelle ci-dessous sert uniquement à afficher la carte de vigilance nationale. |
| Clé d'API Météo France (optionnelle) | secret | Non | Nécessaire uniquement pour afficher la carte de vigilance nationale. Créez un compte gratuit sur le portail API Météo France et souscrivez à l'API « Données Publiques de Vigilance ». Choisissez le type de token « API Key », PAS OAuth2 (qui expire au bout d'une heure environ), et renseignez le champ obligatoire « Durée » avec 94672800 secondes — environ 3 ans, le maximum accepté par le portail. La carte cesse de s'afficher une fois cette durée écoulée. |
| Durée du cache (s) | number | Non | En secondes, entre 0 et 3600. Durée pendant laquelle une réponse est réutilisée avant de rappeler Météo France. L'API de prévisions peut mettre jusqu'à 20 secondes à froid : réutiliser une réponse récente garde le tableau de bord réactif. La valeur par défaut de 600 (10 min) convient à la plupart des installations ; monter à 1800 ne fait presque rien perdre en fraîcheur, Météo France ne mettant à jour que quelques fois par heure. Mettre 0 pour toujours appeler l'API (tableau de bord plus lent). Une vigilance qui change rafraîchit toujours immédiatement, quelle que soit cette valeur. |
Comment installer Météo France dans Gladys
- Dans Gladys, ouvrez Intégrations : Météo France 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-meteo-france:1.4.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-meteo-france.
Météo France 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
Météo France 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 externes
- Découvrir les intégrations natives intégrées à Gladys
- Créer et publier votre propre intégration externe
- Code source sur GitHub — source de cette documentation