Intégration domotique Pollens, gratuite et open source
Risque pollinique pour les lieux de votre choix, via la prévision européenne CAMS de Copernicus.
Publiée par prohand
- Appareils
- Version 2.0.3
- Nécessite Gladys >=5.1.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 à 3 — l'échelle de Gladys — pour chaque type de pollen. Vous ajoutez vos maisons Gladys en un clic, ou un lieu en saisissant sa commune.
Aucun compte à créer, aucune clé d'API à saisir.
Le risque s'affiche aussi sur votre tableau de bord (deux widgets) et se pilote depuis vos scènes (deux déclencheurs, deux actions).
Cette version nécessite Gladys 5.1 ou plus récent : les widgets de tableau de bord et les cartes de scène d'une intégration n'existent pas avant.
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 vos maisons Gladys, en un clic
Vous avez déjà dit à Gladys où vous habitez : c'est la carte de Réglages > Maisons. Le bouton « Ajouter mes maisons Gladys » lit ces maisons et crée un lieu pour chacune qui n'est pas déjà surveillée — aucune commune à saisir.
Quatre choses à savoir :
- L'accès est une autorisation. L'endroit où vous vivez est une donnée personnelle : Gladys ne la partage que si vous l'avez accepté sur l'écran d'installation de l'intégration. Si le bouton répond que l'accès est refusé, supprimez puis réinstallez l'intégration en acceptant la demande affichée.
- Une maison sans position sur la carte n'a pas de coordonnées. Elle est nommée dans la réponse, et il suffit de la placer dans Réglages > Maisons puis de relancer l'action.
- Une maison hors du domaine européen CAMS est nommée elle aussi, et laissée de côté : aucune prévision pollinique ne la couvre (voir « Couverture géographique » plus bas).
- Ce n'est pas une synchronisation. Les maisons sont lues au moment du clic. Le lieu obtenu est un lieu ordinaire, que vous renommez et supprimez comme les autres, et une maison déplacée dans Gladys ensuite ne déplace pas son lieu.
Relancer l'action est sans risque : une maison déjà surveillée est signalée, pas ajoutée une deuxième fois.
Cette lecture des maisons s'appuie sur les coordonnées des maisons ouvertes par Gladys 4.85.0 ; l'intégration demande de toute façon Gladys 4.86.0 ou plus récent.
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 seize mesures : un risque global, son texte, le pollen dominant, la date de la donnée, puis pour chacun des six pollens un risque chiffré et le même risque écrit en toutes lettres.
| Mesure | Description |
|---|---|
| Risque pollinique global | Le plus élevé des six risques ci-dessous (0 à 3) |
| Risque pollinique global (texte) | Le risque mesuré, écrit en toutes lettres : « 4/5 (élevé) » |
| Pollen dominant | Le nom du pollen responsable du risque global |
| Dernière mise à jour des données | La date et l'heure auxquelles la prévision affichée correspond |
| Risque pollinique — Aulne | Risque de 0 à 3 |
| Risque pollinique — Aulne (texte) | Le risque mesuré, écrit : « 4/5 (élevé) » |
| Risque pollinique — Bouleau | Risque de 0 à 3 |
| Risque pollinique — Bouleau (texte) | Le risque mesuré, écrit : « 4/5 (élevé) » |
| Risque pollinique — Graminées | Risque de 0 à 3 |
| Risque pollinique — Graminées (texte) | Le risque mesuré, écrit : « 4/5 (élevé) » |
| Risque pollinique — Armoise | Risque de 0 à 3 |
| Risque pollinique — Armoise (texte) | Le risque mesuré, écrit : « 4/5 (élevé) » |
| Risque pollinique — Olivier | Risque de 0 à 3 |
| Risque pollinique — Olivier (texte) | Le risque mesuré, écrit : « 4/5 (élevé) » |
| Risque pollinique — Ambroisie | Risque de 0 à 3 |
| Risque pollinique — Ambroisie (texte) | Le risque mesuré, écrit : « 4/5 (élevé) » |
Les mesures « (texte) » servent aux notifications, aux boîtes texte d'un tableau de bord et aux assistants vocaux : une scène qui lit le risque chiffré reçoit un « 3 », et c'est « 3 » qu'elle met dans son message. Un pollen que le modèle ne mesure pas ne publie rien du tout, ni chiffre ni texte.
Le chiffre et le texte ne sont pas sur la même échelle, et c'est voulu. Le chiffre est sur l'échelle de Gladys, de 0 à 3, la seule que le cœur sache nommer. Le texte, lui, est une chaîne de caractères que personne ne réinterprète en aval : il porte donc la mesure réelle, de 0 à 5, celle des paliers européens que suit la donnée CAMS. Une journée « élevé » et une journée « très élevé » s'affichent toutes les deux « 3 » sur le chiffre, mais « 4/5 (élevé) » et « 5/5 (très élevé) » sur le texte.
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.
Depuis quand ces chiffres datent-ils ?
La mesure Dernière mise à jour des données répond à cette question. Elle
affiche la date et l'heure auxquelles correspond la prévision affichée, au
format 06/08/2026 13:00.
C'est bien la date des données, pas celle de la dernière interrogation : CAMS publie sa prévision une fois par jour et Open-Meteo l'interpole heure par heure, donc un rafraîchissement réussi relit le plus souvent exactement les mêmes chiffres. Ce que l'on veut savoir, c'est l'âge de ces chiffres, pas l'heure à laquelle on est allé les rechercher.
L'heure affichée est celle du lieu : la prévision d'un lieu se lit à l'horloge de la commune qu'elle couvre. Pour un lieu dans votre fuseau horaire, c'est donc simplement votre heure ; pour un lieu dans un autre fuseau, c'est l'heure locale là-bas. C'est aussi pourquoi cette mesure se trouve sur chaque appareil plutôt que sur un appareil unique commun à toute l'intégration : deux lieux n'ont pas forcément la même.
Si la prévision reste bloquée sur une date ancienne, c'est que le rafraîchissement échoue : le bouton Tester le fournisseur de pollens affiche la même date pour chaque lieu, et dit ce qui coince le cas échéant.
L'échelle de risque
C'est l'échelle de Gladys, pas une échelle maison. Gladys sait nommer quatre niveaux de risque, et c'est lui qui écrit le libellé à côté de la mesure dans la boîte « appareil dans une pièce » :
| Niveau | Ce qu'affiche Gladys | Couleur |
|---|---|---|
| 0 | Pas de risque | Vert |
| 1 | Faible | Jaune |
| 2 | Moyen | Orange |
| 3 | Élevé | Rouge |
L'intégration publie exactement ces quatre niveaux en chiffre, et nulle part autre chose. Conséquence : la boîte appareil, les widgets, les déclencheurs de scène et les notifications disent tous la même chose du même chiffre. Les widgets ajoutent l'échelle au mot — « 2/3 (moyen) » — pour qu'on sache où l'on se situe sans avoir à la connaître par cœur.
Les données CAMS, elles, suivent les paliers du Réseau européen d'aérobiologie (EAN), qui en compte six. Ils sont repliés sur les quatre niveaux de Gladys :
| Palier EAN (mesure texte) | Chiffre publié | Nom Gladys |
|---|---|---|
| 0/5 (nul) | 0 | Pas de risque |
| 1/5 (très faible) | 1 | Faible |
| 2/5 (faible) | 1 | Faible |
| 3/5 (moyen) | 2 | Moyen |
| 4/5 (élevé) | 3 | Élevé |
| 5/5 (très élevé) | 3 | Élevé |
Rien d'important ne se perd dans ce repli : les deux paliers bas veulent tous les deux dire « il y en a à peine », et les deux paliers hauts « restez à l'intérieur si vous y réagissez ».
Le palier mesuré reste lisible : les mesures « (texte) » de l'appareil l'affichent tel quel, de 0 à 5 — « nul, très faible, faible, moyen, élevé, très élevé ». C'est le seul endroit où il survit, parce qu'un texte est affiché tel qu'il est stocké là où Gladys relit un chiffre avec ses propres libellés.
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 (niveau 2) mais une journée chargée pour l'ambroisie (niveau 3), dont le pouvoir allergisant est bien plus fort.
Vous veniez d'une version en 0-5 ?
Les premières versions publiaient les six paliers EAN tels quels, de 0 à 5. Ça ne marchait pas : Gladys ne sait nommer que quatre niveaux, donc un niveau 3 s'affichait « Élevé » alors qu'il voulait dire « moyen », et les niveaux 4 et 5 s'affichaient « Inconnu ». L'échelle publiée est maintenant celle de Gladys.
Deux choses à vérifier après la mise à jour :
- L'appareil. Il apparaît dans l'onglet Découverte avec un bouton Mettre à jour : un clic suffit. L'historique, les pièces et les scènes sont conservés.
- Vos scènes. Un déclencheur ou une condition qui visait un niveau 4 ou 5 ne correspond plus à rien : visez le niveau 3 (« élevé ») à la place. Un niveau 3 qui voulait dire « moyen » devient 2.
L'historique déjà enregistré garde ses anciennes valeurs : sur un graphique qui couvre la bascule, les points d'avant sont sur l'échelle 0-5 et ceux d'après sur l'échelle 0-3. Ça se lit encore, mais la comparaison n'est pas juste sur cette période.
Le palier mesuré de 0 à 5 n'a pas disparu pour autant : c'est ce qu'affichent les mesures « (texte) » de l'appareil, à côté du chiffre. Seuls les nombres que lisent les scènes et les graphiques sont sur l'échelle 0-3.
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é).
Sur votre tableau de bord
Deux widgets sont livrés avec l'intégration. Vous les ajoutez depuis un tableau de bord Gladys : Modifier le tableau de bord, Ajouter une boîte, puis choisissez-les dans la liste.
Pollens — un lieu
La carte d'un lieu : le niveau global sur un cadran, la tuile Pollen dominant qui nomme l'espèce à l'origine de ce niveau, le risque écrit en toutes lettres — « 3/3 (élevé) » — puis la liste des pollens réellement présents, la courbe d'aujourd'hui et de demain, et un bouton Rafraîchir. Les espèces à zéro ne prennent pas de ligne : une carte qui ne montre rien veut dire qu'il n'y a rien dans l'air, et elle le dit — sans pollen dans l'air, il n'y a pas de dominant et la tuile disparaît.
Quand la carte est limitée à quelques espèces, le dominant et le risque écrit portent sur ces espèces-là, comme le cadran.
Trois réglages, propres à chaque carte :
| Réglage | À quoi il sert |
|---|---|
| Lieu | L'appareil à afficher. Seuls les appareils déjà ajoutés depuis l'onglet Découverte sont proposés. |
| Pollens suivis | Cochez les espèces auxquelles vous réagissez : le cadran, la liste et la courbe ne tiennent alors compte que de celles-là. Rien de coché = toutes. |
| Afficher la prévision sur deux jours | La courbe heure par heure. Décochez-la pour une carte compacte. |
La courbe montre aujourd'hui et demain, heure par heure, avec un repère à l'heure actuelle. C'est une prévision : Gladys n'en garde aucun historique, elle est relue à chaque affichage. Avec quatre espèces suivies ou moins, chacune a sa courbe ; au-delà, une seule courbe montre la pire des espèces suivies.
Quand vous suivez toutes les espèces, le cadran est branché directement sur la mesure de l'appareil et suit les valeurs publiées en temps réel. Avec une sélection d'espèces, aucune mesure ne correspond — le cadran affiche alors le chiffre calculé par la carte.
Pollens — tous les lieux
Une ligne par lieu configuré, avec son niveau et son pollen dominant, et un bouton Rafraîchir qui relit tout. Aucun réglage : la carte affiche la liste que gère l'onglet Configuration. Elle s'arrête à dix lignes, et le dit.
Ces deux cartes sont écrites dans la langue de la personne qui les regarde : contrairement au nom des appareils, Gladys indique ici dans quelle langue vous lisez.
Utiliser le risque dans une scène
Trois façons, de la plus simple à la plus fine.
1. Les mesures, comme n'importe quel capteur
Le risque global est une mesure de catégorie « risque » : il s'utilise comme n'importe quel capteur numérique. 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.
2. Les déclencheurs
Dans l'éditeur de scènes, catégorie Intégrations :
| Déclencheur | Quand il part |
|---|---|
| Le risque pollinique global a changé | Le niveau global d'un lieu passe d'un niveau à un autre |
| Le risque d'une espèce de pollen a changé | Le niveau d'un pollen précis change sur un lieu |
Les deux ne partent qu'au changement, jamais à chaque rafraîchissement : la prévision CAMS est republiée une fois par jour, donc une scène déclenchée à chaque lecture partirait vingt-quatre fois pour la même valeur.
Chaque déclencheur se filtre : le lieu (vide = n'importe lequel), les niveaux qui vous intéressent (cochez 3 pour ne réagir qu'aux pics), le sens (à la hausse pour fermer les fenêtres, à la baisse pour les rouvrir), et pour le second les espèces.
La scène reçoit ensuite de quoi écrire son message :
{{triggerEvent.data.summary}} contient la phrase toute faite
« Pollens à Maison : risque 3/3 (élevé), dominant Bouleau. », et
location_name, level, level_label, previous_level, direction, taxon,
taxon_name, measured_at sont disponibles séparément.
Deux précisions :
- rien ne part au démarrage du conteneur : le niveau précédent est alors inconnu, et « inconnu → 3 » n'est pas un changement. Le premier vrai changement, lui, part normalement ;
- une espèce sans valeur ne déclenche rien : une absence de mesure n'est pas un retour à zéro, et le dernier niveau connu est conservé.
3. Les actions
Toujours dans l'éditeur de scènes, catégorie Intégrations :
| Action | Ce qu'elle fait |
|---|---|
| Lire le risque pollinique | Lit un lieu maintenant et transmet le niveau, le pollen dominant et la phrase toute faite aux actions suivantes |
| Rafraîchir les données polliniques | Relit la prévision et republie les mesures ; laissez le lieu vide pour tous les lieux |
« Lire le risque pollinique » est ce qui transforme « tous les matins à 7 h » en
« tous les matins à 7 h, dis-moi le risque » : choisissez le lieu, laissez
Risque global (ou choisissez une espèce), puis envoyez un message contenant
la sortie summary. Les sorties level (0 à 3), level_label, taxon,
taxon_name, concentration, location_name et measured_at sont là si vous
préférez composer votre propre phrase.
Si la source ne répond rien, l'action n'échoue pas : elle renvoie
levelvide et unsummaryqui dit « données indisponibles ». C'est à la scène de décider quoi en faire.
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. Chaque ligne se termine par la date des données lues : une source bloquée dans le passé se voit donc ici aussi. 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. « Ajouter mes maisons Gladys » transforme en lieux, en un clic, les maisons que vous avez déjà placées sur la carte dans Gladys. 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:2.0.3), 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 >=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
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