Method: forecast.hours.lookup

Retorna até 240 horas de previsões por hora em um determinado local, a partir do horário atual.

Solicitação HTTP

GET https://weather.googleapis.com/v1/forecast/hours: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 de hora em hora.
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 por hora a serem retornados por página: um valor de 1 a 24 (inclusive). O padrão é o valor máximo permitido de 24.
pageToken

string

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

integer

Opcional. Limita a quantidade de horas totais a serem extraídas a partir do horário atual: um valor de 1 a 240 (inclusive). O padrão é o valor máximo permitido de 240.
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 hours.lookup.

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

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

object (ForecastHour)

Os registros de previsão por hora, de acordo com o número de horas 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

ForecastHour

Representa um registro de previsão de hora em hora em um determinado local.

Representação JSON 
{
  "interval": {
    object (Interval)
  },
  "displayDateTime": {
    object (DateTime)
  },
  "weatherCondition": {
    object (WeatherCondition)
  },
  "temperature": {
    object (Temperature)
  },
  "feelsLikeTemperature": {
    object (Temperature)
  },
  "dewPoint": {
    object (Temperature)
  },
  "heatIndex": {
    object (Temperature)
  },
  "windChill": {
    object (Temperature)
  },
  "wetBulbTemperature": {
    object (Temperature)
  },
  "precipitation": {
    object (Precipitation)
  },
  "airPressure": {
    object (AirPressure)
  },
  "wind": {
    object (Wind)
  },
  "visibility": {
    object (Visibility)
  },
  "iceThickness": {
    object (IceThickness)
  },
  "isDaytime": boolean,
  "relativeHumidity": integer,
  "uvIndex": integer,
  "thunderstormProbability": integer,
  "cloudCover": integer
}
Campos
interval

object (Interval)

O intervalo de uma hora (no horário UTC) em que esses dados de previsão são válidos (os carimbos de data/hora são arredondados para a hora mais próxima).
displayDateTime

object (DateTime)

A data e a hora local no fuso horário do local (hora civil) para o qual a previsão por hora é calculada. Esse campo pode ser usado para fins de exibição no cliente. Observação: essa data vai consistir em ano, mês, dia, hora e compensação em relação ao UTC.
weatherCondition

object (WeatherCondition)

A previsão do tempo.
temperature

object (Temperature)

A temperatura prevista.
feelsLikeTemperature

object (Temperature)

A medida da sensação térmica no local solicitado.
dewPoint

object (Temperature)

A temperatura do ponto de condensação prevista.
heatIndex

object (Temperature)

A temperatura do índice de calor prevista.
windChill

object (Temperature)

O vento frio previsto, a temperatura do ar exposto na pele.
wetBulbTemperature

object (Temperature)

A temperatura de bulbo úmido prevista, a menor temperatura alcançável pela evaporação da água.
precipitation

object (Precipitation)

A probabilidade de precipitação prevista e a quantidade de precipitação acumulada na última hora.
airPressure

object (AirPressure)

As condições de pressão do ar previstas.
wind

object (Wind)

As condições de vento previstas.
visibility

object (Visibility)

A visibilidade prevista.
iceThickness

object (IceThickness)

A espessura do gelo prevista.
isDaytime

boolean

Verdadeiro se a hora estiver entre o nascer (inclusive) e o pôr-do-sol (exclusivo) locais. Caso contrário, é noite (entre o pôr do sol e o próximo nascer do sol). Observação: esse horário será considerado diurno ou noturno se o intervalo cruzar com os horários de nascer e pôr do sol locais, respectivamente. Por exemplo, se o intervalo for das 5h às 6h e o nascer do sol for às 5h59, o valor de isDaytime será verdadeiro.
relativeHumidity

integer

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

integer

O índice ultravioleta (UV) previsto.
thunderstormProbability

integer

A probabilidade de tempestade prevista (valores de 0 a 100).
cloudCover

integer

A porcentagem prevista do céu coberto por nuvens (valores de 0 a 100).