Method: forecast.days.lookup

Muestra hasta 10 días de previsiones diarias en una ubicación determinada, a partir del día actual.

Solicitud HTTP

GET https://weather.googleapis.com/v1/forecast/days:lookup

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

Parámetros de consulta

Parámetros
location

object (LatLng)

Obligatorio. La ubicación para la que deseas obtener el pronóstico diario.
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 de pronóstico diario que se mostrarán por página (un valor de 1 a 10 inclusive). El valor predeterminado es 5.
pageToken

string

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

integer

Opcional. Limita la cantidad total de días que se recuperarán a partir del día actual (un valor de 1 a 10 inclusive). El valor predeterminado es el valor máximo permitido de 10.
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 days.lookup.

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

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

object (ForecastDay)

Los registros del pronóstico diario, según la cantidad de días 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

ForecastDay

Representa un registro del pronóstico diario en una ubicación determinada.

Representación JSON 
{
  "interval": {
    object (Interval)
  },
  "displayDate": {
    object (Date)
  },
  "daytimeForecast": {
    object (ForecastDayPart)
  },
  "nighttimeForecast": {
    object (ForecastDayPart)
  },
  "maxTemperature": {
    object (Temperature)
  },
  "minTemperature": {
    object (Temperature)
  },
  "feelsLikeMaxTemperature": {
    object (Temperature)
  },
  "feelsLikeMinTemperature": {
    object (Temperature)
  },
  "maxHeatIndex": {
    object (Temperature)
  },
  "sunEvents": {
    object (SunEvents)
  },
  "moonEvents": {
    object (MoonEvents)
  },
  "iceThickness": {
    object (IceThickness)
  }
}
Campos
interval

object (Interval)

Es el intervalo de tiempo UTC en el que comienza (inclusive) y termina (exclusivamente) este día pronosticado. Nota: Un día comienza a las 7 a.m. y termina a las 7 a.m. del día siguiente, hora local. Por ejemplo, si la zona horaria local es UTC-7, el intervalo comenzará a la hora 14:00:00.000Z y finalizará a la misma hora del día siguiente.
displayDate

object (Date)

Es la fecha local en la zona horaria de la ubicación (hora civil) para la que se calcula este pronóstico diario. Este campo se puede usar para mostrarse en el cliente.
daytimeForecast

object (ForecastDayPart)

Las condiciones climáticas previstas para la parte del día (de 7 a.m. a 7 p.m., hora local).
nighttimeForecast

object (ForecastDayPart)

Las condiciones climáticas pronosticadas para la parte nocturna del día (de 7:00 p.m. a 7:00 a.m. del día siguiente, hora local)
maxTemperature

object (Temperature)

Es la temperatura máxima (alta) durante el día.
minTemperature

object (Temperature)

Es la temperatura mínima (baja) durante el día.
feelsLikeMaxTemperature

object (Temperature)

Es la temperatura máxima (alta) que se siente durante el día.
feelsLikeMinTemperature

object (Temperature)

Es la temperatura mínima (baja) de la sensación térmica durante el día.
maxHeatIndex

object (Temperature)

Es la temperatura máxima del índice de calor durante el día.
sunEvents

object (SunEvents)

Los eventos relacionados con el sol (p.ej., salida del sol, puesta del sol).
moonEvents

object (MoonEvents)

Son los eventos relacionados con la luna (p.ej., salida de la luna, puesta de la luna).
iceThickness

object (IceThickness)

Es la cantidad acumulada de hielo durante todo el día.

Fecha

Representa una fecha de calendario completa o parcial, como un cumpleaños. La hora del día y la zona horaria se especifican en otro lugar o son insignificantes. La fecha está relacionada con el calendario gregoriano. Puede representar una de las siguientes opciones:

  • Una fecha completa con valores para el año, mes y día que no sean cero.
  • Un mes y un día, con cero año (por ejemplo, un aniversario).
  • Un año por sí solo, con un mes cero y un día cero.
  • Es un año y un mes, con un día cero (por ejemplo, la fecha de vencimiento de una tarjeta de crédito).

Tipos relacionados:

Representación JSON 
{
  "year": integer,
  "month": integer,
  "day": integer
}
Campos
year

integer

Año de la fecha. Debe ser entre 1 y 9,999, o bien 0 para especificar una fecha sin año.
month

integer

Mes del año. Debe ser del 1 al 12 o 0 para especificar un año sin un mes ni un día.
day

integer

Día del mes. Debe ser entre 1 y 31 y ser válido para el año y el mes o bien 0 para especificar un año solo o un año y un mes en los que el día no sea significativo.

ForecastDayPart

Representa un registro de pronóstico para una parte del día.

Representación JSON 
{
  "interval": {
    object (Interval)
  },
  "weatherCondition": {
    object (WeatherCondition)
  },
  "precipitation": {
    object (Precipitation)
  },
  "wind": {
    object (Wind)
  },
  "relativeHumidity": integer,
  "uvIndex": integer,
  "thunderstormProbability": integer,
  "cloudCover": integer
}
Campos
interval

object (Interval)

