Method: forecast.days.lookup

Restituisce fino a 10 giorni di previsioni giornaliere in una determinata località, a partire dal giorno corrente.

Richiesta HTTP

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

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri di query

Parametri
location

object (LatLng)

Obbligatorio. La località per cui ricevere le previsioni giornaliere.
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 di previsioni giornaliere da restituire per pagina, un valore compreso tra 1 e 10 (inclusi). Il valore predefinito è 5.
pageToken

string

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

integer

Facoltativo. Limita il numero totale di giorni da recuperare a partire dal giorno corrente. Un valore compreso tra 1 e 10 (inclusi). Il valore predefinito è il valore massimo consentito di 10.
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 days.lookup.

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

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

object (ForecastDay)

I record delle previsioni giornaliere, in base al numero di giorni e alle dimensioni della pagina specificati 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

ForecastDay

Rappresenta un record di previsione giornaliera in una determinata località.

Rappresentazione JSON 
{
  "interval": {
    object (Interval)
  },
  "displayDate": {
    object (Date)
  },
  "daytimeForecast": {
    object (ForecastDayPart)
  },
  "nighttimeForecast": {
    object (ForecastDayPart)
  },
  "maxTemperature": {
    object (Temperature)
  },
  "minTemperature": {
    object (Temperature)
  },
  "feelsLikeMaxTemperature": {
    object (Temperature)
  },
  "feelsLikeMinTemperature": {
    object (Temperature)
  },
  "maxHeatIndex": {
    object (Temperature)
  },
  "sunEvents": {
    object (SunEvents)
  },
  "moonEvents": {
    object (MoonEvents)
  },
  "iceThickness": {
    object (IceThickness)
  }
}
Campi
interval

object (Interval)

L'intervallo di tempo UTC in cui inizia (incluso) e termina (esclusivo) il giorno previsto. Nota: un giorno inizia alle 07:00 e termina alle 07:00 del giorno successivo, ora locale. Ad esempio, se il fuso orario locale è UTC-7, l'intervallo inizierà all'ora 14:00:00.000Z e terminerà alla stessa ora del giorno successivo.
displayDate

object (Date)

La data locale nel fuso orario della località (ora civile) per la quale viene calcolata questa previsione giornaliera. Questo campo potrebbe essere utilizzato a scopo di visualizzazione sul client.
daytimeForecast

object (ForecastDayPart)

Le condizioni meteo previste per la parte diurna della giornata (dalle 07:00 alle 19:00 ora locale).
nighttimeForecast

object (ForecastDayPart)

Le condizioni meteo previste per la parte notturna della giornata (dalle 19:00 alle 07:00 del giorno successivo, ora locale).
maxTemperature

object (Temperature)

La temperatura massima (alta) durante il giorno.
minTemperature

object (Temperature)

La temperatura minima (bassa) durante il giorno.
feelsLikeMaxTemperature

object (Temperature)

La temperatura percepita massima (alta) durante il giorno.
feelsLikeMinTemperature

object (Temperature)

La temperatura percepita minima (bassa) durante il giorno.
maxHeatIndex

object (Temperature)

La temperatura massima dell'indice di calore durante la giornata.
sunEvents

object (SunEvents)

Gli eventi relativi al sole (ad es. alba, tramonto).
moonEvents

object (MoonEvents)

Gli eventi relativi alla luna (ad es. levata e tramontata della luna).
iceThickness

object (IceThickness)

La quantità di ghiaccio accumulata nell'intera giornata.

Data

Rappresenta una data di calendario intera o parziale, ad esempio un compleanno. L'ora del giorno e il fuso orario sono specificati altrove o non sono significativi. La data è relativa al calendario gregoriano. Può rappresentare uno dei seguenti elementi:

  • Una data completa, con valori di anno, mese e giorno diversi da zero.
  • Un mese e un giorno, con un anno pari a zero (ad esempio un anniversario).
  • Un anno da solo, con un mese e un giorno pari a zero.
  • Un anno e un mese, con un giorno pari a zero (ad esempio, la data di scadenza di una carta di credito).

Tipi correlati:

Rappresentazione JSON 
{
  "year": integer,
  "month": integer,
  "day": integer
}
Campi
year

integer

Anno della data. Deve essere compreso tra 1 e 9999 oppure 0 per specificare una data senza anno.
month

integer

Mese di un anno. Deve essere compreso tra 1 e 12 oppure 0 per specificare un anno senza mese e giorno.
day

integer

Giorno di un mese. Deve essere compreso tra 1 e 31 e valido per l'anno e il mese oppure 0 per specificare un anno da solo o un anno e un mese in cui il giorno non è significativo.

ForecastDayPart

Rappresenta un record di previsione per una parte della giornata.

Rappresentazione JSON 
{
  "interval": {
    object (Interval)
  },
  "weatherCondition": {
    object (WeatherCondition)
  },
  "precipitation": {
    object (Precipitation)
  },
  "wind": {
    object (Wind)
  },
  "relativeHumidity": integer,
  "uvIndex": integer,
  "thunderstormProbability": integer,
  "cloudCover": integer
}
Campi
interval

