Method: currentConditions.lookup

L'endpoint Condizioni attuali fornisce informazioni orarie sulla qualità dell'aria in oltre 100 paesi, con una risoluzione fino a 500 x 500 metri. Include oltre 70 indici locali, nonché categorie e indici 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 (LatLng)
  },
  "extraComputations": [
    enum (ExtraComputation)
  ],
  "uaqiColorPalette": enum (ColorPalette),
  "customLocalAqis": [
    {
      object (CustomLocalAqi)
    }
  ],
  "universalAqi": boolean,
  "languageCode": string
}
Campi
location

object (LatLng)

Obbligatorio. La longitudine e la latitudine da cui l'API cerca i dati sulle condizioni attuali relative alla qualità dell'aria.
extraComputations[]

enum (ExtraComputation)

Campo facoltativo. Funzionalità aggiuntive che è possibile abilitare facoltativamente. Se specifichi calcoli aggiuntivi, nella risposta verranno restituiti gli elementi e i campi pertinenti.
uaqiColorPalette

enum (ColorPalette)

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 gli IQA, mentre gli altri IQA hanno una tavolozza dei colori predeterminata che non può essere controllata.
customLocalAqis[]

object (CustomLocalAqi)

Campo facoltativo. Indica una relazione di tipo "paese/regione rispetto all'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.
universalAqi

boolean

Campo facoltativo. Se è impostato su true, l'IQA universale verrà incluso nel campo "Indici" della risposta. Il valore predefinito è true.
languageCode

string

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.

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 (AirQualityIndex)
    }
  ],
  "pollutants": [
    {
      object (Pollutant)
    }
  ],
  "healthRecommendations": {
    object (HealthRecommendations)
  }
}
Campi
dateTime

string (Timestamp format)

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".
regionCode

string

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à fornita nella richiesta si trova in un territorio conteso.
indexes[]

object (AirQualityIndex)

In base ai parametri della richiesta, questo elenco includerà (fino a) due indici di qualità dell'aria:

  • IQA universale. Viene restituito se il valore booleano universalAqi è impostato su true.
  • IQA locale. Viene restituito se viene specificato il calcolo aggiuntivo di LOCAL_AQI.
pollutants[]

object (Pollutant)

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.
healthRecommendations

object (HealthRecommendations)

Consigli sulla salute e azioni consigliate in relazione alle condizioni di qualità dell'aria segnalate. I consigli sono personalizzati in modo diverso per la popolazione a rischio, i gruppi con maggiore sensibilità agli inquinanti e la 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.