L'endpoint Condizioni attuali fornisce informazioni orarie sulla qualità dell'aria in oltre 100 paesi, fino a una risoluzione di 500 x 500 metri. Include oltre 70 indici locali e categorie e indice di qualità dell'aria globali.
Richiesta HTTP
POST https://airquality.googleapis.com/v1/currentConditions:lookup
L'URL utilizza la sintassi di transcodifica gRPC.
Corpo della richiesta
Il corpo della richiesta contiene dati con la seguente struttura:
Rappresentazione JSON |
---|
{ "location": { object ( |
Campi | |
---|---|
location |
Obbligatorio. La longitudine e la latitudine da cui l'API cerca i dati sulle condizioni attuali sulla qualità dell'aria. |
extraComputations[] |
(Facoltativo) Funzionalità aggiuntive che possono essere attivate facoltativamente. Se specifichi calcoli aggiuntivi, gli elementi e i campi pertinenti verranno restituiti nella risposta. |
uaqiColorPalette |
(Facoltativo) consente di determinare la tavolozza dei colori utilizzata per i dati forniti dall'"Indice di qualità dell'aria universale" (UAQI). Questa tavolozza dei colori è pertinente solo per gli UAQI, mentre altri IQA hanno una tavolozza dei colori predeterminata che non può essere controllata. |
customLocalAqis[] |
(Facoltativo) Indica un "paese/regione in IQA" relazione tra utenti. Associa un paese o 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 US EPA per il Canada anziché l'indice predefinito per il Canada. |
universalAqi |
(Facoltativo) Se impostato su true, l'IQA universale verrà incluso negli "indici" campo della risposta. Il valore predefinito è true. |
languageCode |
(Facoltativo) Consente al client di scegliere la lingua per la risposta. Se non è possibile fornire dati per la lingua, l'API utilizza la corrispondenza più simile. I valori consentiti si basano sullo standard IETF. Il valore predefinito è en. |
Corpo della risposta
In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:
Rappresentazione JSON |
---|
{ "dateTime": string, "regionCode": string, "indexes": [ { object ( |
Campi | |
---|---|
dateTime |
Un timestamp arrotondato per difetto nel formato RFC3339 UTC "Zulu" con risoluzione in nanosecondi e fino a nove cifre frazionarie. Ad esempio: "2014-10-02T15:00:00Z". |
regionCode |
Il codice ISO_3166-1 alpha-2 del paese/della regione corrispondente alla località indicata nella richiesta. Questo campo potrebbe essere omesso dalla risposta se la località fornita nella richiesta si trova in un territorio conteso. |
indexes[] |
In base ai parametri della richiesta, questo elenco includerà (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 specificano uno o più dei seguenti calcoli aggiuntivi: POLLUTANT_ADDITIONAL_INFO, DOMINANT_POLLUTANT_CONCENTRATION, POLLUTANT_CONCENTRATION. |
healthRecommendations |
Consigli sulla salute e azioni consigliate in relazione alle condizioni di qualità dell'aria segnalate. Le raccomandazioni sono adattate in modo diverso in base alle popolazioni a rischio, ai gruppi con una maggiore sensibilità agli inquinanti e alla popolazione generale. |
Ambiti di autorizzazione
Richiede il seguente ambito OAuth:
https://www.googleapis.com/auth/cloud-platform
Per ulteriori informazioni, consulta la panoramica di OAuth 2.0.