Données relatives aux prévisions météorologiques

description à venir

Liste des capteurs

Emplacement des capteurs

Modèle de données

{
  "id": "WeatherForecast:METEOFR-WEATHERF-060740",
  "type": "WeatherForecast",
  "address": {
    "type": "PostalAddress",
    "value": {
      "addressCountry": "FR",
      "streetAddress": "M 373",
      "postalCode": "06450",
      "addressLocality": "Lantosque"
    }
  },
  "altitude": {
    "type": "Number",
    "value": 550
  },
  "dataProvider": {
    "type": "Text",
    "value": "Météo France"
  },
  "dateIssued": {
    "type": "DateTime",
    "value": "2023-10-03T14:00:00.000Z"
  },
  "dateModified": {
    "type": "DateTime",
    "value": "2023-10-03T14:00:51.298Z"
  },
  "dewPoint": {
    "type": "Number",
    "value": -2,
    "metadata": {
      "timestamp": {
        "type": "DateTime",
        "value": "2023-10-03T14:00:00.000Z"
      },
      "unitCode": {
        "type": "Text",
        "value": "CEL"
      }
    }
  },
  "gustWindSpeed": {
    "type": "Number",
    "value": 0,
    "metadata": {
      "timestamp": {
        "type": "DateTime",
        "value": "2023-10-03T14:00:00.000Z"
      },
      "unitCode": {
        "type": "Text",
        "value": "MTS"
      }
    }
  },
  "location": {
    "type": "geo:json",
    "value": {
      "coordinates": [
        7.306944,
        43.971944
      ],
      "type": "Point"
    }
  },
  "name": {
    "type": "Text",
    "value": "Station météorologique Lantosque"
  },
  "nebulosity": {
    "type": "Text",
    "value": "Ensoleillé / Nuit claire",
    "metadata": {
      "timestamp": {
        "type": "DateTime",
        "value": "2023-10-03T14:00:00.000Z"
      }
    }
  },
  "nebulosityCode": {
    "type": "Number",
    "value": 0,
    "metadata": {
      "timestamp": {
        "type": "DateTime",
        "value": "2023-10-03T14:00:00.000Z"
      }
    }
  },
  "nebulosityImage": {
    "type": "Text",
    "value": "https://api.nicecotedazur.org/nca/weather/forecast/ressources/nca/weather/forecast/meteofr/nebulosity0.png",
    "metadata": {
      "timestamp": {
        "type": "DateTime",
        "value": "2023-10-03T14:00:00.000Z"
      }
    }
  },
  "precipitation": {
    "type": "Number",
    "value": 0,
    "metadata": {
      "timestamp": {
        "type": "DateTime",
        "value": "2023-10-03T14:00:00.000Z"
      },
      "unitCode": {
        "type": "Text",
        "value": "MMT"
      }
    }
  },
  "precipitation24h": {
    "type": "Number",
    "value": 0,
    "metadata": {
      "timestamp": {
        "type": "DateTime",
        "value": "2023-10-03T14:00:00.000Z"
      },
      "unitCode": {
        "type": "Text",
        "value": "MMT"
      }
    }
  },
  "precipitation3h": {
    "type": "Number",
    "value": 0,
    "metadata": {
      "timestamp": {
        "type": "DateTime",
        "value": "2023-10-03T14:00:00.000Z"
      },
      "unitCode": {
        "type": "Text",
        "value": "MMT"
      }
    }
  },
  "refDevice": {
    "type": "Text",
    "value": "Device:METEOFR-WEATHERF-060740"
  },
  "relativeHumidity": {
    "type": "Number",
    "value": 0.35,
    "metadata": {
      "timestamp": {
        "type": "DateTime",
        "value": "2023-10-03T14:00:00.000Z"
      },
      "unitCode": {
        "type": "Text",
        "value": "P1"
      }
    }
  },
  "relativeHumidityMax": {
    "type": "Number",
    "value": 0.8,
    "metadata": {
      "timestamp": {
        "type": "DateTime",
        "value": "2023-10-03T14:00:00.000Z"
      },
      "unitCode": {
        "type": "Text",
        "value": "P1"
      }
    }
  },
  "relativeHumidityMin": {
    "type": "Number",
    "value": 0.3,
    "metadata": {
      "timestamp": {
        "type": "DateTime",
        "value": "2023-10-03T14:00:00.000Z"
      },
      "unitCode": {
        "type": "Text",
        "value": "P1"
      }
    }
  },
  "roadTemperature": {
    "type": "Number",
    "value": 14,
    "metadata": {
      "timestamp": {
        "type": "DateTime",
        "value": "2023-10-03T14:00:00.000Z"
      },
      "unitCode": {
        "type": "Text",
        "value": "CEL"
      }
    }
  },
  "snowfallLimit": {
    "type": "Number",
    "value": 0,
    "metadata": {
      "timestamp": {
        "type": "DateTime",
        "value": "2023-10-03T14:00:00.000Z"
      },
      "unitCode": {
        "type": "Text",
        "value": "MTR"
      }
    }
  },
  "source": {
    "type": "Text",
    "value": "Weather station"
  },
  "temperature": {
    "type": "Number",
    "value": 13,
    "metadata": {
      "timestamp": {
        "type": "DateTime",
        "value": "2023-10-03T14:00:00.000Z"
      },
      "unitCode": {
        "type": "Text",
        "value": "CEL"
      }
    }
  },
  "temperatureMax": {
    "type": "Number",
    "value": 28,
    "metadata": {
      "timestamp": {
        "type": "DateTime",
        "value": "2023-10-03T14:00:00.000Z"
      },
      "unitCode": {
        "type": "Text",
        "value": "CEL"
      }
    }
  },
  "temperatureMin": {
    "type": "Number",
    "value": 12,
    "metadata": {
      "timestamp": {
        "type": "DateTime",
        "value": "2023-10-03T14:00:00.000Z"
      },
      "unitCode": {
        "type": "Text",
        "value": "CEL"
      }
    }
  },
  "validFrom": {
    "type": "DateTime",
    "value": "2023-10-05T22:00:00.000Z"
  },
  "validTo": {
    "type": "DateTime",
    "value": "2023-10-06T22:00:00.000Z"
  },
  "validity": {
    "type": "Text",
    "value": "2023-10-05T22:00:00.000/2023-10-06T22:00:00.000"
  },
  "windDirection": {
    "type": "Number",
    "value": 30,
    "metadata": {
      "timestamp": {
        "type": "DateTime",
        "value": "2023-10-03T14:00:00.000Z"
      },
      "unitCode": {
        "type": "Text",
        "value": "DD"
      }
    }
  },
  "windDirectionImage": {
    "type": "Text",
    "value": "https://api.nicecotedazur.org/nca/weather/forecast/ressources/nca/weather/forecast/meteofr/windNNE.png",
    "metadata": {
      "timestamp": {
        "type": "DateTime",
        "value": "2023-10-03T14:00:00.000Z"
      }
    }
  },
  "windSpeed": {
    "type": "Number",
    "value": 10,
    "metadata": {
      "timestamp": {
        "type": "DateTime",
        "value": "2023-10-03T14:00:00.000Z"
      },
      "unitCode": {
        "type": "Text",
        "value": "MTS"
      }
    }
  }
}

