Method: forecast.days.lookup

Devuelve hasta 10 días de pronósticos diarios 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. Es la ubicación para la que se obtendrá el pronóstico diario.
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 pronóstico diario que se devolverán por página, con un valor de 1 a 10 (inclusive). El valor predeterminado es 5.
pageToken

string

Opcional. Es un token de página que se recibió de una solicitud anterior. Se usa para recuperar la página siguiente.
days

integer

Opcional. Limita la cantidad de días totales que se recuperarán a partir del día actual. El valor debe ser 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 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 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)

Son los registros de previsión diaria, según la cantidad de días 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

ForecastDay

Representa un registro de previsión diaria 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)
  }
}
Campos
interval

object (Interval)

Es el intervalo de tiempo en UTC en el que comienza (inclusive) y termina (exclusive) este día previsto. 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)

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 mostrar información en el cliente.
daytimeForecast

object (ForecastDayPart)

Son las condiciones climáticas pronosticadas para la parte diurna del día (de 7 a.m. a 7 p.m., hora local).
nighttimeForecast

object (ForecastDayPart)

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

object (Temperature)

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)

La sensación térmica máxima (alta) durante el día.
feelsLikeMinTemperature

object (Temperature)

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

object (Temperature)

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

object (SunEvents)

Son los eventos relacionados con el sol (p.ej., amanecer, atardecer).
moonEvents

object (MoonEvents)

Son los eventos relacionados con la Luna (p.ej., salida y puesta de la Luna).

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 previsión para una parte del día.

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

object (Interval)

Fecha y hora en UTC en que comienza (inclusive) y finaliza (exclusive) esta parte del día. Nota: Una parte del 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 de ese mismo día.
weatherCondition

object (WeatherCondition)

Condición climática pronosticada.
precipitation

object (Precipitation)

Es la precipitación pronosticada.
wind

object (Wind)

La dirección promedio del viento y la velocidad máxima y las ráfagas
iceThickness

object (IceThickness)

Es la cantidad acumulada de hielo para la parte del día.
relativeHumidity

integer

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

integer

Es el índice ultravioleta (UV) previsto más alto.
thunderstormProbability

integer

Es la probabilidad promedio de tormenta eléctrica.
cloudCover

integer

Porcentaje promedio de cobertura de nubes.

SunEvents

Representa los eventos relacionados con el sol (p.ej., amanecer, atardecer).

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

string (Timestamp format)

Es la hora en que sale el sol.

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

Usa el formato RFC 3339, en el que el resultado generado siempre estará normalizada a Z y usa 0, 3, 6 o 9 dígitos fraccionarios. También se aceptan otras compensaciones que no sean “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)

Es la hora en que se pone el sol.

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

Usa el formato RFC 3339, en el que el resultado generado siempre estará normalizada a Z y usa 0, 3, 6 o 9 dígitos fraccionarios. También se aceptan otras compensaciones que no sean “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 y 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á una sola hora de salida de la Luna por día. En otros casos, la lista podría 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 el formato RFC 3339, en el que el resultado generado siempre estará normalizada a Z y usa 0, 3, 6 o 9 dígitos fraccionarios. También se aceptan otras compensaciones que no sean “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)

Es el momento en que el extremo 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 puesta de la Luna por día. En otros casos, la lista podría estar vacía (p.ej., cuando la luna se oculta 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 el formato RFC 3339, en el que el resultado generado siempre estará normalizada a Z y usa 0, 3, 6 o 9 dígitos fraccionarios. También se aceptan otras compensaciones que no sean “Z”. Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
moonPhase

enum (MoonPhase)

Fase lunar (también conocida como fase de la Luna)

MoonPhase

Marca la fase lunar.

Enums
MOON_PHASE_UNSPECIFIED Fase lunar no especificada.
NEW_MOON La Luna no está iluminada por el Sol.
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 🌒.