Method: forecast.days.lookup

Retorna até 10 dias de previsões diárias em um determinado local, começando pelo dia atual.

Solicitação HTTP

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

O URL usa a sintaxe de transcodificação gRPC.

Parâmetros de consulta

Parâmetros
location

object (LatLng)

Obrigatório. O local para receber a previsão diária.
unitsSystem

enum (UnitsSystem)

Opcional. O sistema de unidades a ser usado para as condições climáticas retornadas. Se não for fornecido, as condições climáticas retornadas estarão no sistema métrico (padrão = METRIC).
pageSize

integer

Opcional. O número máximo de registros de previsão diária a serem retornados por página. Um valor de 1 a 10 (inclusive). O valor padrão é cinco.
pageToken

string

Opcional. Um token de página recebido de uma solicitação anterior. Ele é usado para recuperar a página subsequente.
days

integer

Opcional. Limita a quantidade de dias totais a serem buscados a partir do dia atual. Um valor de 1 a 10 (inclusive). O valor padrão é o máximo permitido, que é 10.
languageCode

string

Opcional. Permite que o cliente escolha o idioma da resposta. Se não for possível fornecer dados para esse idioma, a API usará a correspondência mais próxima. Os valores permitidos dependem do padrão IETF BCP-47. O valor padrão é "en".

Corpo da solicitação

O corpo da solicitação precisa estar vazio.

Corpo da resposta

Resposta da RPC "days.lookup".

Se bem-sucedido, o corpo da resposta incluirá dados com a estrutura a seguir:

Representação JSON 
{
  "forecastDays": [
    {
      object (ForecastDay)
    }
  ],
  "timeZone": {
    object (TimeZone)
  },
  "nextPageToken": string
}
Campos
forecastDays[]

object (ForecastDay)

Os registros de previsão diária, de acordo com o número de dias e o tamanho da página especificados na solicitação.
timeZone

object (TimeZone)

O fuso horário no local solicitado.
nextPageToken

string

O token para recuperar a próxima página.

Escopos de autorização

Requer o seguinte escopo OAuth:

  • https://www.googleapis.com/auth/cloud-platform

ForecastDay

Representa um registro de previsão diária em um determinado local.

Representação 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)
  }
}
Campos
interval

object (Interval)

O intervalo de tempo UTC em que o dia previsto começa (inclusive) e termina (exclusive). Observação: um dia começa às 7h e termina às 7h do dia seguinte, no horário local. Por exemplo, se o fuso horário local for UTC-7, o intervalo vai começar no horário 14:00:00.000Z e terminar no mesmo horário do dia seguinte.
displayDate

object (Date)

A data local no fuso horário do local (horário civil) para que essa previsão diária é calculada. Esse campo pode ser usado para fins de exibição no cliente.
daytimeForecast

object (ForecastDayPart)

As condições climáticas previstas para o período diurno (das 7h às 19h, horário local).
nighttimeForecast

object (ForecastDayPart)

As condições climáticas previstas para a parte noturna do dia (das 19h às 7h do dia seguinte, horário local).
maxTemperature

object (Temperature)

A temperatura máxima (alta) ao longo do dia.
minTemperature

object (Temperature)

A temperatura mínima (baixa) ao longo do dia.
feelsLikeMaxTemperature

object (Temperature)

A sensação térmica máxima (alta) ao longo do dia.
feelsLikeMinTemperature

object (Temperature)

A sensação térmica mínima (baixa) ao longo do dia.
maxHeatIndex

object (Temperature)

A temperatura máxima do índice de calor ao longo do dia.
sunEvents

object (SunEvents)

Os eventos relacionados ao sol (por exemplo, nascer e pôr do sol).
moonEvents

object (MoonEvents)

Os eventos relacionados à lua (por exemplo, nascer e pôr da lua).

Data

Representa uma data inteira ou parcial do calendário, como um aniversário. A hora do dia e o fuso horário são especificados em outro lugar ou são insignificantes. A data é referente ao calendário gregoriano. Isso pode representar uma das seguintes opções:

  • uma data completa, com valores de ano, mês e dia diferentes de zero;
  • um mês e dia, com um ano zero (por exemplo, uma data comemorativa);
  • um ano sozinho, com um mês zero e um dia zero;
  • um ano e mês, com um dia zero (por exemplo, uma data de validade de cartão de crédito).

Tipos relacionados:

Representação JSON 
{
  "year": integer,
  "month": integer,
  "day": integer
}
Campos
year

integer

Ano da data. Precisa ser de 1 a 9.999 ou 0 para especificar uma data sem ano.
month

integer

Mês do ano. Precisa ser de 1 a 12, ou 0 para especificar um ano sem um mês e dia.
day

integer

Dia do mês. Precisa ser de 1 a 31 e válido para o ano e o mês, ou 0 para especificar um ano sozinho ou um ano e mês em que o dia não é significativo.

ForecastDayPart

Representa um registro de previsão para uma parte do dia.

Representação JSON 
{
  "interval": {
    object (Interval)
  },
  "weatherCondition": {
    object (WeatherCondition)
  },
  "precipitation": {
    object (Precipitation)
  },
  "wind": {
    object (Wind)
  },
  "iceThickness": {
    object (IceThickness)
  },
  "relativeHumidity": integer,
  "uvIndex": integer,
  "thunderstormProbability": integer,
  "cloudCover": integer
}
Campos
interval

object (Interval)