Documentation relative à l'API

La documentation est utile aux développeurs désirant utiliser l'API fournie par la Métropole Nice Côte d'Azur.

Exemple de code

• Temps réel – Dernière valeur reçue au moment de la requête
  • Cas d'usage 1 : Renvoie les mesures de type "WeatherForecast"
  • Cas d'usage 2 : Renvoie les données d'un ID donné
  • Cas d'usage 3 : Renvoie les valeurs des attributs passés en paramètre pour un ID donné
• Historique
  • Cas d'usage 4 : Renvoie une liste de valeurs horodatées d'un attribut passé en paramètre pour un ID donné

Curl

• Temps réel - Cas d'usage 1 : Renvoie les mesures de type "WeatherForecast"

curl -X GET "https://api.nicecotedazur.org/nca/weather/forecast/?idPattern=^WeatherForecast:METEOFR-WEATHERF&api_key=API_KEY"

• Temps réel - Cas d'usage 2 : Renvoie les données d'un ID donné

curl -X GET "https://api.nicecotedazur.org/nca/weather/forecast/WeatherForecast:METEOFR-WEATHERF-060740?api_key=API_KEY"

• Temps réel - Cas d'usage 3 : Renvoie les valeurs des attributs passés en paramètre pour un ID donné

curl -X GET "https://api.nicecotedazur.org/nca/weather/forecast/WeatherForecast:METEOFR-WEATHERF-060740?attrs=temperature&api_key=API_KEY"

