Method: forecast.days.lookup

Retorna até 10 dias de previsões diárias em um determinado local, a partir do 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 do tempo diária.
unitsSystem

enum (UnitsSystem)

Opcional. O sistema de unidades a ser usado para as condições meteorológicas retornadas. Se não forem fornecidos, as condições climáticas retornadas serã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 seguinte.
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 valor máximo permitido de 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 vai 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 para a 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 do 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)
  },
  "iceThickness": {
    object (IceThickness)
  }
}
Campos
interval

object (Interval)

O intervalo de tempo UTC em que o dia previsto começa (inclusive) e termina (exclusivo). 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 (tempo civil) para o qual a 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 no horário local).
nighttimeForecast

object (ForecastDayPart)

As condições climáticas previstas para a parte noturna do dia (das 19h de um dia até as 7h do dia seguinte, no horário local).
maxTemperature

object (Temperature)

A temperatura máxima ao longo do dia.
minTemperature

object (Temperature)

A temperatura mínima durante o dia.
feelsLikeMaxTemperature

object (Temperature)

A temperatura 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 durante o dia.
sunEvents

object (SunEvents)

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

object (MoonEvents)

Os eventos relacionados à lua (por exemplo, lua crescente, lua cheia).
iceThickness

object (IceThickness)

A quantidade acumulada de gelo durante o dia.

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)
  },
  "relativeHumidity": integer,
  "uvIndex": integer,
  "thunderstormProbability": integer,
  "cloudCover": integer
}
Campos
interval

object (Interval)

A data e a hora UTC em que essa parte do dia começa (inclusive) e termina (exclusiva). Observação: uma parte de um 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 vai começar às 14:00:00.000Z e terminar às 02:00:00.000Z do dia seguinte. O intervalo noturno vai começar às 02:00:00.000Z do dia seguinte e terminar às 14:00:00.000Z no 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, a velocidade máxima e a rajada.
relativeHumidity

integer

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

integer

O índice máximo previsto de radiação ultravioleta (UV).
thunderstormProbability

integer

A probabilidade média de tempestade.
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, como ao norte do Círculo Polar Ártico, pode não haver horário de nascer do sol em um dia. Nesses casos, esse campo não será definido.

Usa o RFC 3339, em que a saída gerada é sempre normalizada em Z e usa dígitos fracionários 0, 3, 6 ou 9. Deslocamentos diferentes de "Z" 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 Polar Ártico), pode não haver um horário de pôr do sol para um dia. Nesses casos, esse campo não será definido.

Usa o RFC 3339, em que a saída gerada é sempre normalizada em Z e usa dígitos fracionários 0, 3, 6 ou 9. Deslocamentos diferentes de "Z" 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, em regiões polares), a lista pode conter mais de um valor. Nesses casos, os valores são classificados em ordem crescente.

Usa o RFC 3339, em que a saída gerada é sempre normalizada em Z e usa dígitos fracionários 0, 3, 6 ou 9. Deslocamentos diferentes de "Z" 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 início da lua por dia. Em outros casos, a lista pode estar vazia (por exemplo, quando a lua se põe após a meia-noite do dia seguinte). No entanto, em casos únicos (por exemplo, em regiões polares), a lista pode conter mais de um valor. Nesses casos, os valores são classificados em ordem crescente.

Usa o RFC 3339, em que a saída gerada é sempre normalizada em Z e usa dígitos fracionários 0, 3, 6 ou 9. Deslocamentos diferentes de "Z" 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.

MoonPhase

Marca a fase da lua.

Enums
MOON_PHASE_UNSPECIFIED Fase da lua não especificada.
NEW_MOON A Lua não é iluminada pelo Sol.
WAXING_CRESCENT A Lua está 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% do lado direito no hemisfério norte 🌓 e em 50,1% do lado esquerdo no hemisfério sul 🌗.
WAXING_GIBBOUS A Lua está iluminada de 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 está iluminada de 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% do lado esquerdo no hemisfério norte 🌗 e no lado direito no hemisfério sul 🌓.
WANING_CRESCENT A Lua está iluminada de 0% a 50% no lado esquerdo no hemisfério norte 🌘 e no lado direito no hemisfério sul 🌒.