Method: forecast.hours.lookup

Devuelve hasta 240 horas de pronósticos por hora en una ubicación determinada, a partir de la hora actual.

Solicitud HTTP

GET https://weather.googleapis.com/v1/forecast/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 obtendrá el pronóstico por hora.
unitsSystem

enum (UnitsSystem)

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

integer

Opcional. Es la cantidad máxima de registros de previsión por hora que se devolverá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. Es un token de página que se recibió de una solicitud anterior. Se usa para recuperar la página siguiente.
hours

integer

Opcional. Limita la cantidad de horas totales que se recuperarán a partir de la hora actual. El valor debe ser de 1 a 240 (inclusive). El valor predeterminado es el valor máximo permitido de 240.
languageCode

string

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

Cuerpo de la solicitud

El cuerpo de la solicitud debe estar vacío.

Cuerpo de la respuesta

Es la 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 
{
  "forecastHours": [
    {
      object (ForecastHour)
    }
  ],
  "timeZone": {
    object (TimeZone)
  },
  "nextPageToken": string
}
Campos
forecastHours[]

object (ForecastHour)

Registros de previsión por hora, según la cantidad de horas y el tamaño de la página especificados en la solicitud.
timeZone

object (TimeZone)

Zona horaria en 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

ForecastHour

Representa un registro de previsión 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 de previsión (las marcas de tiempo se redondean a la hora más cercana).
displayDateTime

object (DateTime)

Fecha y hora locales en la zona horaria de la ubicación (hora civil) para la que se calcula este pronóstico por hora. Este campo se puede usar para mostrar información en el cliente. Nota: Esta fecha constará del año, el mes, el día, la hora y el desplazamiento desde UTC.
weatherCondition

object (WeatherCondition)

Es la condición climática pronosticada.
temperature

object (Temperature)

Es la temperatura pronosticada.
feelsLikeTemperature

object (Temperature)

Es la medida de cómo se sentirá la temperatura en la ubicación solicitada.
dewPoint

object (Temperature)

Es la temperatura del punto de condensación pronosticada.
heatIndex

object (Temperature)

Es la temperatura de sensación térmica prevista.
windChill

object (Temperature)

Es la sensación térmica pronosticada, es decir, la temperatura del aire a la que se expone la piel.
wetBulbTemperature

object (Temperature)

Es la temperatura de la bombilla húmeda prevista, la temperatura más baja que se puede alcanzar evaporando agua.
precipitation

object (Precipitation)

La probabilidad de precipitación prevista y la cantidad de precipitación acumulada durante la última hora.
airPressure

object (AirPressure)

Son las condiciones de presión atmosférica pronosticadas.
wind

object (Wind)

Son las condiciones de viento pronosticadas.
visibility

object (Visibility)

Es la visibilidad prevista.
iceThickness

object (IceThickness)

Es el grosor del hielo previsto.
isDaytime

boolean

Es verdadero si esta hora se encuentra entre las horas locales del amanecer (inclusive) y el atardecer (exclusive). De lo contrario, es de noche (entre la puesta del sol y el siguiente amanecer). Nota: Esta hora se considerará 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., entonces isDaytime será verdadero).
relativeHumidity

integer

Porcentaje previsto de humedad relativa (valores del 0 al 100).
uvIndex

integer

Es el índice de radiación ultravioleta (UV) previsto.
thunderstormProbability

integer

Es la probabilidad pronosticada de tormenta eléctrica (valores de 0 a 100).
cloudCover

integer

Es el porcentaje previsto del cielo cubierto por nubes (valores de 0 a 100).