Method: currentConditions.lookup

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
location

object (LatLng)

Obbligatorio. La posizione 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 cliente di scegliere la lingua della 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, che 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
{
  "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 attuale (UTC) associata ai dati restituiti.

Utilizza RFC 3339, in cui l'output generato è sempre normalizzato in base al fuso orario UTC 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 nella posizione 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)

L'attuale temperatura percepita, la temperatura dell'aria esposta sulla pelle.

precipitation

object (Precipitation)

La probabilità di precipitazioni attuale e la quantità di precipitazioni accumulate nell'ultima ora.

airPressure

object (AirPressure)

Le condizioni di pressione atmosferica attuali.

wind

object (Wind)

Le condizioni attuali del vento.

visibility

object (Visibility)

La visibilità attuale.

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'alba locale (inclusa) e il tramonto (escluso). 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'attuale indice ultravioletto (UV).

thunderstormProbability

integer

La probabilità attuale di temporale (valori da 0 a 100).

cloudCover

integer

La percentuale attuale di cielo coperto da nuvole (valori da 0 a 100).

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.

Rappresentazione JSON
{
  "temperatureChange": {
    object (Temperature)
  },
  "maxTemperature": {
    object (Temperature)
  },
  "minTemperature": {
    object (Temperature)
  },
  "snowQpf": {
    object (QuantitativePrecipitationForecast)
  },
  "qpf": {
    object (QuantitativePrecipitationForecast)
  }
}
Campi
temperatureChange

object (Temperature)

La temperatura attuale meno la temperatura di 24 ore prima.

maxTemperature

object (Temperature)

La temperatura massima (alta) nelle ultime 24 ore.

minTemperature

object (Temperature)

La temperatura minima (bassa) nelle ultime 24 ore.

snowQpf

object (QuantitativePrecipitationForecast)

La quantità di neve, misurata come equivalente di acqua liquida, che si è accumulata nelle ultime 24 ore. Nota: QPF è l'abbreviazione di Previsione quantitativa delle precipitazioni (per ulteriori dettagli, consulta la definizione di QuantitativePrecipitationForecast).

qpf

object (QuantitativePrecipitationForecast)

La quantità di precipitazioni piovose, misurata come equivalente di acqua liquida, che si è accumulata nelle ultime 24 ore. Nota: QPF è l'abbreviazione di Previsione quantitativa delle precipitazioni (per ulteriori dettagli, consulta la definizione di QuantitativePrecipitationForecast).