Intégration Météo France pour Gladys Assistant
Prévisions météo et vigilance officielle Météo France pour la France.
Publiée par William-De71
- Appareils
- Version 1.0.1
- Nécessite Gladys >=4.85.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).
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.
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.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). - 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 >=4.85.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