Method: history.hours.lookup

Restituisce fino a 24 ore di dati storici meteo orari in una determinata località, a partire dall'ultima ora.

Richiesta HTTP

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

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri di query

Parametri
location

object (LatLng)

Obbligatorio. La località per cui recuperare i dati storici orari.

unitsSystem

enum (UnitsSystem)

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

pageSize

integer

Facoltativo. Il numero massimo di record storici orari da restituire per pagina, un valore compreso tra 1 e 24 (inclusi). 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 il numero totale di ore da recuperare a partire dall'ultima ora, da 1 a 24 (inclusive). Il valore predefinito è il valore massimo consentito di 24.

languageCode

string

Facoltativo. Consente al cliente di scegliere la lingua della risposta. Se non è possibile fornire dati per la lingua in questione, l'API utilizza la corrispondenza più simile. I valori consentiti si basano sullo standard IETF BCP-47. Il valore predefinito è "it".

Corpo della richiesta

Il corpo della richiesta deve essere vuoto.

Corpo della risposta

Risposta per l'RPC hours.lookup.

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

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

object (HistoryHour)

I record storici orari, in base al numero di ore e alle dimensioni di pagina specificate nella richiesta.

timeZone

object (TimeZone)

Il fuso orario della località 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

HistoryHour

Rappresenta un record della cronologia ogni ora in una determinata località.

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 storici (i timestamp vengono arrotondati per difetto all'ora più vicina).

displayDateTime

object (DateTime)

La data e l'ora locali nel fuso orario della località (ora civile) per cui viene calcolato questo record orario. Questo campo potrebbe essere utilizzato a scopo di visualizzazione sul client. Nota: questa data sarà composta da anno, mese, giorno, ora e offset rispetto a UTC.

weatherCondition

object (WeatherCondition)

Le condizioni meteorologiche storiche.

temperature

object (Temperature)

La temperatura storica.

feelsLikeTemperature

object (Temperature)

La misura della temperatura percepita nella località richiesta.

dewPoint

object (Temperature)

La temperatura del punto di rugiada storica.

heatIndex

object (Temperature)

La temperatura storica dell'indice di calore.

windChill

object (Temperature)

Il vento freddo storico, la temperatura dell'aria esposta sulla pelle.

wetBulbTemperature

object (Temperature)

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

precipitation

object (Precipitation)

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

airPressure

object (AirPressure)

Le condizioni storiche della pressione atmosferica.

wind

object (Wind)

Le condizioni storiche del vento.

visibility

object (Visibility)

La visibilità storica.

iceThickness

object (IceThickness)

Lo spessore del ghiaccio storico.

isDaytime

boolean

True se l'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 interseca rispettivamente l'alba e il tramonto locali (ad es. se l'intervallo va dalle 5:00 alle 6:00 e l'alba è alle 5:59, isDaytime sarà true).

relativeHumidity

integer

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

uvIndex

integer

L'indice ultravioletto (UV) storico.

thunderstormProbability

integer

La probabilità storica di temporali (valori da 0 a 100).

cloudCover

integer

La percentuale storica del cielo coperto da nuvole (valori da 0 a 100).