Intégration Qualité de l'air pour Gladys Assistant
Indice de qualité de l'air de n'importe quelle commune du monde, données CAMS Copernicus.
Publiée par prohand
- Appareils
- Version 1.0.1
- Nécessite Gladys >=4.62.0
- ★ 0
Suivez l'indice de qualité de l'air des lieux de votre choix dans Gladys, avec un appareil par lieu. Vous ajoutez un lieu en saisissant simplement le nom de sa commune, n'importe où dans le monde.
Aucun compte à créer, aucune clé d'API à saisir : les deux sources utilisées sont ouvertes et publiques.
Ajouter un lieu
- Ouvrez l'écran Configuration de l'intégration.
- Dans la section « Vos lieux », cliquez sur Ajouter un lieu.
- Saisissez la commune — « Nantes », « Montréal », « Kyoto » — et éventuellement un nom pour ce lieu (« Maison », « Bureau »…). Sans nom, le lieu prend celui de la commune trouvée.
- La réponse s'affiche sous le bouton. Si tout va bien, elle confirme l'ajout et vous indique le numéro du lieu.
- Allez dans l'onglet Découverte : l'appareil « Qualité de l'air — votre lieu » y attend d'être ajouté. Cliquez dessus pour le créer dans Gladys.
Un nom, plusieurs communes
La plupart des noms de communes sont partagés : il y a plusieurs Montauban rien qu'en France, un Paris au Texas et un Springfield par État américain. Quand c'est le cas, l'intégration ne choisit pas à votre place — elle vous répond la liste des lieux trouvés et vous demande de préciser.
Précisez après une virgule : la région, le département, l'État, le pays ou le code postal, dans n'importe quel ordre.
- « Montauban, Tarn-et-Garonne »
- « Springfield, Illinois »
- « Nantes, 44000 »
- « Paris, France »
Les accents et la casse n'ont pas d'importance : « saint-etienne » retrouve « Saint-Étienne ».
Ou directement un point
Si le géocodeur ne connaît pas votre hameau, ou si vous voulez un point précis lu sur une carte, renseignez plutôt la latitude et la longitude (degrés décimaux WGS-84). Les deux vont ensemble : une seule ne fait pas un point. Elles l'emportent alors sur la commune saisie, qui ne sert plus que de libellé.
Voir vos lieux
Le bouton Afficher mes lieux liste tout ce que l'intégration surveille : numéro, nom, lieu (commune, région, pays) et coordonnées. Une entrée par ligne, chacune commençant par « • ».
Ces numéros sont ceux qu'utilise la suppression : lancez cette action avant de supprimer un lieu pour être sûr du numéro.
Supprimer un lieu
- Cliquez sur Supprimer un lieu.
- Choisissez le numéro du lieu dans la liste déroulante.
- Lancez l'action une première fois sans cocher la case : la réponse vous dit quel lieu serait supprimé. Vérifiez que c'est le bon.
- Cochez Je confirme la suppression et relancez.
Le lieu disparaît aussitôt de l'onglet Découverte.
L'appareil Gladys, lui, n'est pas supprimé. Une intégration n'a pas le droit de supprimer un appareil que vous avez créé — elle peut seulement cesser de le proposer. Si vous aviez ajouté l'appareil de ce lieu, la réponse vous le rappelle en le nommant : supprimez-le vous-même depuis l'onglet Appareils de l'intégration, sinon il restera là sans plus jamais se mettre à jour.
Attention aussi à la renumérotation : si vous supprimez le lieu 2 sur quatre, les lieux 3 et 4 deviennent les lieux 2 et 3. Relancez « Afficher mes lieux » avant d'en supprimer un autre.
Ce que mesure l'appareil
Chaque appareil expose :
| Fonctionnalité | Ce qu'elle vaut |
|---|---|
| Indice de qualité de l'air | de 1 à 6 — c'est celle à utiliser dans une scène |
| Qualité de l'air (texte) | Bon, Moyen, Dégradé, Mauvais, Très mauvais, Extrêmement mauvais |
| Polluant dominant | le polluant qui a déterminé l'indice |
| Sous-indice PM2,5 / PM10 / NO₂ / O₃ / SO₂ | de 1 à 6, polluant par polluant |
| PM2,5 et PM10 | la concentration, en µg/m³ |
Les six classes de l'indice :
| Indice | Qualité de l'air |
|---|---|
| 1 | Bon |
| 2 | Moyen |
| 3 | Dégradé |
| 4 | Mauvais |
| 5 | Très mauvais |
| 6 | Extrêmement mauvais |
L'indice global est celui du polluant le plus mauvais — c'est ainsi que l'indice ATMO comme l'indice européen sont définis : un seul polluant dégradé suffit à dégrader l'air.
Seuls PM2,5 et PM10 ont en plus une fonctionnalité de concentration : ce sont les seuls polluants pour lesquels Gladys dispose d'une catégorie dédiée. Le NO₂, l'O₃ et le SO₂ sont portés par leur sous-indice.
Un polluant pour lequel la source n'a aucune valeur ne publie rien du tout. Une mesure absente n'est pas un air pur : écrire 1 fausserait l'historique et pourrait déclencher une scène « l'air est redevenu bon ».
D'où viennent les données
Les concentrations proviennent des données CAMS (Copernicus Atmosphere Monitoring Service, le service atmosphérique de l'Union européenne, opéré par le CEPMMT), rediffusées en open data par Open-Meteo. Deux modèles, et l'intégration choisit selon l'endroit :
| Où est le lieu | Modèle lu | Résolution |
|---|---|---|
| En Europe | CAMS européen | ~11 km |
| Ailleurs | CAMS mondial | ~40 km |
Les deux publient les cinq mêmes polluants réglementés. Un lieu reste toujours sur le même modèle : son historique est donc une seule série, pas deux jeux de données superposés.
Le site Atmo France est la référence pour l'indice ATMO français, mais son API demande un compte et un jeton d'authentification que chaque utilisateur devrait créer avant de pouvoir se servir de l'intégration. Le choix s'est donc porté sur une source officielle ouverte et sans authentification.
L'indice est calculé à partir de ces concentrations avec les seuils de l'indice européen de qualité de l'air (Agence européenne pour l'environnement). Ce sont, seuil pour seuil, ceux de l'indice ATMO français depuis l'arrêté du 10 juillet 2020, entré en vigueur le 1er janvier 2021, qui a aligné l'indice national sur l'indice européen : six classes, les cinq mêmes polluants réglementés, les mêmes bornes.
Une différence à connaître : l'indice ATMO publié est journalier (moyenne du jour pour les particules, maximum horaire pour les gaz), alors que cette intégration lit l'heure en cours, comme le fait l'indice européen. La valeur réagit donc dans l'heure — ce qu'on attend d'une scène domotique — plutôt que de reproduire le bulletin ATMO du jour.
Les communes sont résolues en coordonnées par l' API de géocodage Open-Meteo, adossée à la base GeoNames, qui couvre le monde entier. Ouverte, sans compte ni clé d'API elle non plus.
Réglages
- Langue du nom des appareils — français par défaut. Tout 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é conserve les noms avec lesquels il a été créé ; supprimez-le et rajoutez-le depuis l'onglet Découverte pour le renommer. Ce réglage est aussi la langue dans laquelle le géocodeur répond : « Munich » ou « München » pour la même ville.
- Intervalle de rafraîchissement — 1 heure par défaut (entre 15 minutes et 24 heures). L'analyse CAMS est produite une fois par heure : descendre plus bas n'apporte rien.
Vérifier que tout fonctionne
Le bouton Tester la source de qualité de l'air interroge la source en direct pour tous vos lieux et affiche l'indice de chacun, dans le même format que la liste. C'est le moyen le plus rapide de voir si un lieu pose problème et pourquoi.
L'écran Supervision affiche l'état applicatif de l'intégration : il passe au rouge, avec la raison, si un lieu ne peut plus être lu.
Limites
- L'indice est l'indice européen, appliqué partout. Hors d'Europe, ce n'est donc pas l'indice national local : un lieu aux États-Unis, en Chine ou en Inde est mesuré avec les seuils européens, pas avec l'US AQI, l'indice chinois ou le CAQI indien. Les concentrations, elles, restent les concentrations.
- Hors d'Europe, le modèle est quatre fois plus grossier (~40 km contre ~11 km) : il décrit bien un fond régional, moins bien une rue.
- Vingt lieux au maximum.
- Un lieu n'est pas modifiable : pour changer de commune, supprimez-le et ajoutez-en un autre.
Paramètres de configuration
Voici les paramètres demandés par Qualité de l'air 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, n'importe où dans le monde, puis un appareil qualité de l'air apparaît dans l'onglet Découverte, prêt à être ajouté à Gladys. Les communes sont résolues par l'API de géocodage Open-Meteo (GeoNames), et les concentrations de polluants proviennent des données CAMS de Copernicus, rediffusées en open data par Open-Meteo : aucun compte ni clé d'API n'est nécessaire. En Europe c'est le modèle CAMS européen à ~11 km qui est utilisé, ailleurs le modèle CAMS mondial à ~40 km. L'indice est l'indice européen de qualité de l'air, dont les six classes et les seuils sont ceux de l'indice ATMO français depuis 2021 — il est appliqué partout, ce n'est donc pas l'indice national local d'un pays hors d'Europe. |
| 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 des polluants et des mesures : « Polluant dominant » ou « Dominant pollutant ». 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. L'analyse CAMS est produite une fois par 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 Qualité de l'air dans Gladys
- Dans Gladys, ouvrez Intégrations : Qualité de l'air 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-airquality: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-airquality.
Qualité de l'air 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
Qualité de l'air 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