Comment utiliser Weapi ?

Commencez par vous identifier à l'aide de la page de Login.

Une fois identifié, vous pouvez émettre des instructions décrivant les données que vous souhaitez extraire à l'aide requêtes URL comme décrit ci-après:

url principal (< root_url >) : weapi.analyticstudio.ch

Ressources accessibles (suffixe à ajouter à l'url principal < root_url >) :

latestrun : Date et heure de la dernière sortie de modèle
forecast/dmo : Prévision numérique
forecast/mosmix : Prévision numérique traitée statistiquement (Model Output Statistics) provenant de Deutscher Wetterdienst - MOSMIX_L
measure
site-info

Date et heure de la dernière sortie de modèle - /latestrun

Paramètres acceptés :

(clé et valeur)

model (requis) - Modèle météorologique ; les modèles suivants sont actuellement accessibles :

ICON-D2 (source : Deutscher Wetterdienst - NWP forecast data)
ICON-EU (source : Deutscher Wetterdienst - NWP forecast data)
ECMWF (source : European Centre for Medium-Range Weather Forecasts)

modeltype (requis) - Type du modèle météorologique :

HRES : version déterministe du modèle (un seul scénario météorologique)
ENS : version probabiliste du modèle (plusieurs scénarii, entre 20 et 51 selon le modèle choisi)

Exemple de requête :

< root_url >/latestrun?model=ECMWF&modeltype=ENS

Prévision numérique - /dmo

Paramètres acceptés :

(clé et valeur)

model (requis) - Modèle météorologique (voir /latestrun)
modeltype (requis) - Type du modèle météorologique (voir /latestrun)
lieu - sous l'une des formes suivantes :

lon, lat et height - longitude, latitude (en degrés) et altitude (en mètres)
site - l'acronyme d'une station de mesure disponible (ajouter référence)

parameter (requis) - paramètre météorologique ; les choix actuellement possibles sont:

ppn - cumul de précipitations en millimètres
t2m - température à 2 mètres en degrés Celsius, valeur instantanée
tcc - nébulosité totale en pourcent, valeur instantanée
hcc - nébulosité haute en pourcent, valeur instantanée (disponible seulement pour ICON-EU en HRES)
mcc - nébulosité moyenne en pourcent, valeur instantanée (disponible seulement pour ICON-EU en HRES)
lcc - nébulosité basse en pourcent, valeur instantanée (disponible seulement pour ICON-EU en HRES)

mrun (yyyymmddhh00) - date et heure (UTC) de l'initialisation du modèle numérique. Par défaut, la dernière prévision disponible est extraite.
beg (yyyymmddhh00) - date et heure (UTC) du début de la série temporelle. Par défaut, toutes les échéances de prévision depuis l'heure d'initialistion du modèle sont extraites.
end (yyyymmddhh00) - date et heure (UTC) de fin de la série temporelle. Par défaut, toutes les échéances de prévision au-delà de beg sont extraites.
aggregtype - type de l'aggrégation temporelle - dépend du paramètre météorologique et est appliquable uniquement si timeframe (voir plus bas) est supérieur à la granularité minimale du modèle concerné (voir Section Échéances et granularités temporelles):
- précipitations : la seule aggrégation possible est une somme
- température : les valeurs possibles sont: min, max et mean
- nébulosité : la seule aggrégation possible est une moyenne
timeframe (valeur entière supérieure à la granularité minimale du modèle ; valeur par défaut: granularité du modèle) - longueur de l'intervalle, en heures, sur lequel l'aggrégation temporelle doit être faite.
Note ! Lorsqu'une aggrégation temporelle est faite, la date et l'heure correspondent toujours à la fin de l'intervalle de temps sur lequel les valeurs horaires sont aggrégées.
timestep (valeur entière supérieure ou égale à 1 ; valeur par défaut: 1) - intervalle de temps, en heures, entre deux valeurs temporelles

Exemples de requête :

Prévision de température pour Genève-Cointrin (GVE) - prévision la plus récente et toutes les échéances disponibles:

< root_url >/forecast/dmo?model=ICON-EU&modeltype=HRES&site=GVE&parameter=t2m
Prévision de précipitations pour un point de coordonnées données - prévision la plus récente et toutes les échéances disponibles, cumuls des 6 dernières heures, toutes les 6 heures:

< root_url >/forecast/dmo?model=ICON-EU&modeltype=ENS&lat=46.4&lon=6.3&height=389&parameter=ppn&timeframe=6&timestep=6

Informations supplémentaires sur les données brutes de modèles numériques

Echéances et granularités temporelles disponibles selon les modèles:

modèle ECMWF - granularité temporelle minimale: 3h
- HRES: toutes les 3h de H+0 jusqu'à H+144, puis toutes les 6h de H+144 jusqu'à H+192
- ENS: toutes les 3h de H+0 jusqu'à H+144, puis toutes les 6h de H+144 jusqu'à H+360
modèle ICON-EU - granularité temporelle minimale: 1h
- HRES: toutes les 1h de H+0 jusqu'à H+78, puis toutes les 3h de H+78 jusqu'à H+120
- ENS: toutes les 1h de H+0 jusqu'à H+48, toutes les 3h de H+48 à H+72, puis toutes les 6h de H+72 jusqu'à H+120
modèle ICON-D2 - granularité temporelle minimale: 1h
- HRES et ENS: toutes les 1h de H+0 jusqu'à H+48

Fréquences de mises à jour des modèles:

ICON-EU (HRES et ENS): à 00h, 06h, 12h et 18h UTC
ICON-D2 (HRES et ENS): à 00h, 06h, 12h et 18h UTC
ECMWF (HRES et ENS): à 00h et 12h UTC

Relevés de stations météorologiques - /measure

Paramètres acceptés :

(clé et valeur)

type - deux types sont disponibles :
- smn : stations officielles de MétéoSuisse (valeur par défaut)
- other : autres stations
Voir /site-info pour davantage de détails sur les stations disponibles.
site (requis) - l'acronyme d'une station de mesure
Voir /site-info pour davantage de détails sur les stations disponibles.
parameter (requis) - paramètre météorologique ; les choix possibles sont:
- ppn - cumul de précipitations en millimètres
- t2m - température à 2 mètres en degrés Celsius (calculée à partir de valeurs moyennes horaires)
- trad - rayonnement global en W/m^2 (calculé à partir de valeurs moyennes horaires)
beg (yyyymmddhh00, requis) - date et heure (UTC) du début de la série temporelle.
end (yyyymmddhh00) - date et heure (UTC) de fin de la série temporelle. Si aucune valeur n'est passée, seule la valeur correspondant à beg est retournée.
aggregtype - type de l'aggrégation temporelle - dépend du paramètre météorologique et est appliquable uniquement si timeframe est supérieur à 1h :
- précipitations : la seule aggrégation possible est une somme
- température : les valeurs possibles sont: min, max et mean
- rayonnement solaire: les valeurs possibles sont: mean et sum
timeframe voir /dmo
timestep voir /dmo

Exemple de requête :

Températures journalières maximales durant le mois de janvier 2022 à station de Genève-Cointrin :

< root_url >/measure?site=GVE&parameter=t2m&beg=202201020000&end=202202010000&timestep=24&timeframe=24&aggregtype=max

Liste des stations météorologiques disponibles - /site-info

Paramètres acceptés :

(clé et valeur)

type (requis) - Deux types sont disponibles :
- smn : stations officielles de MétéoSuisse
- other : autres stations

Exemple de requête :

< root_url >/site-info?type=smn