Plugin Jeedom Air Pollen
Le plugin Air Pollen vous informe sur les pollens 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 pollens. Vous accèdez aux informations en direct mais aussi aux prévisions sur 2 jours.
Les pollens 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 dispo dans la nouvelle version, 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 trois API gratuites: Openwheather, Ambee et navigator.geolocation(HTML)
Elles sont gratuites dans une certaine limite d’appels par jour. Dans l’applis, pour Ambee, le plugin est conçu pour être aux limites du gratuit, c’est à dire 100 appels/jour. Cepandant, certains utilisateurs on reçu un courrier de la Sté Ambee, leur stipulant que la version gratuite sera limité dans le temps. Bien que pour l’instant (au 13/10/2021), il suffit de renouveler votre “Plan” gratuit tous les 15j et cela fonctionne.
Il faudrait alors le cas écheant, basculer vers leur abonnement payant.
Les prévisons de pollens sont mises à jour une fois par jour seulement, j’ai choisi 7h du matin, car seulement 24h sont en fait disponibles. Ce qui veux dire que pour le troisième jour de prévision, les infos vont jusqu’a 7h00 du matin et donc sont suceptiblent dévoluer en s’affinant.
C’est un choix fait pour ne pas atteindre la limite de 100 appels/jour de l’API Ambee et donc que le plugin reste gratuit à l’usage.
En effet, lors du refresh des prévisons pollens l’api compte 1 appel par heure de données fournie, donc l’appel forecast sur 48 heures coûte 48 appels sur les 100 journalier. Ce qui explique mon choix d’appel une fois par jour.
L’Api fonctionne presque partout dans le monde et vous pouvez l’utilisez en vous géolocalisant automatiquement.
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 la clef api ambee il faut aller ici, c’est à peu près le même principe qu’avant : vous récupérez une clef gratuite que vous coller dans la configuration du plugin”.
Configuration principale de l’équipement
Vous avez quatre choix de localisation :
- 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.
- 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.
- 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.
- Grâce aux infos localisations Jeedom si elle sont déjà présentes dans la configuration générale du soft
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 pour les données AQI. Par contre, pour les pollens, en faisant cela, vous dépassez directement le quota journalier.
Vous devrez alors choisir une version payante de l’API Ambee.
Rafraichissement des données
Il existe 8 modes de rafraichissment :
Etant donnés que les données sont payantes, j’ai mis en place un bridage sur la fréquence des rafraichissments : Delta de 5 min minimum pour les infos courantes et delta de 12h entre 2 refresh de prévisions(forecast)
Manuel : 0.017€/appel.
Manuel : 0.017€/appel + prévision 48h 0.80€/appel (Les prévisions se rafraichissent uniquement toutes les 24h).
Auto : 12 X par jour (de 8h à 19h) environ 6.20€/mois.
Auto : 6 X par jour (de 8h à 18h) environ 3.10€/mois.
Auto : 3 X par jour (8h, 12h et 16h) environ 1.55€/mois.
Auto : 2 X par jour (8h et 15h) environ 1€/mois.
Auto : 1 X par heure + prévision 1X par jour, environ 1.20€/jour.
Utilisation
En cliquant sur les moyennes vous accèdez 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é.
Les pollens non détéctés (à zéro) sont affichés à part dans un tableau à la fin du caroussel comme la photo ci-dessus ou il peuvent ne pas être affichés en réglant la molette ci-dessous :
Il existe une version mobile qui reprend pratiquement exactement la vue du dashboard.
Important
Pour les pollens les niveaux de danger principaux sont donnés par l’API Ambee (de 1 Risque nul à 4 Risque très élevé).
J’ai calé les niveaux alertes par pollens, les calculs sont basés sur un Mémoire de l’École Nationale de la Santé Publique et une étude de l’ENSP (pdf dans le repertoire docs) :
Les niveaux d’alertes moyen sont basées sur des seuils d’environs 40 particules/m³, ce qui correspond au plancher de niveau de sensibilité de la plupart des personnes allergiques. Certains sujets hypersensibles, sont touchés dès 5 part/m³.
Mais comme tout le monde est différent, vous pouvez régler les alertes selon vos caractéristiques.
Note
Le rafraîchissement des données Pollen s’effectue à la carte.
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 les pollens vers Telegram :
- Il faut avoir le plugin Telegram installé auparavant.
- Le principe : Vous allez récupérez le message d’alerte toutes les heures, juste après la mise à jour des infos qui est à la minute 0 de chaque heure et l’envoyer vers votre bot Telegram
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_pollen][Alerte Pollen]# !=''
(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 Pollen
- Cela donne :
#[nom_de_votre_objet][nom_de_votre_equipement_pollen][Telegram Pollen]#
- Option : vide
Cela devrait marcher, le cas échéant, faites moi remonter vos problèmes.
Exemple Message Telegram :
Exemple Message Discord :