- 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 posizione per cui ottenere le condizioni meteo attuali. |
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 |
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 ( |
| Campi | |
|---|---|
currentTime |
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: |
timeZone |
Il fuso orario nella posizione richiesta. |
weatherCondition |
La condizione meteo attuale. |
temperature |
La temperatura attuale. |
feelsLikeTemperature |
La misura della temperatura percepita attualmente nella località richiesta. |
dewPoint |
La temperatura attuale del punto di rugiada. |
heatIndex |
La temperatura attuale dell'indice di calore. |
windChill |
L'attuale temperatura percepita, la temperatura dell'aria esposta sulla pelle. |
precipitation |
La probabilità di precipitazioni attuale e la quantità di precipitazioni accumulate nell'ultima ora. |
airPressure |
Le condizioni di pressione atmosferica attuali. |
wind |
Le condizioni attuali del vento. |
visibility |
La visibilità attuale. |
currentConditionsHistory |
Le variazioni delle condizioni attuali nelle ultime 24 ore. |
isDaytime |
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 |
La percentuale attuale di umidità relativa (valori da 0 a 100). |
uvIndex |
L'attuale indice ultravioletto (UV). |
thunderstormProbability |
La probabilità attuale di temporale (valori da 0 a 100). |
cloudCover |
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 ( |
| Campi | |
|---|---|
temperatureChange |
La temperatura attuale meno la temperatura di 24 ore prima. |
maxTemperature |
La temperatura massima (alta) nelle ultime 24 ore. |
minTemperature |
La temperatura minima (bassa) nelle ultime 24 ore. |
snowQpf |
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 |
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). |