Method: forecast.hours.lookup

Retorna até 240 horas de previsões por hora em um determinado local, começando da hora 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 do tempo por hora.
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 horária 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 subsequente.
hours

integer

Opcional. Limita a quantidade total de horas a serem buscadas a partir da hora 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 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 horária, 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 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

ForecastHour

Representa um registro de previsão horária 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 (em horário UTC) em que esses dados de previsão são válidos. Os carimbos de data/hora são arredondados para baixo até a hora mais próxima.
displayDateTime

object (DateTime)

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

object (WeatherCondition)

A condição climática prevista.
temperature

object (Temperature)

A temperatura prevista.
feelsLikeTemperature

object (Temperature)

A medida de como a temperatura vai parecer no local solicitado.
dewPoint

object (Temperature)

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

object (Temperature)

A temperatura prevista do índice de calor.
windChill

object (Temperature)

A sensação térmica prevista, a temperatura do ar exposta na pele.
wetBulbTemperature

object (Temperature)

A temperatura de bulbo úmido prevista, que é a temperatura mais baixa que pode ser alcançada pela evaporação da água.
precipitation

object (Precipitation)

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

object (AirPressure)

As condições de pressão atmosférica previstas.
wind

object (Wind)

As condições de vento previstas.
visibility

object (Visibility)

A visibilidade prevista.
iceThickness

object (IceThickness)

A espessura prevista do gelo.
isDaytime

boolean

Verdadeiro se a hora estiver entre o nascer do sol (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: essa hora será considerada como dia ou noite se o intervalo se cruzar com os horários locais de nascer e pôr do sol, respectivamente. Por exemplo, se o intervalo for das 5h às 6h e o nascer do sol for às 5h59, 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 prevista de tempestade (valores de 0 a 100).
cloudCover

integer

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