API Météo

Prévision#

Paramètres

Réponse

{
  "latitude": 48.85,
  "longitude": 2.35,
  "timezone": "Europe/Paris",
  "grid": {
    "latitude": 48.85, "longitude": 2.35,
    "distance_km": 0.42, "resolution_km": 1.3
  },
  "elevation": {
    "applied": true,
    "model_elevation_m": 91.0,
    "location_elevation_m": 113,
    "temperature_offset_c": -0.14
  },
  "source": {
    "model": "mf_arome",
    "model_run": "20260801T00Z",
    "reference_time": "2026-08-01T00:00:00+00:00",
    "data_age_hours": 3.95,
    "stale": false,
    "attribution": "Data: Météo-France (etalab-2.0)"
  },
  "hourly": {
    "time": ["2026-08-01T00:00:00+02:00", "..."],
    "temperature_2m": [18.1, 17.9, 17.6, "..."],
    "apparent_temperature": [17.4, "..."],
    "weather_code": [0, 1, 2, "..."]
  },
  "daily": {
    "date": ["2026-08-01", "..."],
    "temperature_2m_max": [26.6, "..."],
    "temperature_2m_min": [16.2, "..."],
    "precipitation_sum": [0.0, "..."],
    "uv_index_max": [7.6, "..."],
    "sunrise": ["2026-08-01T06:24:00+02:00", "..."],
    "sunset": ["2026-08-01T21:24:00+02:00", "..."],
    "daylight_hours": [15.0, "..."]
  }
}

Alléger la charge utile

Le bloc horaire complet sur 15 jours fait environ 32 champs × 360 heures. Si vous en tracez trois, demandez-en trois :

GET /v1/forecast?lat=48.85&lon=2.35&days=3
    &hourly=temperature_2m,precipitation,weather_code
    &include_daily=false

Même prix — le coût est la lecture de l'archive, pas sa sérialisation — mais un dixième des octets, et un décodage nettement plus rapide sur un téléphone.

Prévision par ville#

Préférez ceci aux coordonnées brutes quand vous le pouvez. Le catalogue fournit deux choses qu'une coordonnée ne peut pas donner : l'altitude réelle de la ville, si bien que la correction de relief s'applique sans que vous la fournissiez, et son fuseau horaire, si bien que les agrégats quotidiens sont découpés sur la bonne journée locale.

GET /v1/forecast/city/dz/alger      # slug français
GET /v1/forecast/city/dz/algiers    # slug anglais — même ville
GET /v1/forecast/city/fr/paris

country est un code ISO-3166-1 alpha-2, en minuscules. slug est insensible aux accents : bejaia trouve Béjaïa. Un slug inconnu renvoie 404 city_not_found avec un tableau suggestions — affichez-le plutôt qu'une impasse.

Tous les paramètres de requête de /v1/forecast s'appliquent encore, sauf lat, lon et elevation, que le catalogue fournit. Passer timezone écrase celui de la ville, ce qui n'est presque jamais ce que vous voulez.

Conditions actuelles#

Température, humidité, vent et pression sont interpolés linéairement à l'instant présent, entre les deux pas de modèle qui l'encadrent.

Servez-vous-en pour un affichage « en ce moment ». Pour tout ce que vous comparerez dans le temps, utilisez /v1/forecast et lisez l'heure voulue : la série est stable, alors que maintenant bouge sous vos pieds entre deux appels.

Référence des champs#

Champs horaires

21 d'entre eux reviennent par défaut. Les autres sont à vous pour peu que vous les demandiez — nommez-les dans hourly=, séparés par des virgules — et ils sont retenus pour une question de coût, non de fiabilité : chaque champ stocké est une lecture compressée distincte, si bien qu'une réponse par défaut qui porterait les 45 ferait payer tous les appelants pour les quelques-uns qui veulent la hauteur de neige.

GET /v1/forecast?lat=45.19&lon=5.72&hourly=temperature_2m,snow_line_altitude,soil_temperature_8cm

