🇨🇵 API Bulletin Avalanche (FR)

🇨🇵 API Bulletin Avalanche (FR)

Jun 12, 2025

 

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 =5 j 

  • Temps réel = oui

  • Archive = non

  • Granularité d'accès = produits unitaires du bulletin d'avalanche

  • Domaine = France métropole

  • Fréquence d'actualisation = quotidienne a minima durant la saison couverte

  • Synchrone/asynchrone = synchrone

  • Limitation(s) : seuls les produits les plus récents sont disponibles

Fonctionnement de l'API :

Cette API donne accès au Bulletin d'estimation du Risque d'Avalanche (BRA) temps réel, pour sa version la plus récente.

  1. télécharger la liste des massifs couverts

  2. télécharger le produit le plus récent ("en cours") de chacun des fichiers du Bulletin d'estimation du Risque d'Avalanche

Erreurs courantes :

  • erreur 404 message "no matching blob" lors de l'accès unitaire : le Bulletin Avalanche étant saisonnier, le jeu de données est indisponible hors saison.

Cas d'usage :

En mode développement : je cherche à afficher le niveau de risque du massif "Haute-Bigorre" dans les Pyrénées pour les jours J+1 et la tendance pour J+2, ainsi que la rose des pentes et l'enneigement.

  1. télécharger la liste des massifs avec le web service /liste-massifs
    Requête de téléchargement de la liste des massifs :

    curl -X 'GET' 'https://public-api.meteofrance.fr/public/DPBRA/v1/liste-massifs' -H 'accept: */*' -H 'Authorization: Bearer <votre_token_oauth2_ici>"

     

    Liste des massifs :

    { "type": "FeatureCollection", "name": "Metadata_massif_DP_2024", "crs": { "type": "name", "properties": { "name": "urn:ogc:def:crs:OGC:1.3:CRS84" } }, "features": [ ... { "type": "Feature", "properties": { "code": 66, "mountain": "Pyrenees", "title": "Haute-Bigorre", "title_shor": "H-Big", "lon_center": 0.01979, "lat_center": 42.89645, "Departemen": "Hautes-Pyrenees", "Dep2": null }, "geometry": { "type": "MultiPolygon", "coordinates": [ [ [ [ -0.31343, 42.8494 ], [ -0.31145, 42.85251 ], ... [ -0.30506, 42.84132 ], [ -0.31343, 42.8494 ] ] ] ] } }, ... ] }

     

    • identifier le massif dont title="Haute-Bigorre" => id-massif=66

       

    • télécharger les estimations pour les jours J+1 et J+2 pour le massif 66 avec le web service /massif/BRA au format XML
      Requête du bulletin d'avalanche :

      curl -X 'GET' 'https://public-api.meteofrance.fr/public/DPBRA/v1/massif/BRA?id-massif=66&format=xml' -H 'accept: */*' -H 'Authorization: Bearer <votre_token_oauth2_ici>"

      Bulletin avalanche du 02/12/2024 :

      <?xml version="1.0" encoding="UTF-8" standalone="yes" ?> <?xml-stylesheet type="text/xsl" href="../web/bra.xslt"?> <BULLETINS_NEIGE_AVALANCHE xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" TYPEBULLETIN="BRA" ID="66" MASSIF="Haute-Bigorre" DATEBULLETIN="2024-12-02T15:00:00" DATEECHEANCE="2024-12-03T18:00:00" DATEVALIDITE="2024-12-03T18:00:00" DATEDIFFUSION="2024-12-02T15:17:00" AMENDEMENT="false"> <DateValidite>2024-12-03T18:00:00</DateValidite> <CARTOUCHERISQUE> <RISQUE RISQUE1="1" EVOLURISQUE1="" LOC1="" ALTITUDE="" RISQUE2="" EVOLURISQUE2="" LOC2="" RISQUEMAXI="1" COMMENTAIRE="Indice de risque faible." RISQUEMAXIJ2="2" DATE_RISQUE_J2="2024-12-04T00:00:00"/> <PENTE NE="true" E="false" SE="false" S="false" SW="false" W="false" NW="false" N="true" COMMENTAIRE="Rares, en altitude"/> <ACCIDENTEL><![CDATA[Fine couche de neige fraîche sur quelques plaques anciennes durcies. ]]></ACCIDENTEL> <NATUREL><![CDATA[Faibles coulées possibles.]]></NATUREL> <RESUME><![CDATA[Départs spontanés : Faibles coulées possibles. Déclenchements skieurs : Fine couche de neige fraîche sur quelques plaques anciennes durcies. ]]></RESUME> <RisqueJ2><![CDATA[Indice de risque limité]]></RisqueJ2> <CommentaireRisqueJ2><![CDATA[Des apports nouveaux avec du vent de nord pouvant créer des plaques sensibles.]]></CommentaireRisqueJ2> <AVIS/> <VIGILANCE/> <ImageRisque>montagne_risques_66.png</ImageRisque> <ImagePente>rose_pentes_66.png</ImagePente> </CARTOUCHERISQUE> ... </BULLETINS_NEIGE_AVALANCHE>

       

      • identifier les risques :

        • pour J+1 :  

          • DATEVALIDITE="2024-12-03T18:00:00"
            RISQUEMAXI="1"

        • pour J+2 :

          • DATE_RISQUE_J2="2024-12-04T00:00:00"

          • RISQUEMAXIJ2="2"

    • télécharger les fichiers illustratifs du Bulletin d'avalanche : rose des vents et enneigement pour le massif 66 au format PNG
      Requêtes de téléchargement des fichiers images du flux du bulletin :

      curl -X 'GET' 'https://public-api.meteofrance.fr/public/DPBRA/v1/massif/image/rose-pentes?id-massif=66' -H 'accept: */*' -H 'Authorization: Bearer <votre_token_oauth2_ici>" curl -X 'GET' 'https://public-api.meteofrance.fr/public/DPBRA/v1/massif/image/montagne-enneigement?id-massif=66' -H 'accept: */*' -H 'Authorization: Bearer <votre_token_oauth2_ici>"
    • afficher ces informations sur son site web

       

      Pour le 3 décembre 2024, estimation des risques :

      Evolution des risques pour le 4 décembre 2024 :