• Historique - Cas d'usage 4 : Renvoie une liste de valeurs horodatées d'un attribut passé en paramètre pour un ID donné

curl -X GET "https://api.nicecotedazur.org/nca/weather/forecast/histo/WeatherForecast:METEOFR-WEATHERF-060740?attrs=temperature&fromDate=2023-07-01T09:00:00&toDate=2023-07-31T09:00:00&api_key=API_KEY"

Java

• Temps réel - Cas d'usage 1 : Renvoie les mesures de type "WeatherForecast"

import java.io.IOException;
import java.net.URI;
import java.net.URLEncoder;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.http.HttpResponse.BodyHandlers;
 
public class case1 {
 
    public static void main(String[] args) throws IOException, InterruptedException {
        String urlencode = "https://api.nicecotedazur.org/nca/weather/forecast/?idPattern=^WeatherForecast:METEOFR-WEATHERF&api_key=API_KEY";
        HttpRequest request = HttpRequest.newBuilder()
                .version(HttpClient.Version.HTTP_2)
                .uri(URI.create(
                        urlencode))
                .GET()
                .build();
                
        HttpClient client = HttpClient.newHttpClient();
        HttpResponse response = client.send(request, BodyHandlers.ofString());
 
        System.out.println(response.body());
    }
}

• Temps réel - Cas d'usage 2 : Renvoie les données d'un ID donné

import java.io.IOException;
import java.net.URI;
import java.net.URLEncoder;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.http.HttpResponse.BodyHandlers;
 
public class case2 {
 
    public static void main(String[] args) throws IOException, InterruptedException {
        String urlencode = "https://api.nicecotedazur.org/nca/weather/forecast/WeatherForecast:METEOFR-WEATHERF-060740?api_key=API_KEY";
        HttpRequest request = HttpRequest.newBuilder()
                .version(HttpClient.Version.HTTP_2)
                .uri(URI.create(
                        urlencode))
                .GET()
                .build();
                
        HttpClient client = HttpClient.newHttpClient();
        HttpResponse response = client.send(request, BodyHandlers.ofString());
 
        System.out.println(response.body());
    }
}

• Temps réel - Cas d'usage 3 : Renvoie les valeurs des attributs passés en paramètre pour un ID donné

import java.io.IOException;
import java.net.URI;
import java.net.URLEncoder;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.http.HttpResponse.BodyHandlers;
 
public class case3 {
 
    public static void main(String[] args) throws IOException, InterruptedException {
        String urlencode = "https://api.nicecotedazur.org/nca/weather/forecast/WeatherForecast:METEOFR-WEATHERF-060740?attrs=temperature&api_key=API_KEY";
        HttpRequest request = HttpRequest.newBuilder()
                .version(HttpClient.Version.HTTP_2)
                .uri(URI.create(
                        urlencode))
                .GET()
                .build();
                
        HttpClient client = HttpClient.newHttpClient();
        HttpResponse response = client.send(request, BodyHandlers.ofString());
 
        System.out.println(response.body());
    }
}

• Historique - Cas d'usage 4 : Renvoie une liste de valeurs horodatées d'un attribut passé en paramètre pour un ID donné

import java.io.IOException;
import java.net.URI;
import java.net.URLEncoder;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.http.HttpResponse.BodyHandlers;
 
public class case4 {
 
