Vigilance Météo 2023

v1.8
Plugin permettant de récupérer les données de Vigilance météo de Météo France ™

Attention, avant installation, il vous faut bien regarder les prérequis pour récupérer (gratuitement) la clé de l'Api auprès de Météo France™

Forum associé à ce Plugin : https://forum.eedomus.com/viewtopic.php?f=50&t=11936

SOMMAIRE :

Prérequis

Installation

Utilisation

Affecter des icônes aux risques

Problématique Potentielle pour les règles

Optimisation de la synchronisation, de la cpu de la Box et de votre bande passante

Pour Aller plus loin

Suivi des versions




Prérequis

Vous devez avoir une clé API (gratuite) afin de pouvoir faire fonctionner ce Plugin.

Voila comment faire :

1 / Création de votre compte chez Météo France™

Vous devez, en premier lieu, aller sur le site des API de Météo France ™

En haut à droite, cliquer sur l'icône de connection

N|Solid

N|Solid

Ensuite cliquer sur "Créer un compte".

N|Solid

Saisir un nom d'utilisateur (ATTENTION : Pas un email) et cliquer sur "Procéder à l'auto-inscription".

Une fois saisi vos informations, cocher la case pour la politique de confidentialité et cliquer sur "S'enregistrer"

N|Solid

Si tout s'est bien passé, vous devez avoir le message ci-dessous.

N|Solid

Il vous reste encore à parcourir vos mail pour cliquer sur le lien qui vous a été envoyé pour confirmer la création de votre compte comme ci-dessous

N|Solid

Vous obtenez alors :

N|Solid

Votre compte est bien créé, poursuivons sur votre abonnement gratuit.

2 / Abonnement au données Météo Publiques**

Vous devez, en premier lieu, aller sur le site des API de Météo France ™

En haut à droite, cliquer sur l'icône de connection

N|Solid

Puis vous connecter

N|Solid

Une fois connecté, cliquer sur "Données publiques"

N|Solid

Sur "Bulletin Vigilance", cliquer sur "En savoir plus"

N|Solid

Cliquer alors sur le bouton "Souscrire à l'API gratuitement"

3 / Récupération de votre clé d'Api**

N|Solid

Cliquer sur le bouton "Configurer l'API"

N|Solid

Choisir "API Key"

Définir la durée à 94608000 (soit 3 ans en secondes)

Cliquer sur le bouton "Générer Token"

Cliquer sur l'oeil pour voire apparaitre la clé API et la copier entièrement (elle se termine par ==)

Sauvegardez la dans un bloc note.

Elle est valable 3 ans

Installation du plugin

Cliquer sur le bouton "Créer" an bas à gauche en dessous du plugin

N|Solid

Si la pièce "Météo" à été crée automatiquement par votre box, laissez la pièce sur "Aucune" au niveau de l'écran d'installation, les périphériques s'y retrouveront automatiquement après création.
Dans le cas contraire, modifiez la pièce afin que les 6 périphériques s'y retrouvent.

Saisissez votre département et votre clé d'Api et cliquez sur le bouton "Créer".

N|Solid

Utilisation du plugin

Les périphériques sont affichés dans l'ordre suivant :

Pour la journée en cours

N|Solid
N|Solid
N|Solid


Pour le lendemain

N|Solid
N|Solid
N|Solid

Les libellés des risques ne tiennent pas uniquement compte du risque principal, mais aussi des risques secondaires. Cela veut dire que si Météo France nous dit que sur la même journée, on est en Orange pour "Orages", et en Jaune pour "Vent", les deux seront affichés par ordre de priorité pour les risques concernées.

Les libellés de Validité : a/c veut dire à compter du (ou à partir du).

Affecter des icônes aux risques

Depuis cette version proposée par Météo France, il n'y a pas un mais des risques potentiels à un moment donné.

Par exemple, on peut être en alerte Rouge pour Canicule, Orange pour les Orages, et Jaune pour les innondations au même moment.
Dans ce cas, le plugin indiqera une alerte Rouge (la plus importante des trois) avec comme risques : Canicule, Orages, Pluie-inondation

J'ai donc décidé, de part le nombre de possibilité de ne pas affecter d'icône à chque risque.
Cela reste néanmoins possible, en ajoutant des valeurs et icônes associés à la liste de valeurs des risque(s) jour et lendemain.

A titre d'information, voilà la liste des risques rescensés dans mon département sur l'années 2023

Listes des Risques sur 2024 (département 31)

