Method: history.hours.lookup

Retorna até 24 horas de dados históricos meteorológicos por hora em um determinado local, começando pela última hora.

Solicitação HTTP

GET https://weather.googleapis.com/v1/history/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 os dados históricos por 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 históricos 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 da última hora: de 1 a 24 (inclusive). O padrão é o valor máximo permitido de 24.
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 
{
  "historyHours": [
    {
      object (HistoryHour)
    }
  ],
  "timeZone": {
    object (TimeZone)
  },
  "nextPageToken": string
}
Campos
historyHours[]

object (HistoryHour)

Os registros históricos 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

HistoryHour

Representa um registro de histórico por 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 (em UTC) em que esses dados históricos 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 (tempo civil) para o qual esse registro por hora é calculado. 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)

As condições climáticas históricas.
temperature

object (Temperature)

A temperatura histórica.
feelsLikeTemperature

object (Temperature)

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

object (Temperature)

A temperatura histórica do ponto de orvalho.
heatIndex

object (Temperature)

A temperatura histórica do índice de calor.
windChill

object (Temperature)

O vento frio histórico, a temperatura do ar exposto na pele.
wetBulbTemperature

object (Temperature)

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

object (Precipitation)

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

object (AirPressure)

As condições históricas da pressão do ar.
wind

object (Wind)

As condições históricas do vento.
visibility

object (Visibility)

A visibilidade histórica.
iceThickness

object (IceThickness)

A espessura histórica do gelo.
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 histórica de umidade relativa (valores de 0 a 100).
uvIndex

integer

O índice ultravioleta (UV) histórico.
thunderstormProbability

integer

A probabilidade histórica de tempestades (valores de 0 a 100).
cloudCover

integer

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