    public static void main(String[] args) throws IOException, InterruptedException {
        String urlencode = "https://api.nicecotedazur.org/nca/weather/forecast/histo/WeatherForecast:METEOFR-WEATHERF-060740?attrs=temperature&fromDate=2023-07-01T09:00:00&toDate=2023-07-31T09:00:00&api_key=API_KEY";
        HttpRequest request = HttpRequest.newBuilder()
                .version(HttpClient.Version.HTTP_2)
                .uri(URI.create(
                        urlencode))
                .GET()
                .build();
                
        HttpClient client = HttpClient.newHttpClient();
        HttpResponse response = client.send(request, BodyHandlers.ofString());
 
        System.out.println(response.body());
    }
}

Javascript

• Temps réel - Cas d'usage 1 : Renvoie les mesures de type "WeatherForecast"

const url = "https://api.nicecotedazur.org/nca/weather/forecast/"
 
const params = {
    idPattern: '^WeatherForecast:METEOFR-WEATHERF',
    api_key: 'API_KEY'
}
const searchParams = new URLSearchParams(params)
 
var requestOptions = {
    method: 'GET',
    redirect: 'follow'
};
fetch(url + '?' + searchParams, requestOptions)
    .then(response => response.text())
    .then(result => console.log(result))
    .catch(error => console.log('error', error));

• Temps réel - Cas d'usage 2 : Renvoie les données d'un ID donné

const url = "https://api.nicecotedazur.org/nca/weather/forecast/WeatherForecast:METEOFR-WEATHERF-060740"
 
const params = {
    api_key: 'API_KEY'
}
const searchParams = new URLSearchParams(params)
 
var requestOptions = {
    method: 'GET',
    redirect: 'follow'
};
fetch(url + '?' + searchParams, requestOptions)
    .then(response => response.text())
    .then(result => console.log(result))
    .catch(error => console.log('error', error));

• Temps réel - Cas d'usage 3 : Renvoie les valeurs des attributs passés en paramètre pour un ID donné

const url = "https://api.nicecotedazur.org/nca/weather/forecast/WeatherForecast:METEOFR-WEATHERF-060740"
 
const params = {
    attrs: 'temperature',
    api_key: 'API_KEY'
}
const searchParams = new URLSearchParams(params)
 
var requestOptions = {
    method: 'GET',
    redirect: 'follow'
};
fetch(url + '?' + searchParams, requestOptions)
    .then(response => response.text())
    .then(result => console.log(result))
    .catch(error => console.log('error', error));

• Historique - Cas d'usage 4 : Renvoie une liste de valeurs horodatées d'un attribut passé en paramètre pour un ID donné

const url = "https://api.nicecotedazur.org/nca/weather/forecast/histo/WeatherForecast:METEOFR-WEATHERF-060740"
 
const params = {
    attrs: 'temperature',
    fromDate: '2023-07-01T09:00:00',
    toDate: '2023-07-31T09:00:00',
    api_key: 'API_KEY'
}
const searchParams = new URLSearchParams(params)
 
var requestOptions = {
    method: 'GET',
    redirect: 'follow'
};
fetch(url + '?' + searchParams, requestOptions)
    .then(response => response.text())
    .then(result => console.log(result))
    .catch(error => console.log('error', error));

Python

• Temps réel - Cas d'usage 1 : Renvoie les mesures de type "WeatherForecast"

import requests
import urllib.parse
 
url = "https://api.nicecotedazur.org/nca/weather/forecast/"
searchParams = {
  'idPattern': "^WeatherForecast:METEOFR-WEATHERF",
  'api_key': 'API_KEY'
}
 
response = requests.request("GET", url, params=searchParams)
 
print(response.text)

• Temps réel - Cas d'usage 2 : Renvoie les données d'un ID donné

import requests
import urllib.parse
 
url = "https://api.nicecotedazur.org/nca/weather/forecast/WeatherForecast:METEOFR-WEATHERF-060740"
searchParams = {
  'api_key': 'API_KEY'
}
 
response = requests.request("GET", url, params=searchParams)
 
print(response.text)

