- Solicitud HTTP
- Parámetros de búsqueda
- Cuerpo de la solicitud
- Cuerpo de la respuesta
- Permisos de autorización
- HistoryHour
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 |
Obligatorio. Es la ubicación para la que se obtienen los datos históricos por hora. |
units |
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). |
page |
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. |
page |
Opcional. Un token de página recibido de una solicitud anterior. Se usa para recuperar la página siguiente. |
hours |
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. |
language |
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 ( |
Campos | |
---|---|
history |
Los registros históricos por hora, según la cantidad de horas y el tamaño de la página especificados en la solicitud |
time |
La zona horaria de la ubicación solicitada. |
next |
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 ( |
Campos | |
---|---|
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). |
display |
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. |
weather |
La condición climática histórica. |
temperature |
La temperatura histórica |
feels |
Es la medida de cómo se sintió la temperatura en la ubicación solicitada. |
dew |
La temperatura del punto de condensación histórica. |
heat |
La temperatura histórica del índice de calor |
wind |
El enfriamiento por viento histórico, la temperatura del aire expuesta a la piel. |
wet |
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 |
La probabilidad histórica de precipitaciones y la cantidad de precipitaciones acumuladas durante la última hora. |
air |
Las condiciones históricas de presión del aire |
wind |
Las condiciones históricas del viento |
visibility |
La visibilidad histórica. |
ice |
El grosor histórico del hielo. |
is |
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). |
relative |
Es el porcentaje histórico de humedad relativa (valores de 0 a 100). |
uv |
El índice ultravioleta (UV) histórico. |
thunderstorm |
La probabilidad histórica de tormentas eléctricas (valores de 0 a 100) |
cloud |
Es el porcentaje histórico del cielo cubierto de nubes (valores de 0 a 100). |