Obtén una clave de demostración de Maps: Prueba la API de Weather sin costo con una clave de demostración de Maps, sin necesidad de ingresar datos de facturación.

Google utiliza tecnología de IA para traducir contenido a tu idioma preferido. Las traducciones realizadas con IA pueden contener errores.

Method: currentConditions.lookup

Solicitud HTTP
Parámetros de búsqueda
Cuerpo de la solicitud
Cuerpo de la respuesta
- Representación JSON
Permisos de autorización
CurrentConditionsHistory
- Representación JSON
Pruébalo

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

Parámetros
`location`	`object (LatLng)` Obligatorio. 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 que se devuelvan. Si no se proporciona, las condiciones climáticas devueltas se expresarán en el sistema métrico (valor 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".

location

object (LatLng)

Obligatorio. 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 que se devuelvan. Si no se proporciona, las condiciones climáticas devueltas se expresarán en el sistema métrico (valor 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

Respuesta para la RPC 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

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 }

{
  "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)` Es la hora actual (UTC) asociada con los datos que se devuelven. Usa el formato RFC 3339, en el que el resultado generado siempre usará la normalización Z y los dígitos fraccionarios 0, 3, 6 o 9. 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)` La zona horaria de 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)` La temperatura actual del punto de condensación.
`heatIndex`	`object (Temperature)` La temperatura actual del índice de calor
`windChill`	`object (Temperature)` La sensación térmica actual, es decir, la temperatura del aire que se siente en la piel Nota: Este campo devuelve un objeto vacío para las ubicaciones en Japón y Corea del Sur.
`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 actuales de la presión del aire.
`wind`	`object (Wind)` Las condiciones actuales del viento.
`visibility`	`object (Visibility)` La visibilidad actual. Nota: Este campo devuelve un objeto vacío para las ubicaciones en Japón y Corea del Sur.
`currentConditionsHistory`	`object (CurrentConditionsHistory)` 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 el amanecer (inclusive) y el atardecer (excluido) locales. De lo contrario, es de noche (entre el atardecer y el próximo amanecer).
`relativeHumidity`	`integer` Es el porcentaje actual de humedad relativa (valores de 0 a 100).
`uvIndex`	`integer` El índice ultravioleta (UV) actual.
`thunderstormProbability`	`integer` La probabilidad actual de tormenta eléctrica (valores de 0 a 100). Nota: Este campo se omite de la respuesta para las ubicaciones en Japón y Corea del Sur.
`cloudCover`	`integer` Es el porcentaje actual del cielo cubierto por nubes (valores de 0 a 100). Nota: Este campo se omite de la respuesta para las ubicaciones en Japón y Corea del Sur.

Permisos de autorización

Requiere el siguiente permiso de OAuth:

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

CurrentConditionsHistory

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