• Temps réel - Cas d'usage 3 : Renvoie les valeurs des attributs passés en paramètre pour un ID donné

import requests
import urllib.parse
 
url = "https://api.nicecotedazur.org/nca/weather/forecast/WeatherForecast:METEOFR-WEATHERF-060740"
searchParams = {
  'attrs': 'temperature',
  'api_key': 'API_KEY'
}
 
response = requests.request("GET", url, params=searchParams)
 
print(response.text)

• Historique - Cas d'usage 4 : Renvoie une liste de valeurs horodatées d'un attribut passé en paramètre pour un ID donné

import requests
import urllib.parse
 
url = "https://api.nicecotedazur.org/nca/weather/forecast/histo/WeatherForecast:METEOFR-WEATHERF-060740"
searchParams = {
  'attrs': 'temperature',
  'fromDate': '2023-07-01T09:00:00',
  'toDate': '2023-07-31T09:00:00',
  'api_key': 'API_KEY'
}
 
response = requests.request("GET", url, params=searchParams)
 
print(response.text)

C#

• Temps réel - Cas d'usage 1 : Renvoie les mesures de type "WeatherForecast"

using System;
using System.Net;
using static System.Web.HttpUtility;
 
namespace Case1
{
    class Program
    {
        static async Task Main(string[] args)
        {
            string URL = "https://api.nicecotedazur.org/nca/weather/forecast/";
 
            using var client = new HttpClient();
            var builder = new UriBuilder(URL)
            {
               Query = "idPattern=^WeatherForecast:METEOFR-WEATHERF&api_key=API_KEY"
            }
            var url = builder.ToString();
 
            var res = await client.GetAsync(url);
 
            var content = await res.Content.ReadAsStringAsync();
            Console.WriteLine(content);
        }
    }
}

• Temps réel - Cas d'usage 2 : Renvoie les données d'un ID donné

using System;
using System.Net;
using static System.Web.HttpUtility;
 
namespace Case2
{
    class Program
    {
        static async Task Main(string[] args)
        {
            string URL = "https://api.nicecotedazur.org/nca/weather/forecast/WeatherForecast:METEOFR-WEATHERF-060740";
 
            using var client = new HttpClient();
            var builder = new UriBuilder(URL)
            {
               Query = "api_key=API_KEY"
            }
            var url = builder.ToString();
 
            var res = await client.GetAsync(url);
 
            var content = await res.Content.ReadAsStringAsync();
            Console.WriteLine(content);
        }
    }
}

• Temps réel - Cas d'usage 3 : Renvoie les valeurs des attributs passés en paramètre pour un ID donné

using System;
using System.Net;
using static System.Web.HttpUtility;
 
namespace Case3
{
    class Program
    {
        static async Task Main(string[] args)
        {
            string URL = "https://api.nicecotedazur.org/nca/weather/forecast/WeatherForecast:METEOFR-WEATHERF-060740";
 
            using var client = new HttpClient();
            var builder = new UriBuilder(URL)
            {
               Query = "attrs=temperature&api_key=API_KEY"
            }
            var url = builder.ToString();
 
            var res = await client.GetAsync(url);
 
            var content = await res.Content.ReadAsStringAsync();
            Console.WriteLine(content);
        }
    }
}

• Historique - Cas d'usage 4 : Renvoie une liste de valeurs horodatées d'un attribut passé en paramètre pour un ID donné

using System;
using System.Net;
using static System.Web.HttpUtility;
 
namespace Case4
{
    class Program
    {
        static async Task Main(string[] args)
        {
            string URL = "https://api.nicecotedazur.org/nca/weather/forecast/histo/WeatherForecast:METEOFR-WEATHERF-060740";
 
            using var client = new HttpClient();
            var builder = new UriBuilder(URL)
            {
               Query = "attrs=temperature&fromDate=2023-07-01T09:00:00&toDate=2023-07-31T09:00:00&api_key=API_KEY"
            }
            var url = builder.ToString();
 
            var res = await client.GetAsync(url);
 
            var content = await res.Content.ReadAsStringAsync();
            Console.WriteLine(content);
        }
    }
}