- Richiesta HTTP
- Parametri di ricerca
- Corpo della richiesta
- Corpo della risposta
- Ambiti di autorizzazione
- HistoryHour
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 |
Obbligatorio. La località per cui recuperare i dati storici orari. |
units |
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). |
page |
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. |
page |
Facoltativo. Un token di pagina ricevuto da una richiesta precedente. Viene utilizzato per recuperare la pagina successiva. |
hours |
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. |
language |
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 ( |
Campi | |
---|---|
history |
I record storici orari, in base al numero di ore e alle dimensioni di pagina specificate nella richiesta. |
time |
Il fuso orario della località richiesta. |
next |
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 ( |
Campi | |
---|---|
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). |
display |
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. |
weather |
Le condizioni meteorologiche storiche. |
temperature |
La temperatura storica. |
feels |
La misura della temperatura percepita nella località richiesta. |
dew |
La temperatura del punto di rugiada storica. |
heat |
La temperatura storica dell'indice di calore. |
wind |
Il vento freddo storico, la temperatura dell'aria esposta sulla pelle. |
wet |
La temperatura di bulbo umido storica, la temperatura più bassa raggiungibile evaporando l'acqua. |
precipitation |
La probabilità storica di precipitazioni e la quantità di precipitazioni accumulate nell'ultima ora. |
air |
Le condizioni storiche della pressione atmosferica. |
wind |
Le condizioni storiche del vento. |
visibility |
La visibilità storica. |
ice |
Lo spessore del ghiaccio storico. |
is |
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). |
relative |
La percentuale storica di umidità relativa (valori da 0 a 100). |
uv |
L'indice ultravioletto (UV) storico. |
thunderstorm |
La probabilità storica di temporali (valori da 0 a 100). |
cloud |
La percentuale storica del cielo coperto da nuvole (valori da 0 a 100). |