Indice
AirQuality
(interfaccia)AirQualityIndex
(messaggio)ColorPalette
(enum)CustomLocalAqi
(messaggio)ExtraComputation
(enum)HealthRecommendations
(messaggio)LookupCurrentConditionsRequest
(messaggio)LookupCurrentConditionsResponse
(messaggio)LookupForecastRequest
(messaggio)LookupForecastResponse
(messaggio)LookupForecastResponse.HourlyForecast
(messaggio)LookupHeatmapTileRequest
(messaggio)LookupHistoryRequest
(messaggio)LookupHistoryResponse
(messaggio)LookupHistoryResponse.HourInfo
(messaggio)MapType
(enum)Pollutant
(messaggio)Pollutant.AdditionalInfo
(messaggio)Pollutant.Concentration
(messaggio)Pollutant.Concentration.Unit
(enum)
AirQuality
Servizi di qualità dell'aria.
LookupCurrentConditions |
---|
L'endpoint Condizioni attuali fornisce informazioni orarie sulla qualità dell'aria in più di 100 paesi, con una risoluzione fino a 500 x 500 metri. Include oltre 70 indici locali, indice di qualità dell'aria globale e categorie.
|
LookupForecast |
---|
Restituisce una previsione sulla qualità dell'aria per una località specifica per un determinato intervallo di tempo.
|
LookupHeatmapTile |
---|
Restituisce un array di byte contenente i dati dell'immagine PNG del riquadro.
|
LookupHistory |
---|
Restituisce la cronologia della qualità dell'aria per una località specifica per un determinato intervallo di tempo.
|
AirQualityIndex
L'oggetto di base per la rappresentazione di diverse metriche sulla qualità dell'aria. Combinate, queste metriche forniscono un'istantanea delle condizioni attuali della qualità dell'aria. Al mondo esistono più indici che rispondono a differenti scopi e gruppi interessati a misurare diversi aspetti della qualità dell'aria.
Campi | |
---|---|
code |
Il codice dell'indice. Questo campo rappresenta l'indice a fini di programmazione utilizzando l'uso delle maiuscole e delle minuscole anziché degli spazi. Esempi: "uaqi", "fra_atmo". |
display_name |
Una rappresentazione leggibile del nome dell'indice. Esempio: "IQA (US)" |
aqi_display |
Rappresentazione testuale del punteggio numerico dell'indice, che può includere simboli di prefisso o suffisso, che di solito rappresentano il punteggio di indice peggiore. Esempio: >100 o 10+. Nota: questo campo deve essere utilizzato per visualizzare il punteggio dell'indice. Per gli indici non numerici, questo campo è vuoto. |
color |
Il colore utilizzato per rappresentare il punteggio numerico dell'IQA. |
category |
Classificazione testuale dell'interpretazione del punteggio numerico dell'indice. Ad esempio: "Qualità dell'aria eccellente". |
dominant_pollutant |
Il simbolo chimico dell'inquinante dominante. Ad esempio: "CO". |
aqi |
Il punteggio numerico dell'indice. Esempi: 10. 100. Il valore non è normalizzato e deve essere interpretato solo nel contesto del relativo indice di qualità dell'aria. Per gli indici non numerici, questo campo non verrà restituito. Nota: questo campo deve essere utilizzato per calcoli, grafici e così via. Per visualizzare il punteggio dell'indice, devi utilizzare il campo di visualizzazione dell'IQA. |
ColorPalette
Consente di stabilire la tavolozza dei colori utilizzata per i dati forniti dall'"Indice di qualità dell'aria universale" (UAQI). Questa tavolozza dei colori è pertinente solo per l'UAQI, mentre gli altri IQA hanno una tavolozza dei colori predeterminata che non può essere controllata.
Enum | |
---|---|
COLOR_PALETTE_UNSPECIFIED |
Il valore predefinito. Ignorato se trasmesso come parametro. |
RED_GREEN |
Consente di stabilire se utilizzare una tavolozza rosso/verde. |
INDIGO_PERSIAN_DARK |
Consente di stabilire se utilizzare una tavolozza indaco/persiana (tema scuro). |
INDIGO_PERSIAN_LIGHT |
Consente di stabilire se utilizzare una tavolozza indaco/persiana (tema chiaro). |
CustomLocalAqi
Indica la relazione tra "paese/regione e l'IQA". Associa un paese/una regione all'IQA desiderato in modo che i dati sulla qualità dell'aria richiesti per quel paese/regione vengano visualizzati in base all'IQA scelto.
Campi | |
---|---|
region_code |
Il paese/la regione che richiede l'IQA personalizzato. Il valore deve essere fornito utilizzando il codice ISO 3166-1 alpha-2. |
aqi |
L'IQA a cui associare il paese/la regione. Il valore deve essere un codice di indice valido. |
ExtraComputation
Funzionalità aggiuntive che possono essere abilitate facoltativamente. Se specifichi calcoli aggiuntivi, nella risposta verranno restituiti gli elementi e i campi pertinenti.
Enum | |
---|---|
EXTRA_COMPUTATION_UNSPECIFIED |
Il valore predefinito. Il server la ignora se viene passato come parametro. |
LOCAL_AQI |
Consente di stabilire se includere nella risposta l'IQA locale (nazionale) della località richiesta (paese). Se specificato, la risposta conterrà una struttura di dati "air_quality_index" con tutti i dati pertinenti sull'IQA locale della località. |
HEALTH_RECOMMENDATIONS |
Determina se la risposta includerà i consigli sulla salute e le azioni consigliate per le condizioni attuali dell'IQA. Le raccomandazioni sono studiate su misura per la popolazione generale e per sei popolazioni a rischio che presentano una maggiore sensibilità agli inquinanti rispetto alla popolazione generale. Se specificato, il campo |
POLLUTANT_ADDITIONAL_INFO |
Determina se includere nella risposta le informazioni aggiuntive di ciascun inquinante. Se specificato, ogni oggetto dell'indice di qualità dell'aria contenuto nella risposta del campo "Indici" includerà un campo |
DOMINANT_POLLUTANT_CONCENTRATION |
Determina se la risposta includerà le concentrazioni degli inquinanti dominanti misurate secondo indici globali e/o locali. Se nella richiesta sono specificati sia l'IQA globale sia l'IQA locale, potrebbero essere restituiti fino a due codici inquinanti. Se specificato, l'oggetto inquinante dominante contenuto nell'elenco "inquinanti" includerà un campo |
POLLUTANT_CONCENTRATION |
Determina se la risposta includerà le concentrazioni di tutti gli inquinanti con misurazioni disponibili in base agli indici globali e/o locali. Se specificato, ogni oggetto inquinante contenuto nel campo "inquinanti" della risposta includerà un campo |
HealthRecommendations
Consigli sulla salute per diversi gruppi di popolazioni in formato di testo libero. Le raccomandazioni derivano dalle condizioni di qualità dell'aria associate.
Campi | |
---|---|
general_population |
Nessuna sensibilità specifica. |
elderly |
pensionati e persone di età superiore alla popolazione generale. |
lung_disease_population |
Si soffre di problemi respiratori e asma. |
heart_disease_population |
Malattie cardiache e del sistema circolatorio. |
athletes |
Sport e altre faticose attività all'aperto. |
pregnant_women |
Donne in tutte le fasi della gravidanza. |
children |
Popolazione più giovane, inclusi bambini, bambini e neonati. |
LookupCurrentConditionsRequest
La definizione della richiesta delle condizioni attuali della qualità dell'aria.
Campi | |
---|---|
location |
Obbligatoria. La longitudine e la latitudine da cui l'API cerca i dati sulle condizioni attuali relative alla qualità dell'aria. |
extra_computations[] |
Campo facoltativo. Funzionalità aggiuntive che possono essere abilitate facoltativamente. Se specifichi calcoli aggiuntivi, nella risposta verranno restituiti gli elementi e i campi pertinenti. |
uaqi_color_palette |
Campo facoltativo. Consente di stabilire la tavolozza dei colori utilizzata per i dati forniti dall 'indice di qualità dell'aria universale (UAQI). Questa tavolozza dei colori è pertinente solo per l'UAQI, mentre gli altri IQA hanno una tavolozza dei colori predeterminata che non può essere controllata. |
custom_local_aqis[] |
Campo facoltativo. Indica la relazione tra "paese/regione e l'IQA". Associa un paese/una regione all'IQA desiderato in modo che i dati sulla qualità dell'aria richiesti per quel paese/regione vengano visualizzati in base all'IQA scelto. Questo parametro può essere utilizzato per specificare un IQA non predefinito per un determinato paese, ad esempio per ottenere l'indice EPA degli Stati Uniti per il Canada anziché l'indice predefinito per il Canada. |
universal_aqi |
Campo facoltativo. Se impostato su true, l'IQA universale verrà incluso nel campo "Indici" della risposta. Il valore predefinito è true. |
language_code |
Campo facoltativo. Consente al client di scegliere la lingua per la risposta. Se non è possibile fornire dati per quella lingua, l'API utilizza la corrispondenza più vicina. I valori consentiti si basano sullo standard IETF. Il valore predefinito è en. |
LookupCurrentConditionsResponse
Campi | |
---|---|
date_time |
Un timestamp arrotondato per difetto in formato "Zulu" RFC3339 UTC, con risoluzione in nanosecondi e fino a nove cifre frazionarie. Ad esempio: "2014-10-02T15:00:00Z". |
region_code |
Il codice ISO_3166-1 alpha-2 del paese o della regione corrispondente alla località fornita nella richiesta. Questo campo potrebbe essere omesso dalla risposta se la località specificata nella richiesta si trova in un territorio conteso. |
indexes[] |
In base ai parametri della richiesta, questo elenco include (fino a) due indici di qualità dell'aria:
|
pollutants[] |
Un elenco di inquinanti che interessano la località specificata nella richiesta. Nota: questo campo verrà restituito solo per le richieste che specificavano uno o più dei seguenti calcoli aggiuntivi: POLLUTANT_ADDITIONAL_INFO, DOMINANT_POLLUTANT_CONCENTRATION, POLLUTANT_CONCENTRATION. |
health_recommendations |
Consigli sulla salute e azioni consigliate in merito alle condizioni della qualità dell'aria segnalate. Le raccomandazioni vengono adattate in modo diverso alla popolazione a rischio, ai gruppi con maggiore sensibilità agli inquinanti e alla popolazione generale. |
LookupForecastRequest
L'oggetto della richiesta dell'API di previsione della qualità dell'aria.
Campi | |
---|---|
location |
Obbligatoria. La latitudine e la longitudine per le quali l'API cerca i dati sulla qualità dell'aria. |
extra_computations[] |
Campo facoltativo. Funzionalità aggiuntive che possono essere abilitate facoltativamente. Se specifichi calcoli aggiuntivi, nella risposta verranno restituiti gli elementi e i campi pertinenti. |
uaqi_color_palette |
Campo facoltativo. Consente di stabilire la tavolozza dei colori utilizzata per i dati forniti dall 'indice di qualità dell'aria universale (UAQI). Questa tavolozza dei colori è pertinente solo per l'UAQI, mentre gli altri IQA hanno una tavolozza dei colori predeterminata che non può essere controllata. |
custom_local_aqis[] |
Campo facoltativo. Indica la relazione tra "paese/regione e l'IQA". Associa un paese/una regione all'IQA desiderato in modo che i dati sulla qualità dell'aria richiesti per quel paese/regione vengano visualizzati in base all'IQA scelto. Questo parametro può essere utilizzato per specificare un IQA non predefinito per un determinato paese, ad esempio per ottenere l'indice EPA degli Stati Uniti per il Canada anziché l'indice predefinito per il Canada. |
page_size |
Campo facoltativo. Il numero massimo di record di informazioni orarie da restituire per pagina (valore predefinito = 24). |
page_token |
Campo facoltativo. Un token di pagina ricevuto da una precedente chiamata di previsione. Viene utilizzato per recuperare la pagina successiva. |
Campo di unione time_range . L'intervallo di tempo dei dati di previsione sulla qualità dell'aria richiesti. L'intervallo deve essere nel futuro di almeno un'ora arrotondata. Se non specifichi questo campo, verrà restituito un errore INVALID_ARGUMENT. time_range può essere solo uno dei seguenti: |
|
date_time |
Un timestamp per il quale restituire i dati per un momento specifico. Il timestamp viene arrotondato all'ora esatta precedente. Nota: verranno restituiti i dati orari relativi solo al timestamp richiesto (ovvero un singolo elemento informativo orario). Ad esempio, una richiesta inviata in cui il parametro date_time è impostato su 2023-01-03T11:05:49Z verrà arrotondata per difetto a 2023-01-03T11:00:00Z. |
period |
Indica il periodo di inizio e di fine per cui ottenere i dati di previsione. Il timestamp viene arrotondato all'ora esatta precedente. |
universal_aqi |
Campo facoltativo. Se è impostato su true, l'IQA universale verrà incluso nel campo "Indici" della risposta (valore predefinito = true). |
language_code |
Campo facoltativo. Consente al client di scegliere la lingua per la risposta. Se non è possibile fornire dati per quella lingua, l'API utilizza la corrispondenza più vicina. I valori consentiti si basano sullo standard IETF (predefinito = "en"). |
LookupForecastResponse
L'oggetto risposta dell'API di previsione della qualità dell'aria.
Campi | |
---|---|
hourly_forecasts[] |
Campo facoltativo. Contiene le informazioni sulla qualità dell'aria per ogni ora nell'intervallo richiesto. Ad esempio, se la richiesta riguarda 48 ore di previsione, ci saranno 48 elementi di previsioni orarie. |
region_code |
Campo facoltativo. Il codice ISO_3166-1 alpha-2 del paese o della regione corrispondente alla località fornita nella richiesta. Questo campo potrebbe essere omesso dalla risposta se la località specificata nella richiesta si trova in un territorio conteso. |
next_page_token |
Campo facoltativo. Il token per recuperare la pagina successiva. |
HourlyForecast
Contiene le informazioni sulla qualità dell'aria per ogni ora nell'intervallo richiesto. Ad esempio, se la richiesta riguarda 48 ore di previsione, ci saranno 48 elementi di previsioni orarie.
Campi | |
---|---|
date_time |
Un timestamp arrotondato per difetto che indica l'ora (ora) a cui fanno riferimento i dati nel formato "Zulu" UTC RFC3339. Ad esempio: "2014-10-02T15:00:00Z". |
indexes[] |
In base ai parametri della richiesta, questo elenco include (fino a) due indici di qualità dell'aria:
|
pollutants[] |
Un elenco di inquinanti che interessano la località specificata nella richiesta. Nota: questo campo verrà restituito solo per le richieste che specificavano uno o più dei seguenti calcoli aggiuntivi: POLLUTANT_ADDITIONAL_INFO, DOMINANT_POLLUTANT_CONCENTRATION, POLLUTANT_CONCENTRATION. |
health_recommendations |
Consigli sulla salute e azioni consigliate in merito alle condizioni della qualità dell'aria segnalate. Le raccomandazioni vengono adattate in modo diverso alla popolazione a rischio, ai gruppi con maggiore sensibilità agli inquinanti e alla popolazione generale. |
LookupHeatmapTileRequest
Richiesta di riquadro della mappa termica.
La struttura è conforme alla chiamata GET standard del server dei riquadri, ovvero https://airquality.googleapis.com/v1/mapTypes/{map_type}/heatmapTiles/{zoom}/{x}/{y}
Esempio: https://airquality.googleapis.com/v1/mapTypes/BAQI_INDIGO_PERSIAN/heatmapTiles/1/1/1
Campi | |
---|---|
map_type |
Obbligatoria. Il tipo di mappa termica della qualità dell'aria. Definisce l'inquinante rappresentato graficamente dalla mappa.
|
zoom |
Obbligatoria. Il livello di zoom della mappa. Definisce quanto grande o piccolo i contenuti di una mappa vengono visualizzati in una visualizzazione mappa. Il livello di zoom 0 mostra il mondo intero in un unico riquadro. Il livello di zoom 1 è il mondo intero in 4 riquadri. Il livello di zoom 2 è il mondo intero in 16 riquadri. Il livello di zoom 16 è il mondo intero in 65.536 riquadri. Valori consentiti: 0-16 |
x |
Obbligatoria. Definisce il punto est-ovest nel riquadro richiesto. |
y |
Obbligatoria. Definisce il punto nord-sud nel riquadro richiesto. |
LookupHistoryRequest
L'oggetto della richiesta dell'API cronologia della qualità dell'aria.
Campi | |
---|---|
page_size |
Campo facoltativo. Il numero massimo di record di informazioni orari da restituire per pagina. Il valore predefinito è 72 e il valore massimo è 168 (dati di 7 giorni). |
page_token |
Campo facoltativo. Un token di pagina ricevuto da una precedente chiamata della cronologia. Viene utilizzato per recuperare la pagina successiva. Tieni presente che quando fornisci un valore per questo parametro, tutti gli altri parametri forniti devono corrispondere alla chiamata che ha fornito il token di pagina (la chiamata precedente). |
location |
Obbligatoria. La latitudine e la longitudine per le quali l'API cerca i dati storici sulla qualità dell'aria. |
extra_computations[] |
Campo facoltativo. Funzionalità aggiuntive che possono essere abilitate facoltativamente. Se specifichi calcoli aggiuntivi, nella risposta verranno restituiti gli elementi e i campi pertinenti. |
uaqi_color_palette |
Campo facoltativo. Consente di stabilire la tavolozza dei colori utilizzata per i dati forniti dall 'indice di qualità dell'aria universale (UAQI). Questa tavolozza dei colori è pertinente solo per l'UAQI, mentre gli altri IQA hanno una tavolozza dei colori predeterminata che non può essere controllata. |
custom_local_aqis[] |
Campo facoltativo. Indica la relazione tra "paese/regione e l'IQA". Associa un paese/una regione all'IQA desiderato in modo che i dati sulla qualità dell'aria richiesti per quel paese/regione vengano visualizzati in base all'IQA scelto. Questo parametro può essere utilizzato per specificare un IQA non predefinito per un determinato paese, ad esempio per ottenere l'indice EPA degli Stati Uniti per il Canada anziché l'indice predefinito per il Canada. |
Campo di unione time_range . L'intervallo di tempo per i dati sulla qualità dell'aria richiesti. Se non specifichi un campo relativo all'intervallo di tempo, verrà restituito un errore INVALID_ARGUMENT. time_range può essere solo uno dei seguenti: time_range può essere solo uno dei seguenti: |
|
date_time |
Un timestamp per il quale restituire i dati storici. Il timestamp viene arrotondato all'ora esatta precedente. Nota: verranno restituiti i dati orari relativi solo al timestamp richiesto (ovvero un singolo elemento informativo orario). Ad esempio, una richiesta inviata in cui il parametro dateTime è impostato su 2023-01-03T11:05:49Z verrà arrotondata per difetto a 2023-01-03T11:00:00Z. Un timestamp in formato "Zulu" RFC3339 UTC, con risoluzione in nanosecondi e fino a nove cifre frazionarie. Esempi: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z". |
hours |
Numero da 1 a 720 che indica l'intervallo di ore per la richiesta. Ad esempio: un valore pari a 48 restituirà i dati delle ultime 48 ore. |
period |
Indica il periodo di inizio e di fine per cui ottenere i dati storici. Il timestamp viene arrotondato all'ora esatta precedente. |
universal_aqi |
Campo facoltativo. Se impostato su true, l'IQA universale verrà incluso nel campo "Indici" della risposta. Il valore predefinito è true. |
language_code |
Campo facoltativo. Consente al client di scegliere la lingua per la risposta. Se non è possibile fornire dati per quella lingua, l'API utilizza la corrispondenza più vicina. I valori consentiti si basano sullo standard IETF. Il valore predefinito è en. |
LookupHistoryResponse
Campi | |
---|---|
hours_info[] |
Campo facoltativo. Contiene le informazioni sulla qualità dell'aria per ogni ora nell'intervallo richiesto. Ad esempio, se la richiesta riguarda 48 ore di cronologia, ci saranno 48 elementi di informazioni orarie. |
region_code |
Campo facoltativo. Il codice ISO_3166-1 alpha-2 del paese o della regione corrispondente alla località fornita nella richiesta. Questo campo potrebbe essere omesso dalla risposta se la località specificata nella richiesta si trova in un territorio conteso. |
next_page_token |
Campo facoltativo. Il token per recuperare la pagina successiva. |
HourInfo
Contiene le informazioni sulla qualità dell'aria per ogni ora nell'intervallo richiesto. Ad esempio, se la richiesta riguarda 48 ore di cronologia, ci saranno 48 elementi di informazioni orarie.
Campi | |
---|---|
date_time |
Un timestamp arrotondato per difetto che indica l'ora a cui fanno riferimento i dati nel formato "Zulu" RFC3339 UTC, con risoluzione in nanosecondi e fino a nove cifre frazionarie. Ad esempio: "2014-10-02T15:00:00Z". |
indexes[] |
In base ai parametri della richiesta, questo elenco include (fino a) due indici di qualità dell'aria:
|
pollutants[] |
Un elenco di inquinanti che interessano la località specificata nella richiesta. Nota: questo campo verrà restituito solo per le richieste che specificavano uno o più dei seguenti calcoli aggiuntivi: POLLUTANT_ADDITIONAL_INFO, DOMINANT_POLLUTANT_CONCENTRATION, POLLUTANT_CONCENTRATION. |
health_recommendations |
Consigli sulla salute e azioni consigliate in merito alle condizioni della qualità dell'aria segnalate. Le raccomandazioni vengono adattate in modo diverso alla popolazione a rischio, ai gruppi con maggiore sensibilità agli inquinanti e alla popolazione generale. |
MapType
Il tipo di mappa termica della qualità dell'aria. Definisce l'inquinante rappresentato graficamente dalla mappa.
Enum | |
---|---|
MAP_TYPE_UNSPECIFIED |
Il valore predefinito. Il server la ignora se viene passato come parametro. |
UAQI_RED_GREEN |
Tavolozza rosso-verde dell'indice di qualità dell'aria universale. |
UAQI_INDIGO_PERSIAN |
Tavolozza indaco-persiana dell'Indice di qualità dell'aria universale. |
PM25_INDIGO_PERSIAN |
Tavolozza indaco-persiana con indice PM2,5. |
GBR_DEFRA |
Tavolozza dei colori dell'indice di qualità dell'aria giornaliera (Regno Unito). |
DEU_UBA |
Tavolozza dei colori dell'indice di qualità dell'aria locale tedesco. |
CAN_EC |
Tavolozza dei colori dell'indice di qualità dell'aria canadese. |
FRA_ATMO |
Tavolozza dei colori dell'indice di qualità dell'aria in Francia. |
US_AQI |
Tavolozza dei colori dell'indice di qualità dell'aria negli Stati Uniti. |
Inquinante
Dati relativi a un inquinante che garantisce la qualità dell'aria.
Campi | |
---|---|
code |
Il nome in codice dell'inquinante. Ad esempio: "so2". Un elenco di tutti i codici disponibili è disponibile qui. |
display_name |
Il nome visualizzato dell'inquinante. Ad esempio: "NOx". |
full_name |
Il nome completo dell'inquinante. Per i composti chimici, si tratta del nome IUPAC. Esempio: "Anidride solforosa". Per saperne di più sulla tabella dei nomi IUPAC, vedi https://iupac.org/what-we-do/periodic-table-of-elements/ |
concentration |
Il livello di concentrazione dell'inquinante misurato da una delle unità di misura standard dell'inquinamento atmosferico. |
additional_info |
Informazioni aggiuntive sull'inquinante. |
AdditionalInfo
Le fonti di emissioni e gli effetti sulla salute di un determinato inquinante.
Campi | |
---|---|
sources |
Testo che rappresenta le principali fonti di emissioni dell'inquinante. |
effects |
Testo che rappresenta i principali effetti dell'inquinante sulla salute. |
Concentrazione
La concentrazione di un determinato inquinante nell'aria.
Campi | |
---|---|
units |
Unità per la misurazione di questa concentrazione di inquinanti. |
value |
Valore della concentrazione di inquinanti. |
Unità
Definisce l'unità utilizzata per misurare la concentrazione dell'inquinante.
Enum | |
---|---|
UNIT_UNSPECIFIED |
Unità di concentrazione non specificata. |
PARTS_PER_BILLION |
L'unità di concentrazione ppb (parti per miliardo). |
MICROGRAMS_PER_CUBIC_METER |
L'unità di concentrazione "μg/m^3" (microgrammi per metro cubo). |