Method: forecast.hours.lookup

Restituisce fino a 240 ore di previsioni orarie in una determinata località, a partire dall'ora corrente.

Richiesta HTTP

GET https://weather.googleapis.com/v1/forecast/hours:lookup

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri di query

Parametri
location

object (LatLng)

Obbligatorio. La località per cui ricevere le previsioni orarie.
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).
pageSize

integer

Facoltativo. Il numero massimo di record di previsione oraria da restituire per pagina, un valore compreso tra 1 e 24 (incluso). Il valore predefinito è il valore massimo consentito di 24.
pageToken

string

Facoltativo. Un token di pagina ricevuto da una richiesta precedente. Viene utilizzato per recuperare la pagina successiva.
hours

integer

Facoltativo. Limita la quantità di ore totali da recuperare a partire dall'ora corrente. Il valore deve essere compreso tra 1 e 240 (inclusi). Il valore predefinito è il valore massimo consentito di 240.
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 la RPC hours.lookup.

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

Rappresentazione JSON 
{
  "forecastHours": [
    {
      object (ForecastHour)
    }
  ],
  "timeZone": {
    object (TimeZone)
  },
  "nextPageToken": string
}
Campi
forecastHours[]

object (ForecastHour)

I record delle previsioni orarie, in base al numero di ore e alle dimensioni della pagina specificati nella richiesta.
timeZone

object (TimeZone)

Il fuso orario nella posizione richiesta.
nextPageToken

string

Il token per recuperare la pagina successiva.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

ForecastHour

Rappresenta un record di previsione oraria in una determinata posizione.

Rappresentazione JSON 
{
  "interval": {
    object (Interval)
  },
  "displayDateTime": {
    object (DateTime)
  },
  "weatherCondition": {
    object (WeatherCondition)
  },
  "temperature": {
    object (Temperature)
  },
  "feelsLikeTemperature": {
    object (Temperature)
  },
  "dewPoint": {
    object (Temperature)
  },
  "heatIndex": {
    object (Temperature)
  },
  "windChill": {
    object (Temperature)
  },
  "wetBulbTemperature": {
    object (Temperature)
  },
  "precipitation": {
    object (Precipitation)
  },
  "airPressure": {
    object (AirPressure)
  },
  "wind": {
    object (Wind)
  },
  "visibility": {
    object (Visibility)
  },
  "iceThickness": {
    object (IceThickness)
  },
  "isDaytime": boolean,
  "relativeHumidity": integer,
  "uvIndex": integer,
  "thunderstormProbability": integer,
  "cloudCover": integer
}
Campi
interval

object (Interval)

L'intervallo di un'ora (in ora UTC) per cui sono validi questi dati di previsione (i timestamp vengono arrotondati all'ora più vicina).
displayDateTime

object (DateTime)

La data e l'ora locali nel fuso orario della località (ora civile) per cui viene calcolata questa previsione oraria. Questo campo può essere utilizzato a scopo di visualizzazione sul client. Nota: questa data sarà composta da anno, mese, giorno, ora e offset rispetto al fuso orario UTC.
weatherCondition

object (WeatherCondition)

La condizione meteorologica prevista.
temperature

object (Temperature)

La temperatura prevista.
feelsLikeTemperature

object (Temperature)

La misura di come si percepirà la temperatura nella località richiesta.
dewPoint

object (Temperature)

La temperatura del punto di rugiada prevista.
heatIndex

object (Temperature)

La temperatura prevista dell'indice di calore.
windChill

object (Temperature)

La temperatura percepita prevista, ovvero la temperatura dell'aria a contatto con la pelle.
wetBulbTemperature

object (Temperature)

La temperatura di bulbo umido prevista, ovvero la temperatura più bassa raggiungibile evaporando l'acqua.
precipitation

object (Precipitation)

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

object (AirPressure)

Le condizioni di pressione atmosferica previste.
wind

object (Wind)

Le condizioni del vento previste.
visibility

object (Visibility)

La visibilità prevista.
iceThickness

object (IceThickness)

Lo spessore del ghiaccio previsto.
isDaytime

boolean

True se questa ora è compresa tra l'alba (inclusa) e il tramonto (escluso) locali. In caso contrario, è notte (tra il tramonto e l'alba successiva). Nota: questa ora verrà considerata diurna o notturna se l'intervallo si interseca rispettivamente con gli orari locali di alba e tramonto (ad es. se l'intervallo è dalle 5:00 alle 6:00 e l'alba è alle 5:59, allora isDaytime sarà true).
relativeHumidity

integer

La percentuale prevista di umidità relativa (valori da 0 a 100).
uvIndex

integer

L'indice ultravioletto (UV) previsto.
thunderstormProbability

integer

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

integer

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