Risque(s)
Aucun
Avalanches
Canicule
Canicule, Orages
Crues
Crues, Avalanches
Crues, Neige / Verglas, Avalanches
Crues, Orages
Crues, Orages, Avalanches
Crues, Orages, Neige / Verglas, Avalanch
Crues, Orages, Pluie-inondation
Crues, Pluie-inondation
Neige / Verglas
Neige / Verglas, Avalanches
Orages
Orages, Avalanches
Orages, Canicule
Orages, Neige / Verglas, Avalanches
Orages, Pluie-inondation
Pluie-inondation
Pluie-inondation, Neige / Verglas, Avala
Pluie-inondation, Orages
Vent
Vent, Avalanches
Vent, Crues
Vent, Crues, Avalanches
Vent, Crues, Orages, Avalanches
Vent, Orages
Vent, Orages, Avalanches

Problématique Potentielle pour les règles

Si vous observez la configuration de chacun des périphériques concernés par ce Plugin, vous verrez que chacun va, dans l'intervalle de temps paramétré, faire une demande à Météo France pour obtenir les données qui le concerne. <il se peut donc qu'il n'y ait pas la dernières information à jour lorsque vous déclenchez une règle. Par exemple, vous passez d'une alerte Jaune pour Orages à une alerte Rouge pour Vent, il se peut que lorsque la vigilance Rouge apparaisse, il y est encore, pour quelques minutes ou quelques secondes le risque Orange d'affiché pour le risque associé sur le périphérique, le temps que lui aussi fasse sa requête auprès de Meteo France.

Il est donc nécessaire, lors de la mise en oeuvre d'une règle de bien prendre en compte ce paramètre.

Il faut donc envisager ceci lors de la création d'une règle : N|Solid

Néanmoins, une autre solution (ci-dessous) est bien plus efficace :

Optimisation de la synchronisation, de la cpu de la Box et de votre bande passante

Comme énoncé ci-dessus, six périphériques associés à ce plugin font chacun la même demande auprès de Météo France, récupèrent tous l'ensemble des données et n'affichent que ce qui les concerne. C'est ce que j'ai essayé d'éviter, afin de synchroniser les données en simultané, et de ne pas faire six fois les mêmes demandes pour rien.

Pour le mettre en place

1/ Vous aller, dans l'ordre, récupérer les Ids (ou Code API) de vos périphériques sur eedomus
(Vous pouvez récupérer cet identifiant en cliquant sur la flèche à coté de "Paramètres Expert" dans la page de configuration de chacun des périphériques concernés)
    1 - Vigilance jour
    2 - Risque jour
    3 - Validité jour
    4 - Vigilance lendemain
    5 - Risque lendemain
    6 - Validité lendemain
    Attention, l'ordre est très important

2/ sur le périphérique Vigilance jour (et uniquement sur celui-ci), sur la variable utilisateur [VAR3], vous aller saisir tous ces Ids en les séparant par un point-virgule. Cela vous donnera donc, par exemple, en [VAR3] :

123;456;789;1011;1213;1415
Pas de point-virgule ni d'espace au début comme à la fin, aucun blanc (espace) nulle part.

3/ Vous enregistrez et c'est terminé.

Vous pouvez donc, sur le périphérique de Vigilance du jour, régler la fréquence de requête. pour tous les autres, vous mettez la fréquence de requête à 0 (ce qui veut dire jamais). N|Solid

Dès cet instant, si vous avez bien tout fait dans le bon ordre, dès qu'une interrogation sera fait vers Météo France, tous les périphériques seront mis à jour en même temps.

En conséquance, à compter de ces modifications, le périphérique Vigilance Jour devient la référence aussi pour le département (Variable Utilisateur [VAR1]) et la clé d'Api Météo France (Variable Utilisateur [VAR2])

Pour Aller plus loin

N'hésitez par à venir poser des question ou à me dire comment ça marche bien ;-) sur le forum

Suivi des versions

Version Date Commentaire
1.8 01/09/2024 Mise à jour de la documentation
1.7 23/08/2023 Pb si pas de prévision pour le lendemain. Nécessite une action de votre part si plugin déjà installé.(Voir sur le forum)
1.6 19/08/2023 Correction Heures périodes vigilances (Merci @LioNeL) et ajout Date et Heure de début pour validité du jour.
1.5 03/08/2023 Correction d'un libellé de risque. (Merci à eedomusbox)
1.4 26/07/2023 Correction de la date de validité du jour lors du niveau de vigilance vert.
1.3 15/07/2023 Optimisation du code.
1.2 29/06/2023 Correction problème de libellés des date de validité des vigilances (2).
1.1 26/06/2023 Correction problème de libellés des date de validité des vigilances.
1.0 25/06/2023 Création