API Météo · 1,3 km à 28 km · 15 jours
Le modèle le plus fin couvrant votre point. Choisi à chaque requête.
La plupart des API météo font tourner un seul modèle global partout. Celle-ci en tient 8, et détermine lequel répond pour une coordonnée donnée à une échéance donnée — de sorte qu'un village alpin ne reçoit pas la même maille de 28 km que le milieu de l'Atlantique.
Les mêmes 120 km de côte, vus par chaque modèle 28 km la baie a disparu 1.3 km l'île existe
La résolution n'est pas un détail de fiche technique. Elle décide si une baie, une vallée ou une île existe dans le modèle — et une maille qui moyenne la mer et la terre vous donne la température d'aucune des deux.
8 modèles, résolus automatiquement
Vous ne choisissez jamais de modèle. Vous envoyez une coordonnée ; l'API prend le plus fin qui la couvre, mélange aux bords de domaine pour que la valeur ne saute pas, et vous dit dans la réponse quel modèle a répondu.
| Modèle | Résolution | Couverture | Runs | Échéance | Disponible après |
|---|---|---|---|---|---|
| Météo-France AROME | 1.3 km | France et abords | 8 ×/jour | 51 h | 4 h |
| DWD ICON-D2 | 2.2 km | Europe centrale | 4 ×/jour | 48 h | 2 h |
| NOAA HRRR | 3 km | États-Unis continentaux | 4 ×/jour | 48 h | 1.5 h |
| DWD ICON-EU | 6.5 km | Europe, Afrique du Nord, Proche-Orient | 2 ×/jour | 120 h | 3 h |
| DWD ICON | 13 km | Monde | 2 ×/jour | 180 h | 4 h |
| ECMWF IFS | 28 km | Monde — toujours présent | 2 ×/jour | 240 h | 7 h |
| ECMWF AIFS | 28 km | Monde, jours 11 à 15 | 2 ×/jour | 360 h | 7 h |
| ECMWF wave | 28 km | Océans et mers uniquement | 2 ×/jour | 240 h | 7 h |
Bords de domaine
Aucune couture là où un modèle s'arrête
Changer brutalement de modèle à une frontière fait diverger deux villes voisines sans raison physique. Chaque domaine porte une marge de mélange : près du bord, le poids du modèle fin décroît et le reste passe au modèle suivant. À l'intérieur du domaine, vous avez le modèle fin sans mélange.
Échéance
Fin au début, global ensuite
AROME s'arrête à 51 heures et HRRR à 48. Au-delà, le résolveur redescend par ICON-EU et ICON jusqu'à ECMWF, sur la même requête. Votre série à sept jours est cousue depuis le meilleur modèle disponible à chaque pas, et la réponse enregistre le mélange.
Ce qui revient
45 champs horaires — 27 stockés, 18 calculés à la volée. 21 reviennent par défaut ; demandez les autres par leur nom dans hourly=, ou demandez-en moins et allégez la réponse.
Température & humidité
temperature_2m, max et min quotidiens, dewpoint_2m, humidité relative, température ressentie, indice de chaleur, refroidissement éolien, température de surface.
Vent
Composantes u/v à 10 m et 100 m pour l'éolien, vitesse, direction, point cardinal, force Beaufort, et wind_gust_10m.
Précipitations
Précipitations totales décumulées par intervalle, chutes de neige en équivalent en eau, et un code OMM precipitation_type qui sépare pluie, neige et pluie verglaçante.
Nuages & visibilité
Couverture totale plus les étages bas, moyen et haut séparément — le nuage bas est ce qui rend une journée grise, le cirrus n'atténue presque rien. Octas pour l'aviation, et visibility pour le brouillard.
Rayonnement & soleil
Irradiance solaire, séparée en direct et diffus pour le rendement photovoltaïque. Élévation et azimut du soleil, indicateur de jour, lever et coucher, et un indice UV estimé.
Pression & instabilité
Pression au niveau de la mer et en surface, tendance sur trois heures, cape pour le potentiel convectif, et vapeur d'eau intégrée sur la colonne.
Sol
Température du sol en surface et dans la zone racinaire 7–28 cm — celle qui intéresse l'agriculture — depuis ICON. soil_temperature_0cm et soil_temperature_8cm.
Neige
Hauteur, équivalent en eau, isotherme 0 °C, et snow_line_altitude — l'altitude au-dessus de laquelle les précipitations tombent en neige, qui est une décision qu'un gestionnaire de route peut prendre.
Synthèse
Un seul code OMM weather_code par pas de temps, pour que le client dessine une icône au lieu de réimplémenter la logique qui transforme sept champs en « pluie faible ».
Deux corrections que la plupart des API sautent
Altitude
La montagne du modèle n'est pas la vôtre
Un modèle numérique lisse le relief à sa maille. Un village de fond de vallée peut se trouver 400 m sous l'altitude que le modèle lui prête, et la température brute est fausse du gradient thermique sur cet écart.
Envoyez elevation avec votre requête et la valeur est corrigée contre l'orographie propre du modèle. En zone de relief cela vaut typiquement 1 à 3 °C. La réponse indique l'altitude du modèle, la vôtre et l'écart appliqué — vous pouvez donc l'auditer, ou l'ignorer.
Fraîcheur
Périmé vaut mieux qu'absent, et le dit
Si notre run le plus récent est plus vieux que prévu, vous recevez quand même des données, avec "stale": true et data_age_hours dans le bloc source. Une prévision vieille de huit heures est plus utile à vos utilisateurs qu'une erreur 500.
Ce que vous n'obtenez jamais, c'est un chiffre périmé qui a l'air frais. Décidez dans votre propre code s'il faut l'afficher, prévenir, ou basculer ailleurs.
{
"grid": { "distance_km": 8.04, "resolution_km": 28.0 },
"elevation": {
"applied": true,
"model_elevation_m": 91.0,
"location_elevation_m": 113,
"temperature_offset_c": -0.14
},
"source": {
"model": "ecmwf_ifs",
"model_run": "20260725T00Z",
"data_age_hours": 8.95,
"stale": false,
"attribution": "Data: ECMWF (CC-BY-4.0)"
}
}Sur la même clé, pas sur une facture de plus
Quatre choses qui sont habituellement des produits séparés ailleurs. Ici ce sont des points d'entrée sur l'offre que vous avez déjà achetée.
/v1/probability
À quel point la prévision est-elle sûre ?
Une valeur unique dit 22 °C jeudi — une hypothèse présentée comme un fait. Ceci renvoie p10, p50, p90 et la dispersion de l'ensemble à 50 membres d'ECMWF, plus les probabilités de pluie à 0,1, 1, 5 et 10 mm.
Une dispersion de 0,4 °C, c'est une situation établie. Une dispersion de 3 °C veut dire que l'atmosphère elle-même est incertaine, et vos utilisateurs méritent qu'on le leur dise.
/v1/air-quality
Particules, ozone, NO₂ — et poussières sahariennes
Depuis Copernicus CAMS, avec les valeurs guides de l'OMS embarquées dans chaque réponse : un chiffre peut être situé sans aller le chercher ailleurs.
La poussière compte en Afrique du Nord et en Méditerranée : un épisode pousse les PM10 au-delà de mille µg/m³ pendant des jours, et les services grand public gratuits le couvrent mal.
/v1/marine
État de la mer, partout
Hauteur significative des vagues, direction et période depuis le modèle de vagues d'ECMWF, jusqu'à dix jours. Un point à terre renvoie 404 not_at_sea plutôt qu'une colonne de valeurs nulles qui ressemble à une panne.
/v1/hydrology
Combien d'eau arrive ici
Débit des rivières depuis Copernicus GloFAS sur un réseau hydrographique à 0,05° — pas combien de pluie tombe en amont, mais combien d'eau atteint ce point, ce qu'un bassin versant et un jour de temps de parcours séparent.
Information seulement. L'émission d'alertes de crue est réservée aux autorités nationales et régionales.
Là où ça travaille
Produits météo
Pages ville, applications et widgets. Un code OMM par pas pour l'icône, des agrégats quotidiens découpés dans le fuseau de l'utilisateur, et un catalogue de villes avec recherche et point le plus proche.
Énergie
Vent à 100 m pour la hauteur de moyeu, irradiance directe et diffuse pour le rendement photovoltaïque, et dispersion d'ensemble pour le côté risque d'une position.
Agriculture
Température et température du sol à quatre profondeurs, entrées d'évapotranspiration, risque de gel depuis la température minimale, et rafales pour les fenêtres de traitement.
Logistique & routes
Limite pluie-neige, isotherme 0 °C, type de précipitation et visibilité — les quatre champs qui décident si un col ferme.
Marine & outdoor
Hauteur, période et direction des vagues, rafales, indice UV et durée du jour, pour la planification qui doit se faire une semaine à l'avance.
Revendeurs
Vous pouvez redistribuer. Construisez un produit par-dessus et vendez-le, avec une ligne d'attribution en pied de page comme seule obligation qui vous suit.
Ce qu'elle fait mal
Nous préférons que vous connaissiez les limites maintenant plutôt que de les découvrir en production.
Points forts
Température, pression, vent synoptique, humidité, ensoleillement. L'erreur typique sur la température à 2 m à 24 heures est d'environ 1 à 1,5 °C. ECMWF est le meilleur modèle déterministe global du monde, et c'est ce que vous recevez.
Points faibles
Les orages convectifs — une maille de 28 km ne peut pas résoudre un orage, et même 3 km n'en donne qu'un indice. Le placement et l'horaire exacts des averses. Le microclimat côtier et de montagne sous la résolution du modèle. Les brises de mer et les lacs d'air froid en vallée, que la correction d'altitude ne modélise pas.
Honnêteté géographique
En France, en Allemagne, aux États-Unis et au Canada nous servons des modèles nationaux à 1,3–3 km et un petit village a vraiment sa propre maille. Les territoires d'outre-mer, l'Alaska, Hawaï et le nord du Canada sont hors de ces domaines et retombent à 13 km. Ailleurs en Europe vous avez 6,5 km. En Afrique, au Proche-Orient et dans la majeure partie de l'Asie, le meilleur modèle public disponible est à 13–28 km : vous avez la météo de la zone plutôt que celle de la rue. La correction d'altitude réduit cet écart ; elle ne le referme pas.
Pas un service d'alerte
Aucune alerte, aucune couleur de vigilance, aucune consigne. Cela appartient aux autorités qui peuvent aussi fermer une route et évacuer un village.
Questions fréquentes
Quel modèle servira ma localisation ?
Le plus fin qui la couvre : AROME à 1,3 km en France, ICON-D2 à 2,2 km en Europe centrale, HRRR à 3 km aux États-Unis, ICON-EU à 6,5 km sur l'Europe et l'Afrique du Nord, ICON à 13 km dans le monde, et ECMWF IFS à 28 km comme socle toujours présent.
Appelez /v1/models pour voir le registre courant et le domaine de chaque modèle, ou lisez source.model dans n'importe quelle réponse.
À quelle fréquence est-ce mis à jour ?
Les modèles globaux deux fois par jour à 00 et 12 UTC ; les modèles nationaux haute résolution quatre fois par jour à 00, 06, 12 et 18 UTC. Les données deviennent exploitables entre 90 minutes et 7 heures après l'heure du run selon le fournisseur — le tableau ci-dessus donne chacun.
Les réponses de prévision sont mises en cache cinq minutes au bord, ce qui absorbe le trafic répété des pages ville sans jamais servir un run en retard sur celui que nous détenons.
Puis-je demander plusieurs points d'un coup ?
Une coordonnée par requête. Le stockage est découpé de sorte que toute la série temporelle d'une petite zone tienne dans un seul bloc — un point sur tous les pas est la requête bon marché, et c'est celle que presque tous les produits font réellement.
Pour du trafic en forme de ville, /v1/forecast/city/{country}/{slug} porte le fuseau horaire et l'altitude de la ville : vous n'avez pas à le faire.
Y a-t-il un téléchargement en masse ?
Non, sur aucune offre. L'archive est ce que vous payez, et un export sans limite est la façon dont un concurrent l'acquiert en un après-midi. L'export CSV des degrés-jours existe et est délibérément borné.
Combien ça coûte ?
Gratuit pour 10 000 crédits par mois, sans carte. 19 € par mois pour 50 000 crédits, API Degrés-jours, historique et CSV compris. 79 € pour 400 000 crédits et tout le reste. Une requête de prévision vaut un crédit.
Essayez-la sur vos propres coordonnées
Le palier gratuit renvoie les mêmes données que les offres payantes. Pointez-la sur un endroit que vous connaissez bien et jugez les chiffres vous-même.