Intégration Pollens pour Gladys Assistant
Risque pollinique pour les lieux de votre choix, via la prévision européenne CAMS de Copernicus.
Publiée par prohand
- Appareils
- Version 1.0.1
- Nécessite Gladys >=4.62.0
- ★ 0
Cette intégration expose le risque pollinique des lieux de votre choix sous forme d'appareils Gladys : un appareil par lieu, avec un niveau de risque de 0 à 5 pour chaque type de pollen.
Aucun compte à créer, aucune clé d'API à saisir.
D'où viennent les données ?
Les concentrations de pollens proviennent de la prévision européenne de qualité de l'air CAMS (Copernicus Atmosphere Monitoring Service, le service atmosphérique du programme européen Copernicus, opéré par le CEPMMT). C'est le modèle de référence en Europe, sur une grille d'environ 11 km.
Elles sont interrogées via Open-Meteo, qui rediffuse CAMS en open data sans compte ni clé d'API.
Les communes que vous saisissez sont converties en coordonnées par l'API de géocodage Open-Meteo, adossée à la base GeoNames — elle aussi ouverte, sans authentification, et mondiale : il n'y a donc aucun pays à choisir nulle part dans l'intégration.
Et Atmo France ? Atmo France publie bien un indice pollinique pour la France, mais son API demande un compte et un jeton d'authentification que chaque utilisateur devrait créer avant même que l'intégration fonctionne. La source CAMS a été retenue parce qu'elle est officielle et utilisable sans aucune démarche.
Ajouter un lieu
- Ouvrez l'onglet Configuration de l'intégration.
- Cliquez sur Ajouter un lieu.
- Saisissez la commune, par exemple
Montauban. Nommer le lieu est facultatif : le nom de la commune est utilisé si vous laissez le champ vide. - Validez.
La plupart des noms de lieux sont partagés par plusieurs communes — il y a deux
Montauban rien qu'en France, et une dizaine de Paris dans le monde. Dans ce cas
l'intégration vous liste les candidats plutôt que de deviner : relancez l'action
avec une virgule puis la région, le pays ou le code postal, par exemple
Montauban, Tarn-et-Garonne ou Paris, France.
Vous pouvez aussi ajouter un point directement : renseignez la latitude et
la longitude (degrés décimaux WGS-84, les deux — une seule ne fait pas un
point). Les deux séparateurs décimaux sont acceptés, 48,8566 comme 48.8566.
Les coordonnées l'emportent alors sur la commune, qui ne sert plus que de
libellé du lieu.
Le lieu apparaît ensuite dans l'onglet Découverte, sous le nom
Pollens — <nom>. Cliquez dessus pour créer l'appareil dans Gladys : c'est à ce
moment-là qu'il devient utilisable dans les tableaux de bord et les scènes.
Vous pouvez ajouter jusqu'à 20 lieux.
Voir et supprimer vos lieux
Afficher mes lieux les liste, numérotés :
• 1. Maison — Montauban, Tarn-et-Garonne, France (44.01810, 1.35490)
• 2. Bureau — Toulouse, Haute-Garonne, France (43.60426, 1.44367)
Ces numéros sont ceux que propose la liste déroulante de la suppression : une liste déroulante déclarée dans un manifeste ne peut contenir que des options figées, jamais le nom de vos lieux.
Pour en supprimer un : cliquez sur Supprimer un lieu, choisissez son numéro, cochez Je confirme et validez. Lancer l'action sans cocher vous indique quel lieu serait supprimé. Le lieu disparaît immédiatement de l'onglet Découverte, et les lieux suivants remontent d'un rang — réaffichez donc la liste avant d'en supprimer un deuxième.
Si vous aviez déjà ajouté l'appareil dans Gladys, supprimez-le aussi depuis la page des appareils : une intégration n'a pas le droit de supprimer un appareil que vous avez créé. Inversement, si vous supprimez l'appareil sans supprimer le lieu, celui-ci réapparaîtra dans l'onglet Découverte, prêt à être réajouté.
Ce que mesure l'appareil
Chaque appareil expose neuf mesures :
| Mesure | Description |
|---|---|
| Risque pollinique global | Le plus élevé des six risques ci-dessous (0 à 5) |
| Risque pollinique global (texte) | Le même niveau, écrit en toutes lettres |
| Pollen dominant | Le nom du pollen responsable du risque global |
| Risque pollinique — Aulne | Risque de 0 à 5 |
| Risque pollinique — Bouleau | Risque de 0 à 5 |
| Risque pollinique — Graminées | Risque de 0 à 5 |
| Risque pollinique — Armoise | Risque de 0 à 5 |
| Risque pollinique — Olivier | Risque de 0 à 5 |
| Risque pollinique — Ambroisie | Risque de 0 à 5 |
L'échelle de risque est la suivante :
| Niveau | Signification |
|---|---|
| 0 | Nul |
| 1 | Très faible |
| 2 | Faible |
| 3 | Moyen |
| 4 | Élevé |
| 5 | Très élevé |
Le niveau est calculé à partir de la concentration en grains de pollen par mètre cube d'air, avec des seuils propres à chaque espèce : 30 grains/m³, c'est une journée calme pour le bouleau mais une journée chargée pour l'ambroisie, dont le pouvoir allergisant est bien plus fort. Ces seuils suivent les paliers publiés par le Réseau européen d'aérobiologie (EAN) et repris par les produits polliniques CAMS.
Les mesures numériques sont historisées : vous pouvez tracer la saison pollinique de votre commune sur un graphique.
Lorsque le modèle n'a pas de valeur pour une espèce à cet endroit, aucune valeur n'est publiée pour cette espèce — une absence de mesure n'est pas un risque nul.
Sur un tableau de bord, la tuile « appareil dans une pièce » traduit une valeur de risque avec les libellés que Gladys connaît, qui s'arrêtent à 3 : les niveaux 4 et 5 s'y affichent donc « Inconnu ». La mesure texte porte le libellé exact, c'est elle qu'il faut afficher à côté.
La langue des noms
Ces noms sont écrits en français par défaut. Le réglage Langue du nom des
appareils, dans l'onglet Configuration, permet de passer à l'anglais : les
mesures s'appellent alors Overall pollen risk, Birch pollen risk, et le
pollen dominant s'affiche Birch plutôt que Bouleau.
Pourquoi un réglage et non la langue de votre compte ? Tout ce que l'intégration affiche — les messages sous les boutons, l'état dans l'écran Supervision — est envoyé à Gladys dans les deux langues, et Gladys choisit celle de la personne qui lit. Le nom d'un appareil et de ses mesures, lui, n'est pas un message : c'est un texte enregistré tel quel le jour où vous créez l'appareil, et rien dans l'interface des intégrations ne dit dans quelle langue vous lisez. Il faut donc le choisir une fois ici.
Conséquence : changer ce réglage renomme les mesures des appareils restant à créer. Un appareil déjà ajouté à Gladys garde les noms qu'il a reçus à sa création — supprimez-le et rajoutez-le depuis l'onglet Découverte pour le renommer (son historique, lui, est attaché à l'appareil supprimé).
Utiliser le risque dans une scène
Le risque global est une mesure de catégorie « risque » : il s'utilise comme n'importe quel capteur numérique dans une scène. Quelques idées :
- fermer les volets ou couper la VMC quand le risque global dépasse 3 ;
- envoyer une notification le matin si le risque « Graminées » est ≥ 4 ;
- allumer le purificateur d'air quand le pollen dominant est celui auquel vous êtes allergique.
Rafraîchissement
Par défaut chaque lieu est rafraîchi toutes les heures. La prévision CAMS n'est recalculée qu'une fois par jour puis interpolée à l'heure : descendre en dessous d'une heure ne rapporte rien. L'intervalle est réglable entre 15 minutes et 24 heures dans l'onglet Configuration. Un appareil que vous venez de créer est rafraîchi immédiatement, sans attendre le cycle suivant.
Couverture géographique
La prévision CAMS couvre le domaine européen. Un lieu hors de cette zone est refusé au moment de l'ajout plutôt que de créer un appareil qui n'aurait jamais de valeur.
En cas de problème
- Bouton « Tester le fournisseur de pollens » : il interroge la source en direct pour tous vos lieux et affiche une ligne par lieu, numérotée comme la liste. C'est le test le plus rapide pour savoir si le problème vient du réseau ou de la configuration.
- Les journaux : consultez les logs de l'intégration depuis l'interface
Gladys, ou avec
docker logs. PassezLOG_LEVELàdebugpour voir les URL interrogées et le contenu exact envoyé à Gladys. - Rien n'apparaît dans l'onglet Découverte : regardez l'état de l'intégration dans l'écran Supervision — quand Gladys refuse un appareil, la raison y est indiquée.
- Un appareil reste sans valeur : vérifiez que le lieu est toujours listé par « Afficher mes lieux ». Un appareil dont le lieu a été supprimé n'est plus rafraîchi.
Paramètres de configuration
Voici les paramètres demandés par Pollens dans son écran de configuration dans Gladys.
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
| Comment ça marche | section | Non | Ajoutez un lieu avec le bouton ci-dessous : saisissez une commune, elle est géocodée, puis un appareil pollens apparaît dans l'onglet Découverte, prêt à être ajouté à Gladys. Les données polliniques proviennent de la prévision européenne de qualité de l'air CAMS (Copernicus), rediffusée en open data par Open-Meteo, et les lieux sont recherchés via l'API de géocodage Open-Meteo : aucun compte ni clé d'API n'est nécessaire. La couverture est européenne, partout où porte le modèle CAMS. |
| Réglages généraux | section | Non | Ces réglages s'appliquent à tous les lieux configurés. |
| Langue du nom des appareils | select | Non | La langue dans laquelle sont écrits les noms de pollens : « Bouleau » ou « Birch ». Tout le reste de ce que l'intégration affiche suit déjà la langue de votre compte Gladys, mais le nom d'un appareil et de ses fonctionnalités est enregistré tel qu'il est publié : il faut donc le choisir ici. Un appareil déjà ajouté à Gladys conserve les noms avec lesquels il a été créé : supprimez-le et rajoutez-le depuis l'onglet Découverte pour le renommer. |
| Intervalle de rafraîchissement (s) | number | Non | Fréquence de rafraîchissement de chaque lieu, en secondes. La prévision est mise à jour une fois par jour et interpolée à l'heure : descendre sous une heure n'apporte rien. |
| Vos lieux | section | Non | Utilisez les boutons ci-dessous pour ajouter, lister et supprimer vos lieux. Ce ne sont pas des champs de ce formulaire : une liste que l'on construit au fil de l'eau ne peut pas en être un, donc tout se passe sous un bouton et c'est la réponse affichée là qui vous montre la liste. |
Comment installer Pollens dans Gladys
- Dans Gladys, ouvrez Intégrations : Pollens 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/prohand/gladys-pollen: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/prohand/gladys-pollen.
Pollens nécessite Gladys >=4.62.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
Pollens 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 prohand, 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