Panoramica dell'API Air Quality
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
L'API Air Quality ti consente di richiedere dati sulla qualità dell'aria per una posizione specifica,
inclusi oltre 70 indici di qualità dell'aria (IQA), agenti inquinanti e consigli
per la salute. Copre oltre 100 paesi con una risoluzione di 500 x 500 metri.
Perché utilizzare l'API Air Quality
L'API fornisce endpoint che ti consentono di eseguire query su:
- Condizioni attuali: informazioni orarie in tempo reale sulla qualità dell'aria.
- Cronologia oraria:cronologia della qualità dell'aria per una località specifica, per un determinato intervallo di tempo, fino a un massimo di 30 giorni.
- Mappe termiche:riquadri codificati a colori di vari indici e inquinanti.
- Previsioni orarie: condizioni future della qualità dell'aria per una località specifica,
fino a 96 ore (4 giorni).
Funzionalità dell'API Air Quality
- Indici e categorie di qualità dell'aria in tempo reale:l'API Air Quality
calcola continuamente il valore di vari indici di qualità dell'aria con una risoluzione di 500 x
500 metri.
- Consigli per la salute:centinaia di consigli per la salute basati su ricerche per il pubblico generico e per i gruppi sensibili, tra cui:
bambini, anziani, donne in gravidanza, atleti e persone con asma o patologie
cardiache.
- Dettagli sugli agenti inquinanti:informazioni approfondite sui diversi agenti inquinanti, che mettono in evidenza l'agente inquinante predominante, le concentrazioni, le fonti e gli effetti.
- Cronologia oraria: cronologia della qualità dell'aria per una località specifica in un determinato
intervallo di tempo. Ogni risposta può includere indici di qualità dell'aria orari,
dati sugli agenti inquinanti e consigli per la salute per un massimo di 720 ore (30
giorni).
- Mappe termiche:le mappe termiche sono una raccolta di indici AQ e riquadri di immagini di inquinanti che possono essere visualizzati sopra una mappa di Google.
Se il tuo indirizzo di fatturazione si trova nello Spazio economico europeo (SEE), puoi
visualizzare le mappe di calore sopra qualsiasi mappa.
Scopri di più.
- Previsione oraria: condizioni future della qualità dell'aria per una località specifica,
per un determinato intervallo di tempo o per un'ora particolare in futuro, fino a 96
ore (4 giorni). Ogni risposta include potenzialmente indici di previsione della qualità dell'aria oraria, dati sugli agenti inquinanti e consigli pratici.
Come funziona l'API Air Quality
L'API Air Quality ha i seguenti metodi:
currentConditions: l'endpoint
currentConditions fornisce informazioni
orarie sulla qualità dell'aria.
history: l'endpoint
history fornisce
informazioni storiche orarie sulla qualità dell'aria per una posizione specifica, per un
intervallo di tempo specificato, fino a un massimo di 30 giorni.
heatmapTiles: l'endpoint heatmapTiles
fornisce mappe termiche relative alla qualità dell'aria tramite una sovrapposizione di riquadri.
Previsione: l'endpoint forecast
fornisce informazioni orarie sulla qualità dell'aria futura per una posizione specifica, per un determinato intervallo di tempo, fino a un massimo di 96 ore (4 giorni).
Copertura di paesi e regioni dell'API Air Quality
Consulta Paesi supportati dall'API Air Quality e IQA disponibili per i dettagli
più recenti sulla copertura, paese per paese, per i quali sono disponibili
informazioni sulla qualità dell'aria (IQA) e informazioni sulla qualità dell'aria locale (LAQI).
Come utilizzare l'API Air Quality
| 1 |
Configurazione |
Inizia con Configurare il progetto Google Cloud e completa le istruzioni riportate di seguito. |
| 2 |
Ricevere informazioni orarie aggiornate sulla qualità dell'aria |
Consulta le condizioni attuali. |
| 3 |
Visualizzare la cronologia oraria della qualità dell'aria |
Vedi Cronologia. |
| 4 |
Visualizzare mappe termiche relative alla qualità dell'aria tramite una sovrapposizione di riquadri |
Consulta la sezione Mappe termiche. |
| 5 |
Ricevi informazioni sulle previsioni orarie della qualità dell'aria |
Vedi Previsione. |
Passaggi successivi
Salvo quando diversamente specificato, i contenuti di questa pagina sono concessi in base alla licenza Creative Commons Attribution 4.0, mentre gli esempi di codice sono concessi in base alla licenza Apache 2.0. Per ulteriori dettagli, consulta le norme del sito di Google Developers. Java è un marchio registrato di Oracle e/o delle sue consociate.
Ultimo aggiornamento 2025-08-31 UTC.
[null,null,["Ultimo aggiornamento 2025-08-31 UTC."],[[["\u003cp\u003eThe Air Quality API provides access to real-time, historical, and forecasted air quality data for over 100 countries with a resolution of 500 x 500 meters.\u003c/p\u003e\n"],["\u003cp\u003eYou can retrieve current conditions, hourly history (up to 30 days), heatmaps, and hourly forecasts (up to 96 hours) using the API.\u003c/p\u003e\n"],["\u003cp\u003eThe API includes various air quality indexes, health recommendations, pollutant details, and heatmap tile overlays.\u003c/p\u003e\n"],["\u003cp\u003eCoverage details and available air quality indexes vary by country and region, so refer to the provided resources for specific information.\u003c/p\u003e\n"],["\u003cp\u003eTo use the Air Quality API, you need to set up a Google Cloud project and then utilize the provided endpoints and documentation to retrieve air quality data.\u003c/p\u003e\n"]]],["The Air Quality API provides real-time and historical air quality data, forecasts, and heatmaps for over 100 countries with 500x500 meter resolution. Key actions include querying current conditions, accessing up to 30 days of hourly history, viewing color-coded heatmap tiles, and obtaining up to 96-hour hourly forecasts. The API delivers information on 70+ AQIs, pollutants, and health recommendations for various groups, leveraging methods such as `currentConditions`, `history`, `heatmapTiles`, and `forecast`.\n"],null,["The Air Quality API lets you request air quality data for a specific location,\nincluding over 70 air quality indexes (AQIs), pollutants, and health\nrecommendations. It covers over 100 countries with a resolution of 500 x 500\nmeters.\n\nWhy use the Air Quality API\n\nThe API provides endpoints that let you query:\n\n- **Current Conditions:** Real-time hourly air quality information.\n- **Hourly History:** Air quality history for a specific location, for a given time range, up to a maximum of 30 days.\n- **Heatmaps:** Color coded tiles of various indexes and pollutants.\n- **Hourly Forecast:** Future air quality conditions for a specific location, up to 96 hours (4 days).\n\nFeatures of the Air Quality API\n\n- **Real-time air quality indexes and categories:** The Air Quality API continuously calculates the value of various air quality indexes with 500 x 500 meters resolution.\n- **Health recommendations:** Hundreds of research-backed health recommendations for the general public and sensitivity groups including: children, elderly, pregnant women, athletes and those with asthma or heart conditions.\n- **Pollutant details:** In-depth information about different pollutants, highlighting the dominant pollutant, concentrations, sources and effects.\n- **Hourly history:** Air quality history for a specific location for a given time range. Each response potentially includes hourly air quality indexes, pollutant data, and health recommendations for a maximum of 720 hours (30 days).\n- **Heatmaps:** Heatmaps are a collection of AQ indexes and pollutants image tiles that can be displayed on top of a Google Map. If your billing address is in the European Economic Area (EEA), you may display heatmaps on top of any map. [Learn more](/maps/comms/eea/faq#tos-updates).\n- **Hourly forecast:** Future air quality conditions for a specific location, and for a given time range or for a particular hour in the future, up to 96 hours (4 days). Each response potentially includes hourly air quality forecast indexes, pollutant data and actionable recommendations.\n\nHow the Air Quality API works\n\nThe Air Quality API has the following methods:\n\n- **currentConditions** : The\n [`currentConditions`](/maps/documentation/air-quality/reference/rest/v1/currentConditions/lookup) endpoint\n provides current hourly air quality information.\n\n- **history** : The\n [`history`](/maps/documentation/air-quality/reference/rest/v1/history/lookup) endpoint provides\n historical hourly air quality information for a specific location, for a\n given time range, up to a maximum of 30 days.\n\n- **heatmapTiles** : The [`heatmapTiles`](/maps/documentation/air-quality/reference/rest/v1/mapTypes.heatmapTiles/lookupHeatmapTile)\n endpoint provides air quality related heatmaps through a tile overlay.\n\n- **forecast** : The [`forecast`](/maps/documentation/air-quality/reference/rest/v1/forecast/lookup)\n endpoint provides hourly future air quality information for a specific\n location, for a given time range, up to a maximum of 96 hours (4 days).\n\nAir Quality API country and region coverage\n\nSee [Air Quality API supported countries and available AQIs](/maps/documentation/air-quality/coverage) for the\nlatest coverage details, on a country-by-country basis, for which air quality\ninformation (AQI) and local air quality information (LAQI) is available.\n\nHow to use the Air Quality API\n\n|---|-------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------|\n| 1 | **Get set up** | Start with [Set up your Google Cloud project](/maps/documentation/air-quality/cloud-setup) and complete the instructions that follow. |\n| 2 | **Get current hourly air quality information** | See [Current conditions](/maps/documentation/air-quality/current-conditions). |\n| 3 | **Get hourly air-quality history** | See [History](/maps/documentation/air-quality/history). |\n| 4 | **Get air quality related heatmaps through a tile overlay** | See [Heatmaps](/maps/documentation/air-quality/heatmaps). |\n| 5 | **Get hourly air quality forecast information** | See [Forecast](/maps/documentation/air-quality/forecast). |\n\nWhat's next\n\n- [Set up your Google Cloud project](/maps/documentation/air-quality/cloud-setup)\n- [Get current conditions](/maps/documentation/air-quality/current-conditions)\n- [Get hourly history](/maps/documentation/air-quality/history)\n- [Get heatmaps](/maps/documentation/air-quality/heatmaps)\n- [Get hourly forecast](/maps/documentation/air-quality/forecast)"]]
