Ottieni una chiave demo di Maps: prova l'API Weather senza costi con una chiave demo di Maps, senza bisogno di dati di fatturazione.

Google utilizza la tecnologia AI per tradurre i contenuti nella tua lingua preferita. Le traduzioni generate dall'AI potrebbero contenere errori.

Method: currentConditions.lookup

Richiesta HTTP
Parametri di ricerca
Corpo della richiesta
Corpo della risposta
- Rappresentazione JSON
Ambiti di autorizzazione
CurrentConditionsHistory
- Rappresentazione JSON
Fai una prova!

Restituisce le condizioni meteo attuali in una determinata località.

Richiesta HTTP

GET https://weather.googleapis.com/v1/currentConditions:lookup

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri di query

Parametri

Parametri
`location`	`object (LatLng)` Obbligatorio. La località per cui ottenere le condizioni meteo attuali.
`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).
`languageCode`	`string` 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 BCP-47. Il valore predefinito è "en".

location

object (LatLng)

Obbligatorio. La località per cui ottenere le condizioni meteo attuali.

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

languageCode

string

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 BCP-47. Il valore predefinito è "en".

Corpo della richiesta

Il corpo della richiesta deve essere vuoto.

Corpo della risposta

Risposta per l'RPC currentConditions.lookup: rappresenta le condizioni meteo attuali nella località richiesta.

In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:

Rappresentazione JSON

Rappresentazione JSON
{ "currentTime": string, "timeZone": { object (`TimeZone`) }, "weatherCondition": { object (`WeatherCondition`) }, "temperature": { object (`Temperature`) }, "feelsLikeTemperature": { object (`Temperature`) }, "dewPoint": { object (`Temperature`) }, "heatIndex": { object (`Temperature`) }, "windChill": { object (`Temperature`) }, "precipitation": { object (`Precipitation`) }, "airPressure": { object (`AirPressure`) }, "wind": { object (`Wind`) }, "visibility": { object (`Visibility`) }, "currentConditionsHistory": { object (`CurrentConditionsHistory`) }, "isDaytime": boolean, "relativeHumidity": integer, "uvIndex": integer, "thunderstormProbability": integer, "cloudCover": integer }

{
  "currentTime": string,
  "timeZone": {
    object (TimeZone)
  },
  "weatherCondition": {
    object (WeatherCondition)
  },
  "temperature": {
    object (Temperature)
  },
  "feelsLikeTemperature": {
    object (Temperature)
  },
  "dewPoint": {
    object (Temperature)
  },
  "heatIndex": {
    object (Temperature)
  },
  "windChill": {
    object (Temperature)
  },
  "precipitation": {
    object (Precipitation)
  },
  "airPressure": {
    object (AirPressure)
  },
  "wind": {
    object (Wind)
  },
  "visibility": {
    object (Visibility)
  },
  "currentConditionsHistory": {
    object (CurrentConditionsHistory)
  },
  "isDaytime": boolean,
  "relativeHumidity": integer,
  "uvIndex": integer,
  "thunderstormProbability": integer,
  "cloudCover": integer
}

Campi
`currentTime`	`string (Timestamp format)` Ora corrente (UTC) associata ai dati restituiti. Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: `"2014-10-02T15:01:23Z"`, `"2014-10-02T15:01:23.045123456Z"` o `"2014-10-02T15:01:23+05:30"`.
`timeZone`	`object (TimeZone)` Il fuso orario della località richiesta.
`weatherCondition`	`object (WeatherCondition)` La condizione meteo attuale.
`temperature`	`object (Temperature)` La temperatura attuale.
`feelsLikeTemperature`	`object (Temperature)` La misura della temperatura percepita attualmente nella località richiesta.
`dewPoint`	`object (Temperature)` La temperatura attuale del punto di rugiada.
`heatIndex`	`object (Temperature)` La temperatura attuale dell'indice di calore.
`windChill`	`object (Temperature)` La temperatura percepita attuale, ovvero la temperatura dell'aria esposta sulla pelle. Nota: questo campo restituisce un oggetto vuoto per le località in Giappone e Corea del Sud.
`precipitation`	`object (Precipitation)` La probabilità di precipitazioni attuale e la quantità di precipitazioni accumulate nell'ultima ora.
`airPressure`	`object (AirPressure)` Le condizioni attuali della pressione atmosferica.
`wind`	`object (Wind)` Le condizioni attuali del vento.
`visibility`	`object (Visibility)` La visibilità attuale. Nota: questo campo restituisce un oggetto vuoto per le località in Giappone e Corea del Sud.
`currentConditionsHistory`	`object (CurrentConditionsHistory)` Le variazioni delle condizioni attuali nelle ultime 24 ore.
`isDaytime`	`boolean` True se l'ora corrente nella località richiesta è compresa tra l'ora dell'alba locale (inclusa) e l'ora del tramonto (esclusa). In caso contrario, è notte (tra il tramonto e l'alba successiva).
`relativeHumidity`	`integer` La percentuale attuale di umidità relativa (valori da 0 a 100).
`uvIndex`	`integer` L'indice UV (ultravioletti) attuale.
`thunderstormProbability`	`integer` La probabilità attuale di temporali (valori da 0 a 100). Nota: questo campo viene omesso dalla risposta per le località in Giappone e Corea del Sud.
`cloudCover`	`integer` La percentuale attuale di cielo coperto da nuvole (valori da 0 a 100). Nota: questo campo viene omesso dalla risposta per le località in Giappone e Corea del Sud.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

https://www.googleapis.com/auth/cloud-platform

CurrentConditionsHistory

Rappresenta un insieme di modifiche alle condizioni attuali nelle ultime 24 ore.