Données environnementales sur la qualité de l'air

La Métropole Nice Côte d'Azur

Liste des capteurs

Emplacement des capteurs

Modèle de données

{
  "id": "AirQualityObserved:AZIMUT-MULTIFLOW-GBOX001400",
  "type": "AirQualityObserved",
  "NO2": {
    "type": "Number",
    "value": 2,
    "metadata": {
      "timestamp": {
        "type": "DateTime",
        "value": "2024-06-02T19:00:00.000Z"
      },
      "unitCode": {
        "type": "Text",
        "value": "GQ"
      }
    }
  },
  "address": {
    "type": "PostalAddress",
    "value": {
      "addressCountry": "FR",
      "streetAddress": "Garage Plaza - ZOE 1 - DH-689-VT",
      "postalCode": "06000",
      "addressLocality": "Nice"
    }
  },
  "altitude": {
    "type": "Number",
    "value": 1.200000048
  },
  "dataProvider": {
    "type": "Text",
    "value": "Métropole Nice Côte d%27Azur"
  },
  "dateModified": {
    "type": "DateTime",
    "value": "2024-06-03T04:07:12.474Z"
  },
  "dateObserved": {
    "type": "DateTime",
    "value": "2024-06-02T19:00:00.000Z"
  },
  "location": {
    "type": "geo:json",
    "value": {
      "coordinates": [
        7.272055164,
        43.698568614
      ],
      "type": "Point"
    }
  },
  "name": {
    "type": "Text",
    "value": "Balise GBOX001400"
  },
  "refDevice": {
    "type": "Text",
    "value": "Device:AZIMUT-MULTIFLOW-GBOX001400"
  },
  "relativeHumidity": {
    "type": "Number",
    "value": 0.33,
    "metadata": {
      "timestamp": {
        "type": "DateTime",
        "value": "2019-01-31T03:45:00.000Z"
      },
      "unitCode": {
        "type": "Text",
        "value": "P1"
      }
    }
  },
  "source": {
    "type": "Text",
    "value": "Azimut"
  },
  "temperature": {
    "type": "Number",
    "value": 12.963870049,
    "metadata": {
      "timestamp": {
        "type": "DateTime",
        "value": "2019-01-31T03:45:00.000Z"
      },
      "unitCode": {
        "type": "Text",
        "value": "CEL"
      }
    }
  }
}

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 "AirQualityObserved"
  • 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 "AirQualityObserved"

curl -X GET "https://api.nicecotedazur.org/nca/environment/air/airquality/?idPattern=^AirQualityObserved:AZIMUT-MULTIFLOW&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/environment/air/airquality/AirQualityObserved:AZIMUT-MULTIFLOW-GBOX000699?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/environment/air/airquality/AirQualityObserved:AZIMUT-MULTIFLOW-GBOX000699?attrs=dateObserved,NO2&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/environment/air/airquality/histo/AirQualityObserved:AZIMUT-MULTIFLOW-GBOX000699?attrs=NO2&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 "AirQualityObserved"

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/environment/air/airquality/?idPattern=^AirQualityObserved:AZIMUT-MULTIFLOW&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/environment/air/airquality/AirQualityObserved:AZIMUT-MULTIFLOW-GBOX000699?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/environment/air/airquality/AirQualityObserved:AZIMUT-MULTIFLOW-GBOX000699?attrs=dateObserved,NO2&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/environment/air/airquality/histo/AirQualityObserved:AZIMUT-MULTIFLOW-GBOX000699?attrs=NO2&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 "AirQualityObserved"

const url = "https://api.nicecotedazur.org/nca/environment/air/airquality/"
 
const params = {
    idPattern: '^AirQualityObserved:AZIMUT-MULTIFLOW',
    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/environment/air/airquality/AirQualityObserved:AZIMUT-MULTIFLOW-GBOX000699"
 
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/environment/air/airquality/AirQualityObserved:AZIMUT-MULTIFLOW-GBOX000699"
 
const params = {
    attrs: 'dateObserved,NO2',
    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/environment/air/airquality/histo/AirQualityObserved:AZIMUT-MULTIFLOW-GBOX000699"
 
const params = {
    attrs: 'NO2',
    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 "AirQualityObserved"

import requests
import urllib.parse
 
url = "https://api.nicecotedazur.org/nca/environment/air/airquality/"
searchParams = {
  'idPattern': "^AirQualityObserved:AZIMUT-MULTIFLOW",
  '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/environment/air/airquality/AirQualityObserved:AZIMUT-MULTIFLOW-GBOX000699"
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/environment/air/airquality/AirQualityObserved:AZIMUT-MULTIFLOW-GBOX000699"
searchParams = {
  'attrs': 'dateObserved,NO2',
  '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/environment/air/airquality/histo/AirQualityObserved:AZIMUT-MULTIFLOW-GBOX000699"
searchParams = {
  'attrs': 'NO2',
  '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 "AirQualityObserved"

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/environment/air/airquality/";
 
            using var client = new HttpClient();
            var builder = new UriBuilder(URL)
            {
               Query = "idPattern=^AirQualityObserved:AZIMUT-MULTIFLOW&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/environment/air/airquality/AirQualityObserved:AZIMUT-MULTIFLOW-GBOX000699";
 
            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/environment/air/airquality/AirQualityObserved:AZIMUT-MULTIFLOW-GBOX000699";
 
            using var client = new HttpClient();
            var builder = new UriBuilder(URL)
            {
               Query = "attrs=dateObserved,NO2&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/environment/air/airquality/histo/AirQualityObserved:AZIMUT-MULTIFLOW-GBOX000699";
 
            using var client = new HttpClient();
            var builder = new UriBuilder(URL)
            {
               Query = "attrs=NO2&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);
        }
    }
}