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
- 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
Nuageux avec un vent du Nord de 10 km/h, une température minimum de 2° et une température maximale de 10°.
On prévoit 0mm (pas plus de 0mm en tous cas) de précipitations, avec une probabilité de 20%.
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 :
Averses de pluie locales avec un vent du Nord-Nord-Est de 15 km/h, une température minimum de 2° et une température maximale de 10°.
On prévoit 1.6mm (pas plus de 2.1mm en tous cas) de précipitations, avec une probabilité de 50%.
{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 !
Averses de pluie locales avec un vent du Nord de 20 km/h, une température moyenne de 10°.
On prévoit 0.7mm (pas plus de 0.7mm 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 21 April 2024
qui se déroule à une altitude de 2027m dans la commune de Huez (38142) :
Orages faibles et locaux de pluie et neige mêlées ou grésil avec un vent du Nord-Nord-Ouest de 10 km/h, une température minimum de -7° et une température maximale de -2°.
On prévoit 4.7mm 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