Un champ qu'un modèle ne publie pas revient à null sur la portion de prévision de ce modèle, plutôt que de disparaître de la réponse — de sorte qu'un enchaînement qui commence sur AROME et continue sur ICON-EU renvoie visibility d'un bout à l'autre, à null pendant les 51 premières heures. Un nom de champ inconnu donne un 400 unknown_field, avec la correspondance la plus proche suggérée ; il était auparavant ignoré en silence.

Champs quotidiens

date, temperature_2m_max, temperature_2m_min, temperature_2m_mean, precipitation_sum, wind_speed_max, wind_gust_max, shortwave_radiation_sum (MJ/m²), uv_index_max, sunrise, sunset, daylight_hours, weather_code.

Agrégés sur des journées civiles locales, pas UTC. Une journée partielle à l'une ou l'autre extrémité de la plage est omise plutôt que rapportée avec un maximum trompeur — une demande de 7 jours peut donc légitimement renvoyer 6 lignes quotidiennes.

Modèles et résolution#

Nous servons le modèle le plus fin qui couvre à la fois votre point et votre échéance. Vous n'en choisissez jamais un ; le choix est rapporté dans source.model, si bien que vous pouvez toujours savoir lequel a répondu.

Les modèles à haute résolution sont tous à courte échéance — à 1 km l'atmosphère devient chaotique en moins de deux jours, prévoir plus loin n'aurait donc aucun sens — et la résolution baisse par paliers à mesure que la prévision avance :

jour 0 ────── jour 2 ────── jour 5 ───────────────── jour 15
  AROME 1,3 km (France)
  ICON-D2 2,2 km (Allemagne, Alpes, Benelux)
  HRRR 3 km (États-Unis et sud du Canada)
              ICON-EU 6,5 km (Europe)
                          ICON 13 km · ECMWF 28 km (mondial)
                                              AIFS (tendance seule)

Les transitions au bord du domaine d'un modèle sont fondues, de sorte que deux villes de part et d'autre d'une frontière ne divergent jamais par un saut brutal.

/v1/models ne demande aucune clé, ce qui en fait l'endpoint à interroger depuis une page d'état ou avant d'acheter : il rapporte le dernier run de chaque modèle et son âge, si bien que « la donnée est-elle fraîche » se répond sans dépenser un crédit.

Probabilités d'ensemble#

Une prévision unique dit 22 °C jeudi. C'est une supposition présentée comme un fait. Cet endpoint répond à la question sur laquelle vous décidez réellement : à quel point est-ce sûr, et quelle est la probabilité de pluie qui mérite qu'on s'organise autour.

Il est calculé depuis l'ensemble de l'ECMWF — le même modèle lancé 50 fois depuis des conditions initiales légèrement différentes. Là où les runs s'accordent, la prévision est sûre. Là où ils se dispersent, c'est l'atmosphère elle-même qui est incertaine, et aucun modèle si bon soit-il ne peut vous en dire davantage.

{
  "members": 50,
  "hourly": {
    "time": ["2026-08-01T00:00:00+00:00"],
    "temperature_2m_p10": [26.4],
    "temperature_2m_p50": [26.78],
    "temperature_2m_p90": [27.3],
    "temperature_2m_spread": [0.4],
    "precipitation_probability_0_1mm": [10.0],
    "precipitation_probability_1_0mm": [0.0],
    "precipitation_probability_5_0mm": [0.0],
    "precipitation_probability_10_0mm": [0.0],
    "precipitation_p90": [0.1]
  }
}

Comment le lire

p10 et p90 encadrent les 80 % centraux des membres : un sur dix s'attend à plus froid que p10, un sur dix à plus chaud que p90. Un spread de 0,4 °C est une situation établie à laquelle vous pouvez vous fier ; 3 °C signifie que les modèles divergent, et il vaut mieux le dire à vos utilisateurs que d'en choisir un.

Les seuils de pluie sont des décisions plutôt que des chiffres ronds — 0,1 mm c'est mouillé, tout court, 1 mm c'est prenez un manteau, 5 et 10 mm c'est ça devient un problème. precipitation_p90 est le mauvais cas : un membre sur dix seulement est plus arrosé.

Qualité de l'air#

