- Richiesta HTTP
- Parametri di ricerca
- Corpo della richiesta
- Corpo della risposta
- Ambiti di autorizzazione
- CurrentConditionsHistory
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 |
Obbligatorio. La località per cui vuoi ricevere le condizioni meteo attuali. |
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). |
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 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 |
---|
{ "currentTime": string, "timeZone": { object ( |
Campi | |
---|---|
current |
Ora corrente (UTC) associata ai dati restituiti. Utilizza RFC 3339, in cui l'output generato sarà sempre normalizzato in base a Z e utilizza 0, 3, 6 o 9 cifre decimali. Sono accettati anche offset diversi da "Z". Esempi: |
time |
Il fuso orario della località richiesta. |
weather |
Le condizioni meteo attuali. |
temperature |
La temperatura attuale. |
feels |
La misura della temperatura percepita al momento nella località richiesta. |
dew |
La temperatura attuale del punto di rugiada. |
heat |
La temperatura attuale dell'indice di calore. |
wind |
Il freddo percepito attuale, la temperatura dell'aria esposta sulla pelle. |
precipitation |
La probabilità e la quantità di precipitazioni attuali accumulate nell'ultima ora. |
air |
Le condizioni attuali della pressione atmosferica. |
wind |
Le condizioni attuali del vento. |
visibility |
La visibilità attuale. |
current |
Le variazioni delle condizioni attuali nelle ultime 24 ore. |
is |
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). |
relative |
La percentuale di umidità relativa attuale (valori da 0 a 100). |
uv |
L'indice ultravioletto (UV) attuale. |
thunderstorm |
La probabilità attuale di temporali (valori da 0 a 100). |
cloud |
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 variazioni delle condizioni attuali nelle ultime 24 ore.
Rappresentazione JSON |
---|
{ "temperatureChange": { object ( |
Campi | |
---|---|
temperature |
La temperatura attuale meno la temperatura di 24 ore fa. |
max |
La temperatura massima (alta) registrata nelle ultime 24 ore. |
min |
La temperatura minima (bassa) registrata nelle ultime 24 ore. |
qpf |
La quantità di precipitazioni (pioggia o neve), misurata in termini di acqua liquida equivalente, che si è accumulata nelle ultime 24 ore. Nota: QPF è l'abbreviazione di Previsione quantitativa delle precipitazioni (per ulteriori dettagli, consulta la definizione di QuantitativePrecipitationForecast). |