Es la fecha y hora (en UTC) en que comienza (inclusive) y termina (exclusivamente) esta parte del día. Nota: Una parte de un día comienza a las 7 a.m. y termina a las 7 p.m. del mismo día, hora local. Por ejemplo, si la zona horaria local es UTC-7, el intervalo diurno comenzará a la hora 14:00:00.000Z y finalizará a las 02:00:00.000Z del día siguiente, y el intervalo nocturno comenzará a las 02:00:00.000Z del día siguiente y finalizará a las 14:00:00.000Z ese mismo día.
weatherCondition

object (WeatherCondition)

Las condiciones climáticas previstas
precipitation

object (Precipitation)

Las precipitaciones previstas.
wind

object (Wind)

La dirección del viento promedio, la velocidad máxima y la ráfaga
relativeHumidity

integer

Es el porcentaje previsto de humedad relativa (valores de 0 a 100).
uvIndex

integer

El índice ultravioleta (UV) máximo previsto.
thunderstormProbability

integer

La probabilidad promedio de tormentas eléctricas.
cloudCover

integer

Porcentaje promedio de cobertura de nubes.

SunEvents

Representa los eventos relacionados con el sol (p.ej., salida del sol, puesta del sol).

Representación JSON 
{
  "sunriseTime": string,
  "sunsetTime": string
}
Campos
sunriseTime

string (Timestamp format)

La hora en la que sale el sol.

NOTA: En algunos casos excepcionales (p.ej., al norte del círculo ártico), es posible que no haya un horario de salida del sol durante un día. En estos casos, no se establecerá este campo.

Usa RFC 3339, en el que el resultado generado siempre se normalizará en Z y usará 0, 3, 6 o 9 dígitos fraccionarios. También se aceptan compensaciones distintas de "Z". Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
sunsetTime

string (Timestamp format)

La hora en que se pone el sol.

NOTA: En algunos casos únicos (p.ej., al norte del círculo ártico), es posible que no haya hora de puesta del sol durante un día. En estos casos, no se establecerá este campo.

Usa RFC 3339, en el que el resultado generado siempre se normalizará en Z y usará 0, 3, 6 o 9 dígitos fraccionarios. También se aceptan compensaciones distintas de "Z". Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".

MoonEvents

Representa los eventos relacionados con la luna (p.ej., salida de la luna, puesta de la luna).

Representación JSON 
{
  "moonriseTimes": [
    string
  ],
  "moonsetTimes": [
    string
  ],
  "moonPhase": enum (MoonPhase)
}
Campos
moonriseTimes[]

string (Timestamp format)

Es el momento en que el limbo superior de la luna aparece sobre el horizonte (consulta https://en.wikipedia.org/wiki/Moonrise_and_moonset).

NOTA: En la mayoría de los casos, habrá un solo horario de salida de la luna por día. En otros casos, la lista puede estar vacía (p.ej., cuando la luna sale después de la medianoche del día siguiente). Sin embargo, en casos únicos (p.ej., en regiones polares), la lista puede contener más de un valor. En estos casos, los valores se ordenan de forma ascendente.

Usa RFC 3339, en el que el resultado generado siempre se normalizará en Z y usará 0, 3, 6 o 9 dígitos fraccionarios. También se aceptan compensaciones distintas de "Z". Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
moonsetTimes[]

string (Timestamp format)

El momento en que el borde superior de la luna desaparece tras el horizonte (consulta https://en.wikipedia.org/wiki/Moonrise_and_moonset).

NOTA: En la mayoría de los casos, habrá una sola hora de configuración de la luna por día. En otros casos, la lista puede estar vacía (p.ej., cuando la luna se pone después de la medianoche del día siguiente). Sin embargo, en casos únicos (p.ej., en regiones polares), la lista puede contener más de un valor. En estos casos, los valores se ordenan de forma ascendente.

Usa RFC 3339, en el que el resultado generado siempre se normalizará en Z y usará 0, 3, 6 o 9 dígitos fraccionarios. También se aceptan compensaciones distintas de "Z". Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
moonPhase

enum (MoonPhase)

La fase lunar (también conocida como fase lunar).

MoonPhase

Marca la fase lunar.

Enumeraciones
MOON_PHASE_UNSPECIFIED Fase lunar no especificada.
NEW_MOON El Sol no ilumina la Luna.
WAXING_CRESCENT La Luna se ilumina entre un 0% y un 50% en su lado derecho en el hemisferio norte 🌒 y en su lado izquierdo en el hemisferio sur 🌘.
FIRST_QUARTER La luna está iluminada en un 50.1% en su lado derecho en el hemisferio norte 🌓 y en su lado izquierdo en el hemisferio sur 🌗.
WAXING_GIBBOUS La luna se ilumina entre un 50% y un 100% en su lado derecho en el hemisferio norte 🌔 y en su lado izquierdo en el hemisferio sur 🌖.
FULL_MOON La luna está completamente iluminada.
WANING_GIBBOUS La luna se ilumina entre un 50% y un 100% en su lado izquierdo en el hemisferio norte 🌖 y en su lado derecho en el hemisferio sur 🌔.
LAST_QUARTER La luna está iluminada en un 50.1% en su lado izquierdo en el hemisferio norte 🌗 y en su lado derecho en el hemisferio sur 🌓.
WANING_CRESCENT La luna se ilumina entre un 0% y un 50% en su lado izquierdo en el hemisferio norte 🌘 y en su lado derecho en el hemisferio sur 🌒.