C'est l'endpoint qui compte le plus en Afrique du Nord et sur le pourtour méditerranéen. Un épisode de poussière pousse les PM10 au-delà de mille microgrammes par mètre cube plusieurs jours d'affilée, ce qui relève d'une décision de santé plutôt que d'un chiffre, et c'est mal couvert par les services grand public gratuits.

{
  "current": {
    "pm2_5": 38.7,
    "band": "poor",
    "who_guidelines_ug_m3": {"pm2_5": 15.0, "pm10": 45.0,
                             "nitrogen_dioxide": 25.0, "ozone": 100.0}
  },
  "hourly": {
    "time": ["2026-08-01T00:00:00+00:00"],
    "pm2_5": [38.7], "pm10": [85.8], "ozone": [43.4],
    "nitrogen_dioxide": [19.0], "dust_aod_550nm": [0.24]
  },
  "units": {"pm2_5": "ug/m3", "pm10": "ug/m3", "dust_aod_550nm": "1"}
}

Toutes les concentrations sont en µg/m³, l'unité dans laquelle la qualité de l'air se cite partout. dust_aod_550nm est une épaisseur optique et n'a pas d'unité : au-delà de 0,5 environ le ciel est visiblement voilé, au-delà de 1,0 le soleil est atténué.

Les valeurs guides court terme de l'OMS voyagent dans chaque réponse, de sorte qu'un chiffre peut être situé sans aller le chercher ailleurs. band suit l'indice européen de qualité de l'air pour les PM2,5 : bon, correct, moyen, mauvais, très mauvais, extrêmement mauvais.

La neige et la limite pluie-neige#

Quatre champs, et ils répondent à des questions différentes. snowfall, c'est ce qui tombe ; les autres décrivent ce qui est au sol, et où.

Demandez-les nommément — ils ne sont pas dans la réponse par défaut :

GET /v1/forecast?lat=45.19&lon=5.72&hourly=snowfall,snow_depth,snow_water_equivalent,snow_line_altitude,freezing_level_altitude

C'est la limite pluie-neige qui mérite d'être lue. « Il pleut à 800 m et il neige à 1 200 » est une information sur laquelle une station de ski, un gestionnaire de route ou un conducteur peut agir ; « 3 mm de précipitations » ne l'est pas. Cela compte aussi en Afrique du Nord — l'Atlas a des domaines skiables à Chréa et Tikjda, et les hauts plateaux de Sétif, Batna et Djelfa dépassent 1 000 m.

Ces champs viennent d'ICON, de la DWD, qui couvre le monde à 13 km. Les données ouvertes de l'ECMWF publient la hauteur de neige mais pas la limite pluie-neige : c'est donc un cas où le modèle le plus grossier est le plus utile. snow_line_altitude est un produit régional — ICON-EU et ICON-D2 le publient, ICON global non, si bien qu'en dehors de l'Europe vous obtenez l'isotherme et la hauteur, mais pas la limite elle-même.

Mer — état de la mer#

{
  "hourly": {
    "time": ["2026-08-01T00:00:00+00:00"],
    "wave_height": [0.32],
    "wave_direction": [264.3],
    "wave_period": [3.79],
    "wave_peak_period": [4.21]
  }
}

La hauteur de vague est la hauteur significative — la moyenne du tiers des vagues les plus hautes, ce qui correspond à peu près à ce que rapporte un observateur en mer. Les vagues individuelles atteignent environ le double, et c'est ce chiffre-là qui compte si vous décidez de sortir ou non. La direction est celle d'où viennent les vagues, comme pour le vent.

Rivières#

Cet endpoint répond à ce qu'aucun modèle météo ne peut donner : non pas combien de pluie tombe en amont, mais combien d'eau arrive ici — un tout autre chiffre, séparé de la pluie par un bassin versant, un état d'humidité du sol et un jour ou deux de temps de trajet.

{
  "disclaimer": "Information only. Only national and regional authorities
                 are authorised to issue flood warnings.",
  "daily": {
    "time": ["2026-08-01T00:00:00+00:00"],
    "river_discharge": [4.953],
    "soil_wetness_index": [0.448]
  }
}