Logo Association Nice Météo 06

API Météo 06



Documentation API REST

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. A ce jour, les données ne sont pas encore proposées en "open-data".

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 "archive"

Soon