Plugin Jeedom AirQuality

Le plugin Air Quality vous informe sur la qualité de l’air presque partout dans le monde.

Il s’adresse essentiellement aux personnes allergiques, asthmatiques, sensibles et sportifs, mais aussi à tous ceux qui prennent attention à l’air qu’il respire.

Prévisions & live

Grâce aux informations des prévisons et données live, vous pouvez manager votre planning et vous prémunir des polluants. Vous accèdez aux informations en direct mais aussi aux prévisions sur 5 jours.

Les polluants sont affichés par niveau décroissant pour simplifier la lisibilité.

Alertes

Les alertes s’affichent sur le widget, mais sont aussi préformatées et dispo dans une commande info, vous pouvez facilement les remonter dans vos SMS, Discord(Markdown) et Télégram(HTML) par exemple. Une explication détaillé se trouve plus bas.

Des messages d’alertes sont crées en fonctions des changements des données les déclenchements sont paramétrables individuelements.

Regardez le bouton ‘Alertes’ sur la page de configuration de votre équipement, c’est là que vous pouvez tout régler.

Mobilité

Une option est disponible, le ‘FollowMe’, cela fonctionne avec la wep app mobile de Jeedom, un bouton vous géolocalise et permet de mettre à jour les données en fonction (fonctionne en https uniquement).

Cela vous permet d’avoir les infos locales partout où vous vous trouver (dans les limites des possibilités des API).

Avec cette option, le bouton refresh du desktop de l’équipement est désactivé, pour laisser la main à la page mobile.

Historisation

J’ai repris le système de Jeedom pour l’historisation des données.

Les Mini, Maxi, Moyenne et Tendance sont affichés seule le timing est modifié pour l’adapter au plugin.(Mini, Maxi, Moyenne sur 10j et Tendance sur 12h)

Cela historise aussi les données et donne accès la représentation graphique classique de Jeedom.

Vous pouvez activer ou pas l’ensemble en activant le bouton ci-dessous dans les paramétrages.

Les APIs

Les données sont récupérées par des API gratuites: Openwheather et navigator.geolocation(HTML)

J’ai mis en place, un systeme de bridage qui vous empêche des rafraichissements trop rapproché des données car l’API est gratuite mais dans une certaine limite.

Cela fonctionne presque partout dans le monde et vous pouvez l’utilisez en vous géolocalisant automatiquement.

Les normes utilisées sont ceux de l’Agence européenne pour l’environnement 2021.

Configuration principale du plugin

Après avoir installé le plugin, il faut l’activer puis renseigner votre clef api.

Si vous avez déjà une clef pour le plugin Weather officiel de Jeedom, la clef s’importe dans le plugin en cliquant sur import. Vous n’avez donc pas besoin de nouvelle clef.

Pour obtenir une clef api OpenWheather il faut aller ici, créer un compte gratuit et ensuite il faut copier votre clef api dans la zone prévue sur la page “Configuration du Plugin”.

Configuration principale de l’équipement

Vous avez quatre choix de localisation :

1. Par ville : vous rentrez le nom d’une ville et son code pays, vous testez si l’API reconnait bien cette ville, puis vous enregister.
2. Par longitute & latitude : Si vous avez dèjà des coordonnées, vous pouvez les rentrées ici, cela permet aussi de retrouver le nom du lieu avec les coordonnées.
3. Par géolocalisation automatique du navigateur : rapide et pratique si vous accèdez à votre jeedom en déplacement ou en vacances, il se base sur les coordonnées du navigateur.
4. Grâce aux infos localisations Jeedom si elle sont déjà présentes dans la configuration générale du soft
5. Follow me : géolocalisation mobile

Pour la localisation ‘Par ville’, vous devez vérifier que la ville est bien trouvée par l’appli en cliquant sur vérifier avant de sauvegarger. ‘Par longitude & latitude’, pareil, vous devez vérifier que les coordonnées que vous entrez soient valables.

Vous pouvez également activer, le glissement automatique du carroussel, pour cela mettez Animation en ‘activer’

Vous pouvez créer plusieurs équipement pour plusieurs villes.

Utilisation

En cliquant sur les moyennes vous accèder au graphique représentant ces données (fonction native de Jeedom)

Le graphique du bas donne le mini et maxi prévu par jour de la semaine pour chaque élément analysé.

Tous les polluants sont affichés par défault, il vous suffit de désactiver l’option “Afficher” dans la partie Commandes de votre équipement pour ne plus l’afficher dans le slide.

Il existe une version mobile qui reprend pratiquement exactement la vue du dashboard.

Important

L’AQI en Europe est désormais calculée de 1 (Bon) à 6 (Extrèmement mauvais)

J’ai utilisé les code couleur officiel pour l’affichage : voir ici

Vous pouvez régler les alertes par polluant dans la configuration :

Note

Le rafraîchissement des données AQI s’effectue toutes les 30 minutes et le forecast trois fois par jour à 7h00, 12h00 et 18h00

Ce plugin est simplement informatif, il ne remplace en aucun cas pas d’éventuels indications données par votre médecin ou tout autre corps médicale.

Gestion des alertes

Pour connecter le plugin à Telegram, Discord ou un téléphone(sms), c’est le même principe :

Ex pour vers Telegram :

• Il faut avoir le plugin Telegram installé auparavant.
• Le principe : Vous allez essayer de récupérez le message d’alerte toutes les demi-heures, donc on vérifie si un message est présent toute les 2 min (durée de vie d’un message) et on l’envoie vers son bot Telegram.
• En réglant le niveau des alertes vous déclenchez ou pas des messages.
• Donc, si vous régler les niveaux sur “Dégradé”, vous n’aurez des messages que si cet élément est au moins dégradé.

Créez un nouveau scénarion Jeedom :

• Declenchement -> Programation : */2 * * * * soit toute les 2 minutes (la durée de vie d’un message)
• Dans l’onglet Scénario :
• Ajouter un bloc SI/ALORS/SINON
• Insérez un SI : #[nom_de_votre_objet][nom_de_votre_equipement_pollution][Alerte Pollution]# !='' (cherchez avec la recherche simplifié)
• Pas d’espace entre les ‘’ et un != pas de == (Ce qui va déclencher un message Telegram, seulement si un message est disponible.)
• ALORS -> action inserez #[nom_de_votre_objet][nom_de_votre_equipement_telegram][votre bot]#
• Puis dans message vous allez cherchez la commande du plugin qui s’appelle : Telegram Pollution
• Cela donne : #[nom_de_votre_objet][nom_de_votre_equipement_pollution][Telegram Pollution]#
• Option : vide

Cela devrait marcher, le cas échéant, faites moi remonter vos problèmes.

Pour les messages Discord, c’est le même principe, sauf que vous devez récupérer la commande : Markdown Pollution

Exemple Message Telegram :

Exemple Message Discord :