Meteo
Cette action a été écrite par un utilisateur de UP pour les besoins de son association

Basée sur l'API de Météo Concept permettant aux développeurs de site internet ou d'applications d'intégrer des données météorologiques de prévisions ou d'observations pour un lieu ou une station météo souhaitée.

 

🆙 meteo_concept : Retourne les prévisions météo pour à date donnée pout une ville FRANCAISE donnée

Cliquer pour lire la documentation

Basée sur l'API de Météo Concept permettant aux développeurs de site internet ou d'applications d'intégrer des données météorologiques de prévisions ou d'observations pour un lieu ou une station météo souhaitée.
Pour commencer à l'utiliser l'API, il est nécessaire de s'inscrire sur le site internet de Météo Concept. La formule gratuite permet de faire jusqu'à 500 requêtes par jour.
Cette inscription fourni une authentification et une autorisation grâce à une clé d'API, appelé communément « token ».
syntaxe 1
{up meteo=Date ou dateheure de la prévision |insee=code |token=Token fourni par Météo Concept } 
syntaxe 2
{up meteo=Date ou dateheure de la prévision |insee=code |token=Token fourni par Météo Concept } 
modèle de texte avec mots-clés
{/up meteo}
trouver un code insee : https://www.insee.fr/fr/recherche/recherche-geographique
---- MOTS CLES
##insee## Code Insee de la commune
##cp## Code postal de la commune
##name## Nom de la commune
##latitude## Latitude décimale de la commune
##longitude## Longitude décimale de la commune
##altitude## Altitude de la commune en mètres
##dirwind10m## ou ##winddirs## Direction du vent
##gust10m## Rafales de vent à 10 mètres en km/h
##gustx## Rafale de vent potentielle sous orage ou grain en km/h
##probafog## Probabilité de brouillard entre 0 et 100%
##probafrost## Probabilité de gel entre 0 et 100%
##rainprob## ou ##probarain## Probabilité de pluie entre 0 et 100%
##probawind100## Probabilité de vent >70 km/h entre 0 et 100%
##probawind70## Probabilité de vent >100 km/h entre 0 et 100%
##rainmax## ou ##rr1## Cumul de pluie maximal sur la journée en mm
##rain## ou ##rr10## Cumul de pluie sur la journée en mm
##weather-text## Resenti météo sous forme de texte
##weather## Resenti météo index (nombre de 0 à 235)
##windspeed## ou ##wind10m## Vent moyen à 10 mètres en km/h
---- QUART DE JOURNEE UNIQUEMENT
##temp## ou ##temp2m## Température à 2 mètres en °C
---- JOURNEE ENTIERE UNIQUEMENT
##temp-max## ou ##tmax## Température maximale à 2 mètres en °C
##temp-min## ou ##tmin## Température minimale à 2 mètres en °C
##sun_hours## Ensoleillement en heures
##etp## Cumul d'évapotranspiration en mm
@author: Denis & lomart @version: UP-2.9 @license: GNU/GPLv3 @tags: Widget
  • meteo_concept: Date de la prévision sous la forme AAAAMMJJ (journée) ou AAAAMMJJHHMM (quart de journée début à 1,7,13 ou 19h)
  • insee: Localisation par code insee de la commune (mode prioritaire)

Si la date n'est pas dans les 14 jours à venir

  • msg: 1 pour afficher un message si hors période de 14 jours
  • msg-before = L\'événement est terminé depuis le %s: message si date antérieure
  • msg-after = Prévisions disponibles à partir du %s: message si date postérieur

CSS pour bloc principal

  • tag = div: balise utilisée pour le bloc principal si un style est indiqué.
  • style: classe et style pour le bloc principal.

Paramètres webmaster

  • date-format = %A %e %B %Y: format de la date
  • cache-delay = 60: durée du cache en minutes. 0 pas de cache
  • token: Token fourni par Météo Concept

Un exemple simple

{up meteo-concept=today | insee=77186 | style=bd-bleu;bg-jauneClair;p2 | token=mon_token}

Le shortcode ci-dessus affiche le temps qu'il fait aujourd'hui à Fontainebleau

Il est actuellement prévu pour la journée du Tuesday 23 July 2024 à Fontainebleau (77300) les conditions météo suivantes :
Pluie modérée intermittente avec un vent d'Ouest-Nord-Ouest de 10 km/h, une température minimum de 18° et une température maximale de 23°.
On prévoit 3.5mm (pas plus de 6.5mm en tous cas) de précipitations, avec une probabilité de 90%.

Il faut spécifier une date située dans les 14 jours ou le mot today pour aujourd'hui.
Le code de la ville, récupéré sur le site de l'insee, est indispensable.
J'ai ajouté quelques classes de UP pour la mise en forme.

Pour commencer à l'utiliser l'API, il est nécessaire de s'inscrire sur le site internet de Météo Concept. La formule gratuite permet de faire jusqu'à 500 requêtes par jour. Cette inscription fourni une authentification et une autorisation grâce à une clé d'API, appelé communément « token ».
Pour éviter de la saisir à chaque fois, je vous conseille d'ajouter ce token dans le fichier "prefs.ini" de votre dossier "plugins/content/up/meteo_concept/custom"

A peine plus compliqué

Le but originel de cette action est d'indiquer le temps qu'il fera pour la manifestation organisée par l'association.
Nous allons donc ajouter la date comme argument principal. Les prévisions sont possibles 14 jours à l'avance.

Les prévisions sont possibles pour la journée entière ou pour un quart de la journée, selon que vous indiquiez l'heure ou non.

Pour la journée entière :

