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 meteo restituite. Se non viene fornito, le condizioni meteo restituite saranno nel sistema metrico (valore predefinito = METRIC).
pageSize

integer

Facoltativo. Il numero massimo di record di previsione giornaliera da restituire per pagina, un valore compreso tra 1 e 10 (incluso). 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 la quantità di giorni totali da recuperare a partire dal giorno corrente. Il valore deve essere 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 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 la 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 nella posizione 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)
  }
}
Campi
interval

object (Interval)

L'intervallo di tempo UTC in cui inizia (incluso) e termina (escluso) questo giorno previsto. Nota: un giorno inizia alle 7:00 e termina alle 7: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 cui viene calcolata questa previsione giornaliera. Questo campo può essere utilizzato a scopo di visualizzazione sul client.
daytimeForecast

object (ForecastDayPart)

Le condizioni meteo previste per la parte diurna della giornata (dalle 7: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 la giornata.
minTemperature

object (Temperature)

La temperatura minima (bassa) durante il giorno.
feelsLikeMaxTemperature

object (Temperature)

La temperatura percepita massima (alta) durante la giornata.
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. sorgere della luna, tramonto della luna).

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 sono irrilevanti. La data è relativa al calendario gregoriano. Può rappresentare uno dei seguenti elementi:

  • Una data completa, con valori diversi da zero per anno, mese e giorno.
  • 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, una data di scadenza della carta di credito).

Tipi correlati:

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

integer

L'anno della data. Deve essere compreso tra 1 e 9999 o tra 0 e 9999 per specificare una data senza anno.
month

integer

Mese dell'anno. Deve essere compreso tra 1 e 12 o 0 per specificare un anno senza mese e giorno.
day

integer

Giorno del mese. Deve essere compreso tra 1 e 31 e valido per l'anno e il mese oppure compreso tra 0 e 31 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)
  },
  "iceThickness": {
    object (IceThickness)
  },
  "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 della giornata inizia alle 7: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 meteo prevista.
precipitation

object (Precipitation)

Le precipitazioni previste.
wind

object (Wind)

La direzione media del vento e la velocità massima e la raffica.
iceThickness

object (IceThickness)

La quantità di ghiaccio accumulata per la parte della giornata.
relativeHumidity

integer

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

integer

L'indice ultravioletto (UV) massimo previsto.
thunderstormProbability

integer

La probabilità media di temporale.
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 esserci l'ora dell'alba per un giorno. In questi casi, questo campo non verrà impostato.

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: "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 unici (ad es. a nord del circolo polare artico) potrebbe non esserci un orario del tramonto per un giorno. In questi casi, questo campo non verrà impostato.

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: "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. sorgere della luna, tramonto della luna).

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

string (Timestamp format)

Il momento in cui il bordo 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 solo orario 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 unici (ad es. nelle regioni polari), l'elenco può contenere più di un valore. In questi casi, i valori vengono ordinati in ordine crescente.

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

string (Timestamp format)

Il momento in cui il lembo superiore della luna scompare sotto l'orizzonte (vedi https://en.wikipedia.org/wiki/Moonrise_and_moonset).

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

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: "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 il 0-50% sul lato destro nell'emisfero settentrionale 🌒 e sul lato sinistro nell'emisfero australe 🌘.
FIRST_QUARTER La Luna è illuminata al 50,1% sul lato destro nell'emisfero settentrionale 🌓 e sul lato sinistro nell'emisfero australe 🌗.
WAXING_GIBBOUS La Luna è illuminata al 50-100% sul lato destro nell'emisfero settentrionale 🌔 e sul lato sinistro nell'emisfero australe 🌖.
FULL_MOON La luna è completamente illuminata.
WANING_GIBBOUS La Luna è illuminata al 50-100% sul lato sinistro nell'emisfero settentrionale 🌖 e sul lato destro nell'emisfero australe 🌔.
LAST_QUARTER La Luna è illuminata al 50,1% sul lato sinistro nell'emisfero settentrionale 🌗 e sul lato destro nell'emisfero australe 🌓.
WANING_CRESCENT La Luna è illuminata al 0-50% sul lato sinistro nell'emisfero settentrionale 🌘 e sul lato destro nell'emisfero australe 🌒.