Intégration domotique Atmo France, gratuite et open source
Indice de qualité de l’air ATMO par commune : prévision, épisodes de pollution, pollens.
Publiée par William-De71
- Appareils
- Version 0.1.0
- Nécessite Gladys >=5.2.0
- ★ 0
Présentation
Cette intégration apporte dans Gladys l’indice officiel de qualité de l’air ATMO, pour une à trois communes : l’indice d’aujourd’hui et de demain, les sous-indices des cinq polluants (NO₂, O₃, PM10, PM2,5, SO₂), les épisodes de pollution annoncés pour le département et, si vous le souhaitez, le risque d’allergie aux pollens. Chaque commune devient un appareil à afficher sur un tableau de bord et à utiliser dans les scènes.
Les données viennent d’Atmo Data, le service de données ouvertes de la Fédération Atmo France et des associations régionales de surveillance de la qualité de l’air (AASQA). Elles sont publiées une fois par jour, en début d’après-midi. L’intégration les lit deux fois par jour (vers 7 h 30 et 15 h 30, heure de Paris) et les garde, si bien qu’un redémarrage ne coûte aucune requête.
C’est une intégration cloud : elle contacte admindata.atmo-france.org avec votre compte, et geo.api.gouv.fr (le service ouvert des communes de l’État) pour trouver la commune de votre maison.
Prérequis
- Gladys Assistant 5.2.0 ou plus récent.
- Un compte Atmo Data gratuit. Demandez-le sur https://admindata.atmo-france.org/inscription-api : Atmo France valide la demande par e-mail, en général sous quelques jours, puis vous choisissez votre mot de passe.
- La position de votre maison dans Gladys (Paramètres > Maisons), ou le nom de la commune à suivre. Les communes de métropole, de Corse et d’outre-mer sont couvertes.
Configuration
| Champ | Que saisir |
|---|---|
| Identifiant, Mot de passe | Le compte Atmo Data. |
| Maison | Une maison de Gladys : sa position donne la commune. |
| Ou une commune | « Mâcon », « 71000 », « Saint-Denis 93200 » ou le code INSEE. Renseignée, elle prime sur la maison. |
| Lieu 2, Lieu 3 | D’autres communes (résidence secondaire, travail, école). Facultatif. |
| Pollens | Lire aussi le risque pollens. Le changer ajoute ou retire des fonctionnalités : mettez à jour les appareils. |
| Langue des textes | Noms des appareils, qualité de l’air en texte et résumés des scènes. |
Enregistrez : l’état en haut de la page affiche les communes trouvées, la qualité de l’air du jour et l’heure de la prochaine lecture. Lire maintenant relit tout de suite (au plus toutes les 10 minutes).
Utilisation
Appareils
Dans l’onglet Découverte, créez l’appareil « Qualité de l’air … » de chaque commune. Il contient :
- l’indice ATMO d’aujourd’hui et de demain, de 1 (bon) à 6 (extrêmement mauvais), et la qualité de l’air en texte ;
- le sous-indice de chaque polluant aujourd’hui, de 1 à 6 : un niveau, pas une concentration en µg/m³ ;
- l’épisode de pollution du département aujourd’hui et demain : 0 aucun, 1 information et recommandation, 2 alerte sur persistance, 3 alerte (affiché par Gladys comme risque nul, faible, moyen ou élevé) ;
- avec les pollens : l’indice pollens d’aujourd’hui et de demain, le pollen responsable, et le niveau de l’ambroisie, de l’armoise, de l’aulne, du bouleau, des graminées et de l’olivier aujourd’hui.
Quand Atmo France n’a pas de valeur pour un jour, ou annonce un événement (un incendie), rien n’est publié. Le badge de l’indice reste vert dans Gladys quelle que soit sa valeur (Gladys le colore sur l’échelle américaine, de 0 à 500) : utilisez les widgets pour voir les bonnes couleurs. Les fonctionnalités « demain » gardent la prévision précédente entre minuit et la lecture de l’après-midi.
Widgets du tableau de bord
- Qualité de l’air : les sous-indices du jour, une carte pour aujourd’hui et une pour demain (touchez-la pour le détail), les épisodes, les pollens, la source et l’heure de mise à jour.
- Pollens : le risque aujourd’hui et demain et le niveau de chaque taxon.
Choisissez la commune dans les réglages du widget (vide : la première).
Scènes
Déclencheurs, une fois par changement et jamais deux fois pour le même jour :
- Atmo : qualité de l’air dégradée : l’indice d’aujourd’hui ou de demain passe à « Dégradé » ou pire, ou s’aggrave encore.
- Atmo : épisode de pollution : une procédure d’information ou d’alerte est annoncée, ou passe à un niveau supérieur.
- Atmo : risque pollens : le risque pollens atteint « Modéré » ou plus, ou augmente.
- Atmo : prévision de demain : publiée une fois par jour, l’après-midi.
Chacun fournit une phrase toute prête, {{triggerEvent.data.summary}}, et ses valeurs (niveau, polluants, pollens…). L’action Atmo : lire la qualité de l’air renvoie les mêmes valeurs pour aujourd’hui ou demain, à mettre dans un message ou à tester dans une condition.
Exemples :
- Quand un épisode d’alerte est annoncé pour demain → envoyer le résumé à la famille.
- Quand la prévision de demain est publiée → l’envoyer chaque après-midi.
- Quand les graminées sont élevées → fermer les volets de la chambre.
Transport
Cloud uniquement : les données viennent d’Internet (Atmo Data et geo.api.gouv.fr). Seuls votre compte, les coordonnées de la maison choisie et les communes sortent de votre réseau.
Dépannage
- « a refusé l’identifiant ou le mot de passe » : vérifiez-les, et qu’Atmo France a bien validé votre compte (e-mail de validation). Un mot de passe refusé n’est pas réessayé avant la lecture suivante.
- « Commune introuvable » : la maison n’a pas de position, ou le nom est ambigu : saisissez « nom code postal », ou le code INSEE.
- Pas de valeur pour une commune : certaines régions ne publient que par intercommunalité, que l’intégration lit alors à la place ; une valeur peut manquer quelques heures autour de la mise à jour quotidienne.
- « trop de requêtes » : Atmo Data a demandé d’attendre ; l’intégration attend le temps demandé.
- Pour signaler un problème : appuyez sur Diagnostic, puis copiez les lignes commençant par « Atmo diagnostic » de l’onglet Journaux dans une issue GitHub ou une réponse sur le forum, avec les versions de Gladys et de l’intégration. Elles ne contiennent ni votre identifiant ni votre mot de passe.
Paramètres de configuration
Voici les paramètres demandés par Atmo France dans son écran de configuration dans Gladys.
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
| Compte Atmo Data | section | Non | Les données viennent d’Atmo Data, le service de données ouvertes de la Fédération Atmo France et des associations régionales de surveillance de la qualité de l’air (AASQA) : l’indice ATMO de chaque commune aujourd’hui et demain, les épisodes de pollution du département et le risque d’allergie aux pollens. Le compte est gratuit mais doit être demandé : remplissez le formulaire, attendez l’e-mail de validation d’Atmo France (quelques jours), puis créez votre mot de passe. Les données sont mises à jour une fois par jour, en début d’après-midi ; l’intégration les lit deux fois par jour, une dizaine de requêtes par jour. |
| Identifiant | string | Oui | L’identifiant de votre compte Atmo Data. |
| Mot de passe | secret | Oui | |
| Communes | section | Non | Choisissez une maison de Gladys : sa position donne la commune (Paramètres > Maisons). Ou saisissez la commune : « Mâcon », « 71000 », « Saint-Denis 93200 » ou son code INSEE. Chaque commune devient un appareil dans l’onglet Découverte. Jusqu’à trois lieux. |
| Maison | select | Non | Sa position dans Gladys donne la commune. |
| Ou une commune | string | Non | Nom, code postal, « nom code postal » ou code INSEE. Prioritaire sur la maison. |
| Lieu 2 | section | Non | Une autre commune à suivre (résidence secondaire, travail, école). Facultatif. |
| Maison | select | Non | Sa position dans Gladys donne la commune. |
| Ou une commune | string | Non | Nom, code postal, « nom code postal » ou code INSEE. Prioritaire sur la maison. |
| Lieu 3 | section | Non | Une autre commune à suivre (résidence secondaire, travail, école). Facultatif. |
| Maison | select | Non | Sa position dans Gladys donne la commune. |
| Ou une commune | string | Non | Nom, code postal, « nom code postal » ou code INSEE. Prioritaire sur la maison. |
| Options | section | Non | |
| Pollens | boolean | Non | Lire aussi le risque d’allergie aux pollens (indice et six principaux taxons). Le changer ajoute ou retire des fonctionnalités : mettez à jour les appareils dans l’onglet Découverte. |
| Langue des textes | select | Non | Noms des appareils, qualité de l’air en texte, résumés des scènes. Automatique : la langue de votre tableau de bord, dès qu’un widget Atmo France a été affiché (français avant). |
Comment installer Atmo France dans Gladys
- Dans Gladys, ouvrez Intégrations : Atmo 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-atmo-france:0.1.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-atmo-france.
Atmo France nécessite Gladys >=5.2.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
Atmo 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, natives et communautaires
- Créer et publier votre propre intégration externe
- Code source sur GitHub — source de cette documentation