Method: lookupWeather

Cercare le condizioni meteo in una località.

Richiesta HTTP

POST https://mapstools.googleapis.com/v1:lookupWeather

L'URL utilizza la sintassi di transcodifica gRPC.

Corpo della richiesta

Il corpo della richiesta contiene dati con la seguente struttura:

Rappresentazione JSON 
{
  "unitsSystem": enum (UnitsSystem),
  "location": {
    object (Location)
  },
  "capabilities": [
    enum (Capability)
  ],
  "date": {
    object (Date)
  },
  "hour": integer,
  "languageCode": string,
  "weatherOptions": {
    object (WeatherOptions)
  },
  "airQualityOptions": {
    object (AirQualityOptions)
  }
}
Campi
unitsSystem

enum (UnitsSystem)

Facoltativo. Il sistema di unità da utilizzare per le condizioni meteo restituite. Se non viene fornito, le condizioni meteo restituite saranno nel sistema metrico (valore predefinito = METRIC).
location

object (Location)

Obbligatorio. La località per cui ottenere le condizioni meteo.
capabilities[]

enum (Capability)

Facoltativo. Le funzionalità ambientali da includere nella risposta.
date

object (Date)

Facoltativo. Specifica la data delle informazioni ambientali richieste, in base al fuso orario locale della località specificata nel campo location. Gli intervalli di date supportati dipendono dalle funzionalità richieste: - WEATHER: fino a 24 ore nel passato (se è impostato anche hour) e fino a 10 giorni (240 ore) nel futuro (da oggi a +9 giorni per le previsioni giornaliere). - AIR_QUALITY: fino a 30 giorni (720 ore) nel passato e fino a 4 giorni (96 ore) nel futuro. - POLLEN: da oggi a +4 giorni (fino a 5 giorni, incluso oggi; le date storiche non sono supportate).
hour

integer

Facoltativo. Specifica l'ora delle informazioni ambientali richieste, nel formato 24 ore (0-23), in base al fuso orario locale della località specificata nel campo location. Richiede che sia specificato date. Gli intervalli orari supportati dipendono dalle funzionalità richieste: - WEATHER: fino a 24 ore nel passato e fino a 240 ore (10 giorni) nel futuro. - AIR_QUALITY: fino a 30 giorni (720 ore) nel passato e fino a 4 giorni (96 ore) nel futuro. - POLLEN: restituisce solo le previsioni giornaliere; hour viene ignorato per i pollini.
languageCode

string

Facoltativo. Il codice lingua BCP-47 per il testo localizzato nella risposta (ad es. "en", "ja", "fr-CA"). Se non specificato, il valore predefinito è "en".
weatherOptions

object (WeatherOptions)

Facoltativo. Opzioni specifiche per le richieste relative al meteo. weatherOptions.units_system è supportato in combinazione con unitsSystem di primo livello (tag 4) per preservare la compatibilità con le versioni precedenti per i chiamanti esistenti; restituisce INVALID_ARGUMENT se entrambi specificano sistemi di unità in conflitto. Ignorato se WEATHER non è richiesto in capabilities.
airQualityOptions

object (AirQualityOptions)

Facoltativo. Opzioni specifiche per le richieste relative alla qualità dell'aria. Ignorato se AIR_QUALITY non è richiesto in capabilities.

Corpo della risposta

In caso di esito positivo, il corpo della risposta contiene un'istanza di LookupWeatherResponse.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/maps-platform.mapstools