Panoramica

L’API Qualità dell’aria restituisce le condizioni attuali e le previsioni orarie per inquinanti atmosferici, indici AQI e livelli di polline. I dati provengono dal Copernicus Atmosphere Monitoring Service (CAMS).

Endpoint

GET /air-quality/{lat},{lon}

Parametri

Parametro	Obbligatorio	Predefinito	Descrizione
`lat,lon`	Sì	—	Latitudine e longitudine come parametro del percorso (es. `47.37,8.55`)

Richiesta di esempio

GET /air-quality/47.37,8.55

Risposta di esempio

{
  "latitude": 47.37,
  "longitude": 8.55,
  "timezone": "UTC",
  "current": {
    "time": 1709132400,
    "europeanAqi": 42,
    "usAqi": 58,
    "pm25": 12.5,
    "pm10": 18.3,
    "ozone": 68.2,
    "nitrogenDioxide": 15.8,
    "sulphurDioxide": 3.2,
    "carbonMonoxide": 245.6
  },
  "hourly": {
    "data": [
      {
        "time": 1709132400,
        "europeanAqi": 42,
        "usAqi": 58,
        "pm25": 12.5,
        "pm10": 18.3,
        "ozone": 68.2,
        "nitrogenDioxide": 15.8,
        "sulphurDioxide": 3.2,
        "carbonMonoxide": 245.6
      }
    ]
  }
}

Campi della risposta

current / hourly data

Campo	Tipo	Unità	Descrizione
`time`	integer	—	Timestamp Unix
`europeanAqi`	integer	—	Indice europeo di qualità dell’aria (0–500)
`usAqi`	integer	—	Indice statunitense di qualità dell’aria (0–500)
`pm25`	float	µg/m³	Particolato fine (PM2.5)
`pm10`	float	µg/m³	Particolato grossolano (PM10)
`ozone`	float	µg/m³	Ozono a livello del suolo (O₃)
`nitrogenDioxide`	float	µg/m³	Diossido di azoto (NO₂)
`sulphurDioxide`	float	µg/m³	Diossido di zolfo (SO₂)
`carbonMonoxide`	float	µg/m³	Monossido di carbonio (CO)

Campi aggiuntivi (solo CAMS Europe)

Questi campi sono disponibili solo per le località europee:

Campo	Tipo	Unità	Descrizione
`dustAod`	float	—	Profondità ottica degli aerosol di polvere
`pollenBirch`	float	µg/m³	Concentrazione di polline di betulla
`pollenGrass`	float	µg/m³	Concentrazione di polline di graminacee
`pollenOlive`	float	µg/m³	Concentrazione di polline di olivo
`pollenRagweed`	float	µg/m³	Concentrazione di polline di ambrosia
`pollenAlder`	float	µg/m³	Concentrazione di polline di ontano
`pollenMugwort`	float	µg/m³	Concentrazione di polline di artemisia

Errori

Status	Descrizione
`400`	Coordinate o parametri non validi
`403`	Chiave API non valida
`429`	Limite di richieste superato
`503`	Dati sulla qualità dell’aria non caricati

Qualità dell'aria