Method: currentConditions.lookup

Devuelve las condiciones climáticas actuales en una ubicación determinada.

Solicitud HTTP

GET https://weather.googleapis.com/v1/currentConditions: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án las condiciones climáticas actuales.

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).

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 el RPC de currentConditions.lookup, que representa las condiciones climáticas actuales en la ubicación solicitada.

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

Representación JSON
{
  "currentTime": string,
  "timeZone": {
    object (TimeZone)
  },
  "weatherCondition": {
    object (WeatherCondition)
  },
  "temperature": {
    object (Temperature)
  },
  "feelsLikeTemperature": {
    object (Temperature)
  },
  "dewPoint": {
    object (Temperature)
  },
  "heatIndex": {
    object (Temperature)
  },
  "windChill": {
    object (Temperature)
  },
  "precipitation": {
    object (Precipitation)
  },
  "airPressure": {
    object (AirPressure)
  },
  "wind": {
    object (Wind)
  },
  "visibility": {
    object (Visibility)
  },
  "currentConditionsHistory": {
    object (CurrentConditionsHistory)
  },
  "isDaytime": boolean,
  "relativeHumidity": integer,
  "uvIndex": integer,
  "thunderstormProbability": integer,
  "cloudCover": integer
}
Campos
currentTime

string (Timestamp format)

Hora actual (UTC) asociada a los datos devueltos.

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".

timeZone

object (TimeZone)

Zona horaria en la ubicación solicitada.

weatherCondition

object (WeatherCondition)

Es la condición climática actual.

temperature

object (Temperature)

La temperatura actual

feelsLikeTemperature

object (Temperature)

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

dewPoint

object (Temperature)

Es la temperatura actual del punto de rocío.

heatIndex

object (Temperature)

La temperatura actual de la sensación térmica.

windChill

object (Temperature)

La sensación térmica actual, la temperatura del aire a la que está expuesta la piel.

precipitation

object (Precipitation)

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

airPressure

object (AirPressure)

Las condiciones de presión de aire actuales.

wind

object (Wind)

Las condiciones actuales del viento.

visibility

object (Visibility)

Es la visibilidad actual.

currentConditionsHistory

object (CurrentConditionsHistory)

Son los cambios en las condiciones actuales durante las últimas 24 horas.

isDaytime

boolean

Es verdadero si la hora actual en la ubicación solicitada se encuentra entre la hora local del amanecer (inclusive) y la hora del atardecer (exclusive). De lo contrario, es de noche (entre la puesta del sol y el siguiente amanecer).

relativeHumidity

integer

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

uvIndex

integer

Es el índice ultravioleta (UV) actual.

thunderstormProbability

integer

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

cloudCover

integer

Porcentaje actual del cielo cubierto por nubes (valores de 0 a 100).

Permisos de autorización

Requiere el siguiente alcance de OAuth:

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

CurrentConditionsHistory

Representa un conjunto de cambios en las condiciones actuales durante las últimas 24 horas.

Representación JSON
{
  "temperatureChange": {
    object (Temperature)
  },
  "maxTemperature": {
    object (Temperature)
  },
  "minTemperature": {
    object (Temperature)
  },
  "snowQpf": {
    object (QuantitativePrecipitationForecast)
  },
  "qpf": {
    object (QuantitativePrecipitationForecast)
  }
}
Campos
temperatureChange

object (Temperature)

Es la temperatura actual menos la temperatura de hace 24 horas.

maxTemperature

object (Temperature)

La temperatura máxima (alta) en las últimas 24 horas.

minTemperature

object (Temperature)

La temperatura mínima (baja) en las últimas 24 horas.

snowQpf

object (QuantitativePrecipitationForecast)

Cantidad de nieve, medida como equivalente de agua líquida, que se acumuló en las últimas 24 horas. Nota: QPF es la abreviatura de pronóstico cuantitativo de precipitaciones (consulta la definición de QuantitativePrecipitationForecast para obtener más detalles).

qpf

object (QuantitativePrecipitationForecast)

Es la cantidad de lluvia acumulada en las últimas 24 horas, medida como equivalente de agua líquida. Nota: QPF es la abreviatura de pronóstico cuantitativo de precipitaciones (consulta la definición de QuantitativePrecipitationForecast para obtener más detalles).