Method: history.hours.lookup

Muestra hasta 24 horas de datos históricos meteorológicos por hora en una ubicación determinada, a partir de la última hora.

Solicitud HTTP

GET https://weather.googleapis.com/v1/history/hours:lookup

La URL usa la sintaxis de la transcodificación gRPC.

Parámetros de consulta

Parámetros
location

object (LatLng)

Obligatorio. Es la ubicación para la que se obtienen los datos históricos por hora.

unitsSystem

enum (UnitsSystem)

Opcional. Es el sistema de unidades que se usará para las condiciones climáticas que se muestran. Si no se proporciona, las condiciones climáticas que se devuelvan estarán en el sistema métrico (predeterminado = METRIC).

pageSize

integer

Opcional. Es la cantidad máxima de registros históricos por hora que se mostrarán por página (un valor de 1 a 24 inclusive). El valor predeterminado es el valor máximo permitido de 24.

pageToken

string

Opcional. Un token de página recibido de una solicitud anterior. Se usa para recuperar la página siguiente.

hours

integer

Opcional. Limita la cantidad total de horas que se recuperarán a partir de la última hora, de 1 a 24 (inclusive). El valor predeterminado es el valor máximo permitido de 24.

languageCode

string

Opcional. Permite que el cliente elija el idioma de la respuesta. Si no se pueden proporcionar datos para ese idioma, la API usará la coincidencia más cercana. Los valores permitidos se basan en el estándar BCP-47 del IETF. El valor predeterminado es "es-419".

Cuerpo de la solicitud

El cuerpo de la solicitud debe estar vacío.

Cuerpo de la respuesta

Respuesta para la RPC de hours.lookup.

Si se ejecuta correctamente, el cuerpo de la respuesta contendrá datos con la siguiente estructura:

Representación JSON
{
  "historyHours": [
    {
      object (HistoryHour)
    }
  ],
  "timeZone": {
    object (TimeZone)
  },
  "nextPageToken": string
}
Campos
historyHours[]

object (HistoryHour)

Los registros históricos por hora, según la cantidad de horas y el tamaño de la página especificados en la solicitud

timeZone

object (TimeZone)

La zona horaria de la ubicación solicitada.

nextPageToken

string

Es el token para recuperar la página siguiente.

Permisos de autorización

Requiere el siguiente alcance de OAuth:

  • https://www.googleapis.com/auth/cloud-platform

HistoryHour

Representa un registro de historial por hora en una ubicación determinada.

Representación 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)

Es el intervalo de una hora (en hora UTC) para el que son válidos estos datos históricos (las marcas de tiempo se redondean a la hora más cercana).

displayDateTime

object (DateTime)

Es la fecha y hora locales en la zona horaria de la ubicación (hora civil) para la que se calcula este registro por hora. Este campo se puede usar para mostrarse en el cliente. Nota: Esta fecha constará del año, el mes, el día, la hora y el desfase respecto de UTC.

weatherCondition

object (WeatherCondition)

La condición climática histórica.

temperature

object (Temperature)

La temperatura histórica

feelsLikeTemperature

object (Temperature)

Es la medida de cómo se sintió la temperatura en la ubicación solicitada.

dewPoint

object (Temperature)

La temperatura del punto de condensación histórica.

heatIndex

object (Temperature)

La temperatura histórica del índice de calor

windChill

object (Temperature)

El enfriamiento por viento histórico, la temperatura del aire expuesta a la piel.

wetBulbTemperature

object (Temperature)

La temperatura de la bombilla húmeda histórica, la temperatura más baja que se puede alcanzar con la evaporación del agua.

precipitation

object (Precipitation)

La probabilidad histórica de precipitaciones y la cantidad de precipitaciones acumuladas durante la última hora.

airPressure

object (AirPressure)

Las condiciones históricas de presión del aire

wind

object (Wind)

Las condiciones históricas del viento

visibility

object (Visibility)

La visibilidad histórica.

iceThickness

object (IceThickness)

El grosor histórico del hielo.

isDaytime

boolean

Es verdadero si esta hora está entre el amanecer (inclusivo) y el atardecer (exclusivo) locales. De lo contrario, es de noche (entre el atardecer y el próximo amanecer). Nota: Esta hora se considerará como diurna o nocturna si el intervalo se cruza con las horas locales del amanecer y el atardecer, respectivamente (p. ej., si el intervalo es de 5 a.m. a 6 a.m. y el amanecer es a las 5:59 a.m., isDaytime será verdadero).

relativeHumidity

integer

Es el porcentaje histórico de humedad relativa (valores de 0 a 100).

uvIndex

integer

El índice ultravioleta (UV) histórico.

thunderstormProbability

integer

La probabilidad histórica de tormentas eléctricas (valores de 0 a 100)

cloudCover

integer

Es el porcentaje histórico del cielo cubierto de nubes (valores de 0 a 100).