Method: lookupWeather

Busca las condiciones climáticas de una ubicación.

Solicitud HTTP

POST https://mapstools.googleapis.com/v1alpha:lookupWeather

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

Cuerpo de la solicitud

El cuerpo de la solicitud contiene datos con la siguiente estructura:

Representación JSON 
{
  "unitsSystem": enum (UnitsSystem),
  "location": {
    object (Location)
  },
  "capabilities": [
    enum (Capability)
  ],
  "date": {
    object (Date)
  },
  "hour": integer,
  "languageCode": string,
  "weatherOptions": {
    object (WeatherOptions)
  },
  "airQualityOptions": {
    object (AirQualityOptions)
  }
}
Campos
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).
location

object (Location)

Obligatorio. La ubicación de la que se obtendrán las condiciones climáticas.
capabilities[]

enum (Capability)

Opcional. Son las capacidades ambientales que se incluirán en la respuesta.
date

object (Date)

Opcional. Especifica la fecha de la información ambiental solicitada, en relación con la zona horaria local de la ubicación especificada en el campo location. Los períodos admitidos dependen de las capacidades solicitadas: - WEATHER: hasta 24 horas en el pasado (cuando también se establece hour) y hasta 10 días (240 horas) en el futuro (desde hoy hasta +9 días para las previsiones diarias). - AIR_QUALITY: hasta 30 días (720 horas) en el pasado y hasta 4 días (96 horas) en el futuro. - POLLEN: desde hoy hasta +4 días (hasta 5 días, incluido hoy; no se admiten fechas históricas).
hour

integer

Opcional. Especifica la hora de la información ambiental solicitada, en formato de 24 horas (0-23), en relación con la zona horaria local de la ubicación especificada en el campo location. Requiere que se especifique date. Los rangos por hora admitidos dependen de las funciones solicitadas: - WEATHER: hasta 24 horas en el pasado y hasta 240 horas (10 días) en el futuro. - AIR_QUALITY: hasta 30 días (720 horas) en el pasado y hasta 4 días (96 horas) en el futuro. POLLEN: Solo devuelve previsiones diarias; hour se ignora para el polen.
languageCode

string

Opcional. Es el código de idioma BCP-47 para el texto localizado en la respuesta (p.ej., "en", "ja", "fr-CA"). Si no se especifica, el valor predeterminado es "en".
weatherOptions

object (WeatherOptions)

Opcional. Opciones específicas para las solicitudes de clima. weatherOptions.units_system se admite junto con unitsSystem de nivel superior (etiqueta 4) para preservar la retrocompatibilidad con los emisores existentes. Devuelve INVALID_ARGUMENT si ambos especifican sistemas de unidades en conflicto. Se ignora si no se solicita WEATHER en capabilities.
airQualityOptions

object (AirQualityOptions)

Opcional. Son opciones específicas para las solicitudes de calidad del aire. Se ignora si no se solicita AIR_QUALITY en capabilities.

Cuerpo de la respuesta

Si se ejecuta de forma correcta, el cuerpo de la respuesta contiene una instancia de LookupWeatherResponse.

Permisos de autorización

Requiere el siguiente alcance de OAuth:

  • https://www.googleapis.com/auth/maps-platform.mapstools