object (Interval)

La data e l'ora UTC in cui inizia (inclusa) e termina (esclusa) questa parte della giornata. Nota: una parte di una giornata inizia alle 07:00 e termina alle 19:00 dello stesso giorno, ora locale. Ad esempio, se il fuso orario locale è UTC-7, l'intervallo diurno inizierà all'ora 14:00:00.000Z e terminerà alle 02:00:00.000Z del giorno successivo, mentre l'intervallo notturno inizierà alle 02:00:00.000Z del giorno successivo e terminerà alle 14:00:00.000Z dello stesso giorno.
weatherCondition

object (WeatherCondition)

La condizione meteorologica prevista.
precipitation

object (Precipitation)

Le precipitazioni previste.
wind

object (Wind)

La direzione media del vento, la velocità massima e le raffiche.
relativeHumidity

integer

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

integer

L'indice ultravioletto (UV) massimo previsto.
thunderstormProbability

integer

La probabilità media di temporali.
cloudCover

integer

Percentuale media di copertura nuvolosa.

SunEvents

Rappresenta gli eventi relativi al sole (ad es. alba, tramonto).

Rappresentazione JSON 
{
  "sunriseTime": string,
  "sunsetTime": string
}
Campi
sunriseTime

string (Timestamp format)

L'ora in cui sorge il sole.

NOTA: in alcuni casi particolari (ad es. a nord del circolo polare artico) potrebbe non essere presente un'ora di alba per un giorno. In questi casi, questo campo non verrà impostato.

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: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
sunsetTime

string (Timestamp format)

L'ora in cui tramonta il sole.

NOTA: in alcuni casi particolari (ad es. a nord del circolo polare artico) potrebbe non essere presente un'ora del tramonto per un giorno. In questi casi, questo campo non verrà impostato.

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: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".

MoonEvents

Rappresenta gli eventi relativi alla luna (ad es. levata e tramontata).

Rappresentazione JSON 
{
  "moonriseTimes": [
    string
  ],
  "moonsetTimes": [
    string
  ],
  "moonPhase": enum (MoonPhase)
}
Campi
moonriseTimes[]

string (Timestamp format)

L'ora in cui il tratto superiore della luna appare sopra l'orizzonte (vedi https://en.wikipedia.org/wiki/Moonrise_and_moonset).

NOTA: nella maggior parte dei casi, ci sarà un'unica ora di sorgere della luna al giorno. In altri casi, l'elenco potrebbe essere vuoto (ad es. quando la luna sorge dopo la mezzanotte del giorno successivo). Tuttavia, in casi particolari (ad es. nelle regioni polari), l'elenco può contenere più di un valore. In questi casi, i valori sono ordinati in ordine crescente.

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: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
moonsetTimes[]

string (Timestamp format)

L'ora in cui il tratto superiore della Luna scompare sotto l'orizzonte (vedi https://en.wikipedia.org/wiki/Moonrise_and_moonset).

NOTA: nella maggior parte dei casi, esisterà un'unica impostazione della luna al giorno. In altri casi, l'elenco potrebbe essere vuoto (ad esempio quando la luna tramonta dopo la mezzanotte del giorno successivo). Tuttavia, in casi particolari (ad es. nelle regioni polari), l'elenco può contenere più di un valore. In questi casi, i valori sono ordinati in ordine crescente.

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: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
moonPhase

enum (MoonPhase)

La fase lunare.

MoonPhase

Indica la fase lunare.

Enum
MOON_PHASE_UNSPECIFIED Fase lunare non specificata.
NEW_MOON La luna non è illuminata dal sole.
WAXING_CRESCENT La Luna è illuminata per lo 0%-50% sul lato destro nell'emisfero settentrionale 🌒 e sul lato sinistro nell'emisfero meridionale 🌘.
FIRST_QUARTER La Luna è illuminata per il 50,1% sul lato destro nell'emisfero settentrionale 🌓 e sul lato sinistro nell'emisfero meridionale 🌗.
WAXING_GIBBOUS La Luna è illuminata per il 50-100% sul lato destro nell'emisfero settentrionale 🌔 e sul lato sinistro nell'emisfero meridionale 🌖.
FULL_MOON La luna è completamente illuminata.
WANING_GIBBOUS La Luna è illuminata per il 50-100% sul lato sinistro nell'emisfero settentrionale 🌖 e sul lato destro nell'emisfero meridionale 🌔.
LAST_QUARTER La Luna è illuminata per il 50,1% sul lato sinistro nell'emisfero settentrionale 🌗 e sul lato destro nell'emisfero meridionale 🌓.
WANING_CRESCENT La Luna è illuminata per lo 0-50% sul lato sinistro nell'emisfero settentrionale 🌘 e sul lato destro nell'emisfero meridionale 🌒.