Weather Forecast, CAP alerts - Plugin pour Jeedom

Plugin utilisant OpenWeatherMap ou weatherApi pour afficher les prévisions météo.

Configuration du plugin

Après installation du plugin, il vous suffit de l’activer. Il apparaitra alors dans le menu Plugins > Météo.

Il est nécessaire de renseigner la clé API correspondant à la source de données utilisée.

NOTA : Heure de Lever et Coucher du soleil

Elles sont calculées localement par le plugin à partir des coordonnées sans accés externe. Elles sont sur le fuseau horaire de votre Jeedom pour des déclenchements d’actions par Jeedom (commandes Id: sunrise et sunset). Pour affichage sur un fuseau horaire différent, les timestamps sont stockés dans les commandes sunriseTs et sunsetTs.

Configuration pour l’utilisation de la source OpenWeatherMap

Si vous utilisiez le plugin officiel Jeedom weather d’avant avril 2024, vous avez déjà un compte OpenWeatherMap. Il vous suffit de récupérer la clé API à cette adresse : OpenWeatherMap.org et de la coller dans la configuration du plugin. Le plugin utilise les APIs gratuites “Current Weather Data” et “5 Day / 3 Hour Forecast”. Le plugin fait deux requêtes dans les 5 premières minutes de chaque demi-heure.

Utilisation

• Créez un équipement.
• Choississez la source de données OpenWeatherMap.
• Renseignez les coordonnées de la localisation désirée. Les coordonnées proposées sont celles renseignées dans la configuration de Jeedom.

• Sélectionnez le template d’affichage. Icônes, Images ou Pas de template Avec le choix “Pas de template”, seule la commande “H0Json pour widget” est affichée. Le widget Clock du plugin lui est affecté.

  La partie supérieure des templates Icônes ou Images affiche les données météo de l’heure actuelle.
  La partie basse fournit les prévisions sur 5 jours à midi pour l’icone et la condition. Les autres données sont relevées(températures min max), cumulées(pluie) dans les 40 prévisions de 3 heures fournies.
  A partir de 10 heure, la première prévision est la tranche de 3 heures suivant l’heure actuelle.

Configuration pour l’utilisation de la source weatherAPI

Cette source de données est celle utilisée par le plugin weather officiel actuel mais sans utiliser le cloud Jeedom. Il est donc nécessaire de créer un compte sur le site weatherapi.com et d’y récupérer la clé API. La création du compte est faite avec une période d’essai avec toutes les fonctionnalités. A la fin de cette période d’essai, le plan Free est automatiquement utilisé. Le plugin utilise uniquement “Forecast Days”. En plan gratuit, il n’y a que 3 jours de prévisions. Le plugin fait une requête chaque quart d’heure. ( Le quota est de 1 million d’appels/mois. )

Utilisation

• Créez un équipement.
• Choississez la source de données WeatherAPI.
• Renseignez les coordonnées de la localisation désirée. Les coordonnées proposées sont celles renseignées dans la configuration de Jeedom.

• Sélectionnez le template d’affichage. Icônes, Images ou Pas de template Avec le choix “Pas de template”, seule la commande “Météo H0 - Json pour widget” est affichée. Le widget ClockWF du plugin lui est affecté. ( Idem OpenWeatherMap )

  La partie supérieure des templates Icônes ou Images affiche les données météo de l’heure actuelle.
  La partie basse donne les prévisions sur 3 jours fournies par weatherApi sans traitement.

Widget

Le widget ClockWF par ses paramètres optionnels et en particulier clockTheme , permet de modifier l’affichage de l’horloge. Il peut etre utilisé avec la commande d’ID: H0Json4Widget pour afficher aussi la météo. Sans commande associée, seule l’horloge est affichée.

Ci-dessous les thèmes Digital et KrisKringle:

Le widget VigilanceWF est également fourni. Il permet l’affichage des alertes météo de MétoFrance. Le département à surveiller doit être renseigné dans la configuration de l’équipement. Le widget est alimenté par la commande d’ID: VigilanceJson. Pour les modifications de l’apparence de ces widgets, voir leur paramètres optionnels respectifs.

Vigilances MeteoFrance

En renseignant le numéro d’un département de France Métropolitaine, les vigilances diffusées par Météo France sont récupérées. Lorsqu’un pays pour les alertes meteoalarm est choisi, les vigilances ne sont plus affichées mais elles sont quand même récupérées.

CAP Alertes meteoalarm.org

Les alertes météo de 38 pays d’Europe sont disponibles.

On les obtient en choisissant un pays et en renseignant une zone (Département, province, région, comté …) On peut sélectionner plusieurs zones. Les alertes des différentes zones sont alors séparées par la barre bleu comme dans l’exemple ci-dessus. La commandes utilisées pour stocker les données est MeteoalarmAlertsJson. Les autres commandes sont MeteoalarmColorMax pour la couleur max prévues ( 1 vert, 2 jaune, 3 rouge ), MeteoalarmColorMaxNow pour le niveau d’alerte actuel et MeteoalarmList pour la liste des alertes prévues.

Les icônes et les IDs des alertes CAP:

Les commandes “Json”

Les fonction statiques getJsonInfo($cmdId, $request) et extractValueFromJsonTxt($cmdValue, $request) sont fournies pour vous permettre d’extraire des valeurs des commandes Json. Le paramètre $request est un JsonPath simplifié identique à celui du plugin officiel script

Changelog