Il est actuellement prévu pour la journée du Sunday 28 July 2024 à Fontainebleau (77300) les conditions météo suivantes :
Averses de pluie locales et faibles avec un vent du Nord-Est de 10 km/h, une température minimum de 15° et une température maximale de 24°.
On prévoit 0.9mm (pas plus de 0.9mm en tous cas) de précipitations, avec une probabilité de 60%.
{up meteo-concept={up php=echo date('Y-m-d',strtotime('next sunday'));}
 | insee=77186 | style=bd-bleu;bg-jauneClair;p2 | token=mon_token}

Pour l'après-midi :

L'heure de début pour chacune des périodes sont 1h, 7h, 13h et 19h. Tenez en compte, 12h30, c'est encore le matin !

Il est actuellement prévu pour l'après-midi du Sunday 28 July 2024 à Fontainebleau (77300) les conditions météo suivantes :
Averses de pluie locales et faibles avec un vent du Nord-Est de 10 km/h, une température moyenne de 24°.
On prévoit 0.2mm (pas plus de 0.2mm en tous cas) de précipitations, avec une probabilité de 50%
{up meteo-concept={up php=echo date('Y-m-d',strtotime('next sunday'));} 14:00
 | insee=77186 | style=bd-bleu;bg-jauneClair;p2
 | token=mon_token}

Pour les besoins de cette démo, afin d'avoir une date toujours valide, je vais demander les prévisions pour dimanche prochain en utilisant l'action PHP de UP. Cette action retourne la date sous la forme AAAA-MM-JJ ou AAAA-MM-JJ 14:00

Adapter le texte retourné

Vous pouvez préférer votre style pour mettre en forme les informations. Cela est très facile en utilisant la méthode habituelle des mots-clés de UP.
Le modèle doit se trouver en le shortcode ouvrant et fermant. Le HTML et le BBCODE sont autorisés.

Les données météo pour notre événement du Sunday 28 July 2024
qui se déroule à une altitude de 2027m dans la commune de Huez (38142) :
Averses de pluie locales et faibles avec un vent d'Ouest-Nord-Ouest de 5 km/h, une température minimum de 13° et une température maximale de 22°.
On prévoit 6.2mm de précipitation.

{up meteo-concept={up php=echo date('Y-m-d',strtotime('next sunday'));}
| insee=38191
| style=bd-rouge;bg-jauneClair;p1 | token=mon_token}
[img class='float-left m1' src='https://via.placeholder.com/90/FF000/FFFF00?text=##WEATHER##']Les données météo pour notre événement du [b]##date##[/b]
qui se déroule à une altitude de ##ALTITUDE##m dans la commune de ##name## (##cp##) :
[b]##WEATHER-TEXT##[/b] avec un vent ##WINDDIRS## de ##WINDSPEED## km/h, une température minimum de ##TEMP-MIN##° et une température maximale de ##TEMP-MAX##°.
On prévoit ##RAIN##mm de précipitation.
{/up meteo-concept}

Vous avez la démo et le shortcode en-dessous.

Le shortcode ouvrant spécifie la date et le lieu pour les prévisions, ainsi qu'un cadre rouge pour mettre en valeur le résultat.

Le contenu entre les shortcodes est un mélange de texte, de bbcode et de mots-clés entre des doubles dièses (##) qui seront remplacés par les valeurs retournées par MétéoConcept.

Le bloc rouge est la valeur de ##WEATHER## sous forme d'image. On peut très bien imaginer d'avoir des images numérotées pour représenter le ressenti météo.

Tous les mots-clés sont dans le tableau ci-dessous.
Attention, selon le type de prévisions demandées (journée ou partie de journée) certains mots ne peuvent pas être utilisés.

Mot-clé Jour Partie Commentaires
Données city
insee Code Insee de la commune
cp Code postal de la commune
name Nom de la commune
latitude Latitude décimale de la commune
longitude Longitude décimale de la commune
altitude Altitude de la commune en mètres
Données forecast générales
update date heure de l'actualisation
datetime Date en heure locale, format ISO8601
Données forecast météo
dirwind10m ou winddirs Direction du vent en degrés (0 à 360°)
etp Cumul d'évapotranspiration en mm
gust10m Rafales de vent à 10 mètres en km/h
gustx Rafale de vent potentielle sous orage ou grain en km/h
probafog Probabilité de br[oui]llard entre 0 et 100%
probafrost Probabilité de gel entre 0 et 100%
probarain ou rainprob Probabilité de pluie entre 0 et 100%
probawind100 Probabilité de vent >70 km/h entre 0 et 100%
probawind70 Probabilité de vent >100 km/h entre 0 et 100%
rr1 ou rainmax Cumul de pluie maximal sur la journée en mm
rr10 ou rain Cumul de pluie sur la journée en mm
sun_hours Ensoleillement en heures
temp2m ou temp Température à 2 mètres en °C
tmax ou temp-max Température maximale à 2 mètres en °C
tmin  ou temp-min Température minimale à 2 mètres en °C
weather-text Temps sensible sous forme texte
weather Temps sensible index pour images
wind10m ou windspeed Vent moyen à 10 mètres en km/h

Quelques options

Si la date n'est pas située dans les 14 jours à venir, l'action peut afficher un message si l'option msg est spécifiée. Le texte est défini par les options msg-before (date pas encore valide )et msg-after (date dépassée)

tag et style permettent l'habillage du bloc retourné. Style admet des classes et des styles. Séparateur point-virgule.

date-format définit le format les dates. Aide-mémoire rédacteur

Pour les experts

Pour éviter un dépassement des 500 requêtes journalières, l'action utilise un système de cache. Par défaut, on considère que les informations météo sont pertinentes durant 1 heure. Vous pouvez modifier ce délai avec l'option cache-delay