Method: history.hours.lookup

Retorna até 24 horas de dados meteorológicos históricos 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 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 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 subsequente.
hours

integer

Opcional. Limita a quantidade total de horas a serem buscadas 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 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 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

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 horário UTC) em que esses dados históricos 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 as quais este registro por hora é calculado. 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 histórica.
temperature

object (Temperature)

A temperatura histórica.
feelsLikeTemperature

object (Temperature)

A medida de como a temperatura estava no local solicitado.
dewPoint

object (Temperature)

A temperatura histórica do ponto de condensação.
heatIndex

object (Temperature)

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

object (Temperature)

O histórico de sensação térmica, temperatura do ar exposta na pele.
wetBulbTemperature

object (Temperature)

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

object (Precipitation)

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

object (AirPressure)

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

object (Wind)

As condições históricas de 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 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 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 tempestade (valores de 0 a 100).
cloudCover

integer

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