A data e a hora em UTC em que este período do dia começa (inclusivo) e termina (exclusivo). Observação: um período do dia começa às 7h e termina às 19h do mesmo dia, no horário local. Por exemplo, se o fuso horário local for UTC-7, o intervalo diurno começará às 14:00:00.000Z e terminará às 02:00:00.000Z do dia seguinte. Já o intervalo noturno começará às 02:00:00.000Z do dia seguinte e terminará às 14:00:00.000Z do mesmo dia.
weatherCondition

object (WeatherCondition)

A condição climática prevista.
precipitation

object (Precipitation)

A precipitação prevista.
wind

object (Wind)

A direção média do vento e a velocidade máxima e rajada.
iceThickness

object (IceThickness)

A quantidade acumulada de gelo para a parte do dia.
relativeHumidity

integer

A porcentagem prevista de umidade relativa (valores de 0 a 100).
uvIndex

integer

O índice máximo previsto de raios ultravioleta (UV).
thunderstormProbability

integer

A probabilidade média de tempestade de raios e trovões.
cloudCover

integer

Porcentagem média de cobertura de nuvens.

SunEvents

Representa os eventos relacionados ao sol (por exemplo, nascer e pôr do sol).

Representação JSON 
{
  "sunriseTime": string,
  "sunsetTime": string
}
Campos
sunriseTime

string (Timestamp format)

O horário em que o sol nasce.

OBSERVAÇÃO: em alguns casos únicos (por exemplo, ao norte do círculo ártico), pode não haver horário de nascer do sol em um dia. Nesses casos, esse campo não será definido.

Usa o padrão RFC 3339, em que a saída gerada é sempre convertida em Z e tem 0, 3, 6 ou 9 dígitos fracionários. Além de "Z", outros ajustes também são aceitos. Exemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
sunsetTime

string (Timestamp format)

O horário em que o sol se põe.

OBSERVAÇÃO: em alguns casos específicos (por exemplo, ao norte do círculo ártico), pode não haver horário de pôr do sol em um dia. Nesses casos, esse campo não será definido.

Usa o padrão RFC 3339, em que a saída gerada é sempre convertida em Z e tem 0, 3, 6 ou 9 dígitos fracionários. Além de "Z", outros ajustes também são aceitos. Exemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".

MoonEvents

Representa os eventos relacionados à lua (por exemplo, nascer e pôr da lua).

Representação JSON 
{
  "moonriseTimes": [
    string
  ],
  "moonsetTimes": [
    string
  ],
  "moonPhase": enum (MoonPhase)
}
Campos
moonriseTimes[]

string (Timestamp format)

O momento em que o limbo superior da lua aparece acima do horizonte. Consulte https://en.wikipedia.org/wiki/Moonrise_and_moonset).

OBSERVAÇÃO: na maioria dos casos, há um único horário de nascer da lua por dia. Em outros casos, a lista pode estar vazia (por exemplo, quando a lua nasce depois da meia-noite do dia seguinte). No entanto, em casos únicos (por exemplo, nas regiões polares), a lista pode conter mais de um valor. Nesses casos, os valores são classificados em ordem crescente.

Usa o padrão RFC 3339, em que a saída gerada é sempre convertida em Z e tem 0, 3, 6 ou 9 dígitos fracionários. Além de "Z", outros ajustes também são aceitos. Exemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
moonsetTimes[]

string (Timestamp format)

O momento em que o limbo superior da Lua desaparece abaixo do horizonte (consulte https://en.wikipedia.org/wiki/Moonrise_and_moonset).

OBSERVAÇÃO: na maioria dos casos, há um único horário de pôr da lua por dia. Em outros casos, a lista pode estar vazia (por exemplo, quando a lua se põe depois da meia-noite do dia seguinte). No entanto, em casos únicos (por exemplo, nas regiões polares), a lista pode conter mais de um valor. Nesses casos, os valores são classificados em ordem crescente.

Usa o padrão RFC 3339, em que a saída gerada é sempre convertida em Z e tem 0, 3, 6 ou 9 dígitos fracionários. Além de "Z", outros ajustes também são aceitos. Exemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
moonPhase

enum (MoonPhase)

A fase da lua (também conhecida como fase lunar).

MoonPhase

Marca a fase da lua (também conhecida como fase lunar).

Tipos enumerados
MOON_PHASE_UNSPECIFIED Fase da lua não especificada.
NEW_MOON A Lua não é iluminada pelo Sol.
WAXING_CRESCENT A Lua é iluminada de 0% a 50% no lado direito no hemisfério norte 🌒 e no lado esquerdo no hemisfério sul 🌘.
FIRST_QUARTER A Lua está iluminada em 50,1% no lado direito no hemisfério norte 🌓 e no lado esquerdo no hemisfério sul 🌗.
WAXING_GIBBOUS A Lua é iluminada em 50% a 100% no lado direito no hemisfério norte 🌔 e no lado esquerdo no hemisfério sul 🌖.
FULL_MOON A Lua está totalmente iluminada.
WANING_GIBBOUS A Lua é iluminada em 50% a 100% no lado esquerdo no hemisfério norte 🌖 e no lado direito no hemisfério sul 🌔.
LAST_QUARTER A Lua está iluminada em 50,1% no lado esquerdo no hemisfério norte 🌗 e no lado direito no hemisfério sul 🌓.
WANING_CRESCENT A Lua é iluminada em 0% a 50% no lado esquerdo no hemisfério norte 🌘 e no lado direito no hemisfério sul 🌒.