Logo Association Nice Météo 06

API Météo 06



Documentation API HTTP

L'API proposée par l'association Nice Météo 06 nécessite une clé d'API (key). Celle-ci est attribuée sur demande et selon certaines conditions. Cette API permet de récupérer en temps réel les données des stations hébergées par l'association à certains de ses partenaires.

Métadonnées des stations

Les métadonnées des stations sont disponibles via l'API. Deux paramètres sont obligatoires, à ajouter à l'URL de base :
https://api.meteo06.fr/v1/request-stations-list.php

  • Le paramètre type_file pour spécifier le type de sortie souhaité (format). Il peut être égal à json ou csv.
  • Le paramètre type pour spécifier si l'on veut les métadonnées de toutes les stations, ou seulement les stations autorisées. Il peut être égal à all ou authorized ou unauthorized.

Sont disponibles, dans l'ordre, les informations suivantes :

  • station_id ID de la station
  • station_name Nom de la station
  • url_site URL du site Internet de la station
  • commune Commune d'implantation
  • station_install_date Date d'installation
  • station_model Modèle de station
  • station_altitude Altitude
  • coord_lat Latitude
  • coord_long Longitude
  • station_position Position de la station (sur toiture, champ, crête, etc.)
  • station_exposure Exposition de la station (Points cardinaux, sommet d'une montagne, etc.)
  • station_precautions Précautions particulières (commentaires de l'association sur la qualité du site)
  • pdf_full_metadata URL vers le PDF des métadonnées complètes (photos, maintenances, etc.)
  • export_api Autorisation ou non de diffusion des données de la station via la présente API
  • source Source originale des données (à citer obligatoirement si réutilisation des données)

Ci-dessous un exemple pour récupérer les métadonnées de toutes les stations du réseau, au format JSON :
https://api.meteo06.fr/v1/request-stations-list.php?type_file=json&type=all

Données météo "temps-réel"

De la même manière, les données brutes des stations météo sont disponible en spécifiant un certain nombre de paramètres à l'URL de base :
https://api.meteo06.fr/v1/request-data-live.php

  • Le paramètre key qui attend la clé d'authentification fournie par l'association.
  • Le paramètre type_file pour spécifier le type de sortie souhaité (format). Il peut être égal à json ou csv.
  • Le paramètre station_id pour spécifier l'identifiant (4 caractères en majuscule) de la station souhaitée. Exemple pour la station de Nice-Pessicart : NICP. Cet identifiant est indiqué dans l'API des métadonnées pour chaque station.
  • Le paramètre period pour spécifier la période de récupération souhaitée. Ce nombre est en seconde et doit se situer entre 120 (2 min) et 172800 (48h).
Ci-dessous un exemple pour récupérer les données de la station de Nice-Pessicart, au format CSV, sur les 10 dernières minutes :
https://api.meteo06.fr/v1/request-data-live.php?key=my-key&type_file=csv&station_id=NICP&period=600

Données météo "archives"

Les données d'archives sont disponibles en spécifiant un certain nombre de paramètres à l'URL de base :
https://api.meteo06.fr/v1/request-data-archives.php

  • Le paramètre key qui attend la clé d'authentification fournie par l'association.
  • Le paramètre type_file pour spécifier le type de sortie souhaité (format). Il peut être égal à json ou csv.
  • Le paramètre station_id pour spécifier l'identifiant (4 caractères en majuscule) de la station souhaitée. Exemple pour la station de Nice-Pessicart : NICP. Cet identifiant est indiqué dans l'API des métadonnées pour chaque station.
  • Le paramètre time_step pour spécifier le pas de temps souhaité. Pour le moment, seul le pas de temps d'une heure est supporté (1h).
  • Le paramètre date_start pour spécifier la date de début (incluse) des données souhaitées, en UTC, au format YYYY-MM-DDTHH (exemple : 2021-01-01T06 pour le 1er janvier 2021 à 6h UTC)
  • Le paramètre date_end pour spécifier la date de fin (incluse) des données souhaitées, en UTC, au format YYYY-MM-DDTHH (exemple : 2021-02-01T06 pour le 1er février 2021 à 6h UTC)
date_start est obligatoire, mais date_end de l'est pas.
Si date_end n'est pas précisée, il est automatiquement retourné les données sur les 31 jours suivant date_start.
Si date_end est spécifiée, la période entre date_start et date_end ne peut dépasser 3 mois.

Ci-dessous un exemple pour récupérer les données horaires de la station de Nice-Pessicart, au format CSV, sur le mois de janvier 2021 :
https://api.meteo06.fr/v1/request-data-archives.php?key=my-key&type_file=csv&station_id=NICP&time_step=1h&date_start=2021-01-01T06&date_end=2021-02-01T06

Pour le pas de temps une heure :

  • Les données sont agrégées chaque heure fixe (ex : hh:00). Dans le fichier CSV, les paramètres instantanés, tels que la température, l'humidité ou encore le taux de réception sont ceux de l'heure fixe (hh:00).
    Mais les valeurs minimales et maximales sur l'intervalle de l'heure sont aussi ajoutées dans le fichier CSV (ex : la température minimale et la température maximale sont ajoutées sous forme de deux colonnes supplémentaires, outTempMin et outTempMax).
  • Un paramètre comme la pluie est cumulé sur l'intervalle de l'heure
  • Un paramètre comme la rafale de vent fait apparaitre la rafale maximale sur l'heure, accompagnée de sa direction, et l'heure à laquelle elle s'est produite.
Ainsi, pour la température, l'enregistrement de 15h00 contiendra la température à 15h exact, ainsi que les valeurs min et max sur l'heure précédente, c'est-à-dire de 14h01 INCLUS à 15h00 INCLUS, et le cumul de précipitations entre 14h01 et 15h00 INCLUS.

Le système d'unité utilisé est le système métrique. Les températures sont donc en degrés Celsius (°C), les précipitations en millimètres (mm), etc.