Jun 12, 2025 mise à jour le Oct 1, 2025

Pour vous informer sur le descriptif des produits de l'API, veuillez vous rendre sur la description des données radar.

Pré-requis : avoir consulté l'aide d'utilisation des API du portail de Météo-France

Caractéristiques principales de cette API

• Durée de rétention (profondeur) des données = 20h

• Temps réel = oui

• Archive = non

• Granularité d'accès = donnée radar composite ou donnée d'un site radar individuel

• Domaine = France métropole et Outre-mer

• Fréquence d'actualisation =

  • liste des stations d'observation ~= annuel

  • mosaïques = toutes les 5 minutes

  • données des radars individuels = toutes les 5 minutes

• Synchrone/asynchrone = synchrone

• Limitation(s) = seul le produit le plus récent est disponible

Fonctionnement de l'API

Cette API au standard RESTful donne accès au catalogue et aux données radar temps réel des stations radar de Météo-France en cours de fonctionnement.

L’API permet d’accéder à deux ressources radars spécifiques :

• données individuelles pour chaque site radar. Le réseau radar de Météo-France se compose de plus d’une trentaine de points de mesure radar en métropole et de 6 stations radars sur l’Outre-Mer. Les données de chaque tour d’antenne de ces instruments peuvent ainsi être récupérées via l’API, que ce soit les données multipolarisées (PAM) ou les données polaires de réflectivité brute sur 80 niveaux, sigma et vitesse radiale (PAG). Les données de réflectivité individuelle sont également disponibles.

• données composites sur des territoires géographiques étendus. Toutes les données radar individuelles sont assemblées et traitées dans des produits mosaïques qui couvrent l’ensemble de la France, en métropole et sur l’Outre-Mer. Il est possible d’effectuer des requêtes sur les données de réflectivité ou de cumuls de lames d’eau 5 minutes.

Ces différents produits radars ont généralement une résolution spatiale de 1000 mètres et sont disponibles au format standard BUFR. L'utilisation du BUFR nécessite des outils spécifiques (par exemple, ceux du programme OPERA d'EUMETNET) ainsi que les tables locales (fichier "Tables des descripteurs BUFR") disponibles sur la page “Documentation du contenu des données radars”.

Il est également possible de retrouver les données mosaïques de lames d’eau à la résolution 500 mètres et au format standard HDF5.

1. Pour les données mosaïques radars

   1. Consulter le catalogue des données radars disponibles avec les web services :
      /mosaiques
/mosaiques/{zone}
/mosaiques/{zone}/observations
/mosaiques/{zone}/observations/{observation}
      NB : ce dernier web service affiche l'horodatage des produits radar dans le champ 'validity_time'

   2. Télécharger la mosaïque la plus récente d'une station radar avec le web service :
      /mosaiques/{zone}/observations/{observation}/produit

2. Pour les données des radars individuels

   1. Rechercher l'identifiant de la station radar avec le web service :
      /liste-stations : liste fixe de l’ensemble des stations radars, et de leurs tours d'antennes, sous forme d’un fichier CSV

   2. Consulter le catalogue des données radar disponibles avec les web services :
      /stations : liste dynamique simplifiée des stations radars actuellement opérationnels
      /stations/{id_station}
/stations/{id_station}/observations
/stations/{id_station}/observations/{observation}
      NB : ce dernier web service affiche l'horodatage des produits radar dans le champ 'validity_time'

   3. Télécharger la donnée la plus récente d'une station radar avec le web service :
      /stations/{id_station}/observations/{observation}/produit

Erreurs courantes 

Pour les mosaïques radars :

• 404 :

  • zone non trouvée ou mal orthographiée. Seules les valeurs de zone géographique renvoyées par le web service /mosaiques sont acceptées.

  • observation non trouvée ou mal orthographiée. Seuls les produits radars renvoyés par le web service /mosaiques/{zone}/observations sont disponibles pour une zone donnée.

• 400 : la maille spécifiée n’existe pas. Ce paramètre n’accepte que les valeurs "500" ou "1000". Ces valeurs correspondent à la résolution spatiale du produit souhaité, exprimée en mètres.

Pour les produits des radars individuels :

• 404 :

  • station radar inexistante ou mal renseignée. Pour rappel, chaque radar de Météo-France est identifié par deux chiffres. L'identifiant peut-être trouvé par une requête du web service /liste-stations/.
    Seuls les radars affichés par le web service /stations seront disponibles au téléchargement.

  • observation non trouvée ou mal orthographiée. Seuls les produits radars renvoyés par le web service /stations/{id_station}/observations sont disponibles pour un radar donné.

• 400 : tour d’antenne n’existant pas. Seuls les tours d'antennes renvoyés par le web service /stations/{id_station}/observations/{observation} sont disponibles pour un radar et un type d'observation donnés.

Cas d'usage

En mode développement, je cherche à télécharger la dernière mosaïque de lame d’eau sur la France métropolitaine à la résolution 500 mètres :

• vérification de la disponibilité du produit au travers des étapes de consultation du catalogue des produits :
  Requête la liste des zones de mosaïques disponibles :

cette commande renvoie un fichier JSON qui liste l'ensemble des produits de mosaïques actuellement disponibles au téléchargement. Cela permet de confirmer l'existence de produits sur la France métropolitaine :
liste des zones de mosaïques disponibles :

Requête de la liste des observations disponibles pour la zone METROPOLE :

cette commande renvoie un fichier JSON listant l'ensemble des produits disponibles sur la zone "METROPOLE". Cela nous confirme la disponibilité de produits de cumuls de lame d'eau pour la métropole :
liste des observations disponibles pour la zone METROPOLE :

Requête la description de l'observation mosaïque lame d'eau disponible pour la METROPOLE :

cette commande renvoie un fichier JSON qui indique qu’il existe deux produits de lames d’eau : un de résolution 1000 mètres et un de résolution 500 mètres. Le champ ‘validity_time’ permet de connaître la date et l’heure de ce produit, en heure UTC.
description de l'observation mosaïque lame d'eau disponible pour la METROPOLE :

• les différents paramètres {zone}, {observation} et {maille} me sont désormais connus et valident ma requête finale pour le téléchargement du produit :

En mode développement, je cherche à télécharger le dernier tour d’antenne du radar de Bollène :

1. la liste des radars au format CSV peut être consulté grâce à la requête : 
   Requête la liste de toutes les stations radar :

   curl -X 'GET' 'https://public-api.meteofrance.fr/public/DPRadar/v1/liste-stations' -H 'accept: */*' -H 'Authorization: Bearer <votre_token_ici>'

2. la liste dynamique au format JSON des radars opérationnels en temps réel est disponible avec : 
   Requête de la liste de tous les radars disponibles :

   curl -X 'GET' 'https://public-api.meteofrance.fr/public/DPRadar/v1/stations' -H 'accept: */*' -H 'Authorization: Bearer <votre_token_ici>'

3. la liste des produits disponibles pour la station BOLLENE est disponible avec :
   Requête de la liste des observations disponible pour la station BOLLENE :

   curl -X 'GET' 'https://public-api.meteofrance.fr/public/DPRadar/v1/stations/55/observations' -H 'accept: */*' -H 'Authorization: Bearer <votre_token_ici>'

Requête la description de l'observation PAM pour la station BOLLENE :

description de l'observation PAM pour la station BOLLENE :

4. si je souhaite donc obtenir les données multipolarisées du radar de Bollène lors de son dernier tour d’antenne, tous les paramètres me sont désormais connus : {station} = 55, {observation} = PAM et {tour_antenne} = F. Voici la requête finale : 
   Requête de téléchargement :