MCP Tools Reference: mapstools.googleapis.com

Herramienta: lookup_weather

Recupera información ambiental integral para una ubicación, incluidos el clima, la calidad del aire (ICA y contaminantes) y el polen (niveles de alérgenos de especies de árboles, pasto, malezas y plantas): condiciones actuales, pronósticos/historial por hora y pronósticos diarios para el clima y la calidad del aire; el polen solo es un pronóstico diario (desde hoy hasta +4 días, sin datos por hora ni anteriores). Dominios y capacidades ambientales disponibles (capabilities: WEATHER, AIR_QUALITY, POLLEN — CRÍTICO): * Selección explícita obligatoria: DEBES incluir al menos uno de los valores WEATHER, AIR_QUALITY o POLLEN en capabilities en cada llamada. NO se permite omitir capabilities. * Broad / Ambiguous Outdoor Queries (Full Ambient Outdoor Suite): If the user asks a general outdoor, travel, or situational question without restricting to a specific domain (e.g., "What are outdoor conditions like right now for a run?"), explicitly include all three capabilities (capabilities: ["WEATHER", "AIR_QUALITY", "POLLEN"]) to return the complete ambient outdoor suite (Weather + Air Quality + Pollen); for a past date/hour, leave out POLLEN, which has no history. * Selección de dominio segmentado (búsquedas específicas): Si el usuario solicita específicamente solo uno o dos dominios (p.ej., "¿Cuál es el ICA en Seattle en este momento?"), incluye solo las capacidades solicitadas (WEATHER, AIR_QUALITY o POLLEN). Solo se ejecutarán y devolverán los dominios solicitados. Datos específicos disponibles por dominio: * Clima (weather): Temperatura (actual, sensación térmica, máxima/mínima, índice de calor), viento (velocidad, ráfagas, dirección), eventos celestes (amanecer/atardecer, fase lunar), precipitación (tipo, probabilidad, cantidad/QPF) y condiciones atmosféricas (índice UV, humedad, nubosidad, probabilidad de tormentas eléctricas, presión atmosférica). * Calidad del aire (air_quality): Índices de calidad del aire universales y locales (valor del ICA, categoría y contaminante dominante), recomendaciones de salud para 7 grupos de sensibilidad y concentraciones de contaminantes (include_pollutant_concentration: true). Cada índice tiene su propio contaminante dominante; infórmalo por índice (p. ej., no proporciones el contaminante del ICA universal para el ICA de EE.UU.). * Polen (pollen): Índice universal de polen (UPI, 0-5) diario por categoría de árbol, pasto y maleza, y por especie de planta (index.value con su index.category, p.ej., 1 = "Muy bajo"), estado de temporada, reacciones cruzadas y recomendaciones de salud. * Campos de polen faltantes: Si falta un in_season, significa que no está en temporada. Omite las especies de plantas que se devuelvan sin un index, a menos que el usuario pregunte sobre esa planta. En ese caso, di que no se informaron datos de polen para ella hoy (no infieras un nivel). Reglas de ubicación (CRÍTICO): La ubicación de segmentación DEBE especificarse en location con SOLO UNO de los siguientes campos secundarios de oneof: 1. Coordenadas geográficas (lat_lng): Se usan cuando se conocen las coordenadas exactas de latitud y longitud. * Ejemplo: {"location": {"lat_lng": {"latitude": 34.0522, "longitude": -118.2437}}} 2. ID de lugar (place_id): * Un ID de lugar de Google Maps inequívoco (p.ej., obtenido de search_places o resolve_names). * Ejemplo: {"location": {"place_id": "ChIJLU7jZClu5kcR4PcOOO6p3I0"}} 3. Cadena de dirección (address): * Una ciudad o región, un vecindario, un punto de referencia o de interés, una dirección o un código postal, idealmente con la ciudad o el país. * Ejemplo: {"location": {"address": "Paris, France"}} Modos de hora y uso (date y hour, CRÍTICO): * Referencia de zona horaria local: Todas las entradas de date ({year, month, day}) y hour (0-23) DEBEN expresarse en la zona horaria civil local de la location solicitada (p.ej., una consulta para "Paris tomorrow at 13:00" usa la fecha local Europe/Paris y la hora 13), nunca en UTC ni en la zona horaria del emisor. * 1. Condiciones actuales (se omiten date Y hour): * Proporciona location y el capabilities objetivo (WEATHER, AIR_QUALITY, POLLEN). NO especifiques date ni hour. * Devuelve las condiciones actuales (CC) en tiempo real para los dominios solicitados (clima actual, calidad del aire de la hora actual o pronóstico de polen de hoy). * En el caso de la calidad del aire, las condiciones actuales corresponden a una sola hora: NO las uses por sí solas para responder preguntas sobre la calidad del aire o preguntas generales sobre el aire libre para hoy en su totalidad (usa las consultas diarias que se indican a continuación). * 2. Previsión/historial por hora (se especifican date Y hour 0-23): * Proporciona location, date ({year, month, day}), hour (0-23) y el objetivo capabilities. Si se mencionan minutos, redondea hacia abajo a la hora más cercana. * RESTRICCIÓN CRÍTICA (date es OBLIGATORIO cuando se establece hour): NO se permite proporcionar hour sin date (se omite date, se establece hour) y fallará con un error. Incluso cuando el usuario pregunte por una hora específica de hoy (p.ej., "at 13:00 today"), DEBES completar tanto date (la fecha de hoy a las location) como hour. * Ejecuta una búsqueda por hora del clima o la calidad del aire solicitados a las YYYY-MM-DD-HH y una búsqueda diaria del polen solicitado el YYYY-MM-DD. * Preguntas sobre el clima que incluyen "cuándo": Para las preguntas sobre el clima que incluyen cuándo, a qué hora o cuál es el mejor momento (p.ej., "what time will it stop raining?"), usa llamadas por hora a WEATHER (date + hour) para las horas pertinentes. Un pronóstico del clima diario no tiene valores por hora. Para las preguntas generales sobre actividades al aire libre del tipo "cuándo/mejor momento" (p.ej., "when is the best time to go walking today?"), haz estas llamadas por hora de WEATHER, además de la llamada de todo el día para la calidad del aire (y el polen) que se describe en Consultas diarias. * 3. Consultas diarias (date especificado Y hour omitido): * Proporciona location, date ({year, month, day} en la hora civil local de la location solicitada) sin hour y el capabilities objetivo para las consultas de todo el día (p.ej., "weather and pollen in London tomorrow"). * Preguntas sobre la calidad del aire y preguntas generales sobre el aire libre para hoy: Para las preguntas sobre la calidad del aire y las preguntas generales sobre el aire libre (que incluyen la calidad del aire) sobre hoy (p.ej., "how will the air quality change today", "is today a good day for a picnic?"), establece date en la fecha de hoy a las location (hora omitida) para obtener la serie de calidad del aire por hora del día. Una llamada de Current Conditions por sí sola solo devuelve la hora actual de la calidad del aire y no es suficiente. Puedes agregar una si el usuario también pregunta sobre "ahora". * Intervalos de tiempo de la calidad del aire: Para una pregunta sobre la calidad del aire en un intervalo de un día (p.ej., "air quality between noon and 6 PM"), prefiere una llamada diaria para esa fecha y lee las horas del intervalo de la serie de calidad del aire, en lugar de muestrear horas individuales. Si usas llamadas por hora, cubre todas las horas del período. * Muestra las previsiones diarias de los datos de clima o polen solicitados, y las series de calidad del aire por hora del día que abarcan todo el día local (de 00:00 a 23:00, hora local): 24 horas históricas para una fecha pasada, 24 horas previstas para una fecha futura y, para hoy, las horas anteriores (historial), la hora actual y las horas restantes (previsión). Horizontes temporales admitidos por dominio: * Clima: Por hora desde hace 24 horas hasta 240 horas (10 días) en el futuro (las horas pasadas necesitan date y hour); diariamente hasta 10 días, incluido hoy (hoy hasta +9 días); sin historial diario. * Calidad del aire: Por hora, desde hace 720 horas (30 días) hasta 96 horas (4 días) en el futuro; una llamada de día completo debe caber dentro de ese período (en la práctica, hoy −29 días hasta +3 días). * Polen: Solo diario, desde hoy hasta +4 días (5 días, incluido hoy); no hay fechas pasadas y se ignora hour. * (Nota: Si se solicitan varias capacidades y el date/hour está fuera de uno de sus rangos, la llamada se realiza correctamente y solo devuelve las compatibles). * Solicitudes fuera de rango: Si una fecha o una hora solicitadas pueden estar fuera del rango admitido de un dominio (p. ej., polen para una fecha pasada), llama a lookup_weather para la fecha o la hora solicitadas. El error indica el rango admitido. No llames a una fecha, hora o dominio diferente como sustituto. Opciones de dominio y atribución: * Idioma (language_code): Código de idioma BCP-47 opcional (p.ej., "fr"). El valor predeterminado es "en". * Unidades de clima (weather_options.units_system o units_system): El valor predeterminado es METRIC. Establece el valor en IMPERIAL (Fahrenheit/mph) si el usuario hace referencia a los estándares de EE.UU. o solicita explícitamente unidades imperiales. Se admite tanto en weather_options.units_system (preferido) como en units_system de nivel superior. Si se especifican ambos, no deben entrar en conflicto. * Opciones de calidad del aire (air_quality_options): Establece include_pollutant_concentration: true cuando se necesiten concentraciones de contaminantes específicas (PM2.5, PM10, O3, NO2, SO2, CO). De manera opcional, establece index_region_code (código de país ISO de 2 letras, p. ej., "US") para solicitar una escala de ICA regional específica. De forma predeterminada, la respuesta incluye el ICA universal y el ICA regional de la ubicación. * Atribución: El resultado fundamentado DEBE atribuirse a la fuente con el campo attribution dentro de cada contenedor de dominio devuelto (weather.attribution, air_quality.attribution, pollen.attribution). * Horarios devueltos: Los valores de date_time de calidad del aire ya están en la hora local de la ubicación (se incluye utc_offset). Preséntalos tal como están. Los horarios de date_time del clima (actual y por hora) y de salida y puesta del sol están en UTC. Conviértelos a la hora local de la ubicación con time_zone. Etiqueta todas las horas como locales.

En la siguiente muestra de código, se indica cómo usar curl para llamar a la herramienta de MCP lookup_weather.

Solicitud de curl 
curl --location 'https://mapstools.googleapis.com/mcp' \
--header 'content-type: application/json' \
--header 'accept: application/json, text/event-stream' \
--data '{
  "method": "tools/call",
  "params": {
    "name": "lookup_weather",
    "arguments": {
      // Provide these details according to the MCP tool specification.
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

Esquema de entrada

Solicitud para el método LookupWeather, que representa las condiciones climáticas en la ubicación solicitada.

LookupWeatherRequest

Representación JSON 
{
  "unitsSystem": enum (UnitsSystem),
  "location": {
    object (Location)
  },
  "capabilities": [
    enum (Capability)
  ],

  // Union field _date can be only one of the following:
  "date": {
    object (Date)
  }
  // End of list of possible types for union field _date.

  // Union field _hour can be only one of the following:
  "hour": integer
  // End of list of possible types for union field _hour.

  // Union field _language_code can be only one of the following:
  "languageCode": string
  // End of list of possible types for union field _language_code.

  // Union field _weather_options can be only one of the following:
  "weatherOptions": {
    object (WeatherOptions)
  }
  // End of list of possible types for union field _weather_options.

  // Union field _air_quality_options can be only one of the following:
  "airQualityOptions": {
    object (AirQualityOptions)
  }
  // End of list of possible types for union field _air_quality_options.
}
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.

Campo de unión _date.

_date puede ser una de las siguientes opciones:
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).

Campo de unión _hour.

_hour puede ser una de las siguientes opciones:
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.

Campo de unión _language_code.

_language_code puede ser una de las siguientes opciones:
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".

Campo de unión _weather_options.

_weather_options puede ser una de las siguientes opciones:
weatherOptions

object (WeatherOptions)

Opcional. Opciones específicas para las solicitudes de clima. weather_options.units_system se admite junto con units_system 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.

Campo de unión _air_quality_options.

_air_quality_options puede ser una de las siguientes opciones:
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.

Fecha

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.

Ubicación

Representación JSON 
{

  // Union field location_type can be only one of the following:
  "latLng": {
    object (LatLng)
  },
  "placeId": string,
  "address": string
  // End of list of possible types for union field location_type.
}
Campos
Campo de unión location_type. Diferentes formas de representar una ubicación location_type puede ser solo uno de los parámetros siguientes:
latLng

object (LatLng)

Es un punto especificado con coordenadas geográficas.
placeId

string

Es el ID de lugar asociado con la ubicación.
address

string

Dirección legible por humanos (p.ej., dirección, ciudad o código postal).

LatLng

Representación JSON 
{
  "latitude": number,
  "longitude": number
}
Campos
latitude

number

La latitud expresada en grados. Debe pertenecer al rango [-90.0, +90.0].
longitude

number

La longitud expresada en grados. Debe pertenecer al rango [-180.0, +180.0].

WeatherOptions

Representación JSON 
{
  "unitsSystem": enum (UnitsSystem)
}
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).

AirQualityOptions

Representación JSON 
{

  // Union field _include_pollutant_concentration can be only one of the
  // following:
  "includePollutantConcentration": boolean
  // End of list of possible types for union field
  // _include_pollutant_concentration.

  // Union field _index_region_code can be only one of the following:
  "indexRegionCode": string
  // End of list of possible types for union field _index_region_code.
}
Campos

Campo de unión _include_pollutant_concentration.

_include_pollutant_concentration puede ser una de las siguientes opciones:
includePollutantConcentration

boolean

Opcional. Si se establece como verdadero, se incluyen concentraciones detalladas de contaminantes y más información (fuentes y efectos) en la respuesta de calidad del aire.

Campo de unión _index_region_code.

_index_region_code puede ser una de las siguientes opciones:
indexRegionCode

string

Opcional. Es el código de país o región ISO 3166-1 alfa-2 de dos letras (p.ej., "US", "FR", "CN") que se usa para seleccionar la escala preferida del índice de calidad del aire (ICA) local junto con el ICA universal (ICA-U). Si no se especifica, se establece de forma predeterminada en la región de la ubicación solicitada.

UnitsSystem

Representa el sistema de unidades que se usa para medir los valores.

Enums
UNITS_SYSTEM_UNSPECIFIED No se especificó el sistema de unidades.
IMPERIAL El sistema de unidades imperial (p.ej., Fahrenheit, millas, etc.)
METRIC Es el sistema de unidades métricas (p. ej., Celsius, kilómetros, etc.).

Función

Son las capacidades ambientales que se pueden solicitar en LookupWeatherRequest.

Enums
CAPABILITY_UNSPECIFIED Indica que no se especificó la capacidad.
WEATHER Condiciones climáticas (temperatura, precipitaciones, viento, UV, etc.)
AIR_QUALITY Información sobre la calidad del aire (ICA, contaminantes y recomendaciones de salud)
POLLEN Información sobre el polen (niveles de alérgenos de especies de árboles, césped, malezas y plantas)

Esquema de salida

Respuesta para la RPC LookupWeather: Representa las condiciones climáticas en la ubicación solicitada.

Esta respuesta representa información por hora y diaria, por lo que se divide en tres secciones: por hora, diaria y compartida. Los campos Only-Hourly y Only-Daily se marcan como opcionales. En el caso de los campos que se comparten entre la información por hora y diaria, algunos siempre están presentes, por lo que no se marcan como opcionales, mientras que el resto se marca como opcional porque no siempre están disponibles.

LookupWeatherResponse

Representación JSON 
{
  "weatherCondition": {
    object (WeatherCondition)
  },
  "precipitation": {
    object (Precipitation)
  },
  "wind": {
    object (Wind)
  },
  "returnedLocation": {
    object (Location)
  },
  "attribution": {
    object (Attribution)
  },

  // Union field _temperature can be only one of the following:
  "temperature": {
    object (Temperature)
  }
  // End of list of possible types for union field _temperature.

  // Union field _feels_like_temperature can be only one of the following:
  "feelsLikeTemperature": {
    object (Temperature)
  }
  // End of list of possible types for union field _feels_like_temperature.

  // Union field _heat_index can be only one of the following:
  "heatIndex": {
    object (Temperature)
  }
  // End of list of possible types for union field _heat_index.

  // Union field _air_pressure can be only one of the following:
  "airPressure": {
    object (AirPressure)
  }
  // End of list of possible types for union field _air_pressure.

  // Union field _max_temperature can be only one of the following:
  "maxTemperature": {
    object (Temperature)
  }
  // End of list of possible types for union field _max_temperature.

  // Union field _min_temperature can be only one of the following:
  "minTemperature": {
    object (Temperature)
  }
  // End of list of possible types for union field _min_temperature.

  // Union field _feels_like_max_temperature can be only one of the following:
  "feelsLikeMaxTemperature": {
    object (Temperature)
  }
  // End of list of possible types for union field _feels_like_max_temperature.

  // Union field _feels_like_min_temperature can be only one of the following:
  "feelsLikeMinTemperature": {
    object (Temperature)
  }
  // End of list of possible types for union field _feels_like_min_temperature.

  // Union field _max_heat_index can be only one of the following:
  "maxHeatIndex": {
    object (Temperature)
  }
  // End of list of possible types for union field _max_heat_index.

  // Union field _sun_events can be only one of the following:
  "sunEvents": {
    object (SunEvents)
  }
  // End of list of possible types for union field _sun_events.

  // Union field _moon_events can be only one of the following:
  "moonEvents": {
    object (MoonEvents)
  }
  // End of list of possible types for union field _moon_events.

  // Union field _relative_humidity can be only one of the following:
  "relativeHumidity": integer
  // End of list of possible types for union field _relative_humidity.

  // Union field _uv_index can be only one of the following:
  "uvIndex": integer
  // End of list of possible types for union field _uv_index.

  // Union field _thunderstorm_probability can be only one of the following:
  "thunderstormProbability": integer
  // End of list of possible types for union field _thunderstorm_probability.

  // Union field _cloud_cover can be only one of the following:
  "cloudCover": integer
  // End of list of possible types for union field _cloud_cover.

  // Union field _weather can be only one of the following:
  "weather": {
    object (WeatherResultData)
  }
  // End of list of possible types for union field _weather.

  // Union field _air_quality can be only one of the following:
  "airQuality": {
    object (AirQualityResultData)
  }
  // End of list of possible types for union field _air_quality.

  // Union field _pollen can be only one of the following:
  "pollen": {
    object (PollenResultData)
  }
  // End of list of possible types for union field _pollen.

  // Union field _time_zone can be only one of the following:
  "timeZone": string
  // End of list of possible types for union field _time_zone.
}
Campos
weatherCondition

object (WeatherCondition)

La condición climática
precipitation

object (Precipitation)

La probabilidad de precipitaciones y la cantidad de precipitaciones acumuladas
wind

object (Wind)

Las condiciones del viento
returnedLocation

object (Location)

Obligatorio. Es la ubicación para la que se devuelve la información del clima. Esta ubicación es idéntica a la de la solicitud, pero puede ser diferente si la ubicación solicitada es una dirección de texto libre que busca una ubicación aproximada (p.ej., "Mountain View, CA").
attribution

object (Attribution)

Es la atribución obligatoria que se muestra con el clima.

Campo de unión _temperature.

_temperature puede ser una de las siguientes opciones:
temperature

object (Temperature)

La temperatura por hora

Campo de unión _feels_like_temperature.

_feels_like_temperature puede ser una de las siguientes opciones:
feelsLikeTemperature

object (Temperature)

La medición por hora de la sensación térmica.

Campo de unión _heat_index.

_heat_index puede ser una de las siguientes opciones:
heatIndex

object (Temperature)

Es la temperatura del índice de calor por hora.

Campo de unión _air_pressure.

_air_pressure puede ser una de las siguientes opciones:
airPressure

object (AirPressure)

Son las condiciones de presión atmosférica por hora.

Campo de unión _max_temperature.

_max_temperature puede ser una de las siguientes opciones:
maxTemperature

object (Temperature)

La temperatura máxima (alta) durante el día.

Campo de unión _min_temperature.

_min_temperature puede ser una de las siguientes opciones:
minTemperature

object (Temperature)

La temperatura mínima (baja) durante el día.

Campo de unión _feels_like_max_temperature.

_feels_like_max_temperature puede ser una de las siguientes opciones:
feelsLikeMaxTemperature

object (Temperature)

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

Campo de unión _feels_like_min_temperature.

_feels_like_min_temperature puede ser una de las siguientes opciones:
feelsLikeMinTemperature

object (Temperature)

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

Campo de unión _max_heat_index.

_max_heat_index puede ser una de las siguientes opciones:
maxHeatIndex

object (Temperature)

La temperatura máxima del índice de calor durante el día.

Campo de unión _sun_events.

_sun_events puede ser una de las siguientes opciones:
sunEvents

object (SunEvents)

Son los eventos relacionados con el Sol (p.ej., el amanecer y el atardecer).

Campo de unión _moon_events.

_moon_events puede ser una de las siguientes opciones:
moonEvents

object (MoonEvents)

Los eventos relacionados con la luna (p. ej., salida y puesta de la luna)

Campo de unión _relative_humidity.

_relative_humidity puede ser una de las siguientes opciones:
relativeHumidity

integer

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

Campo de unión _uv_index.

_uv_index puede ser una de las siguientes opciones:
uvIndex

integer

Es el índice ultravioleta (UV) máximo.

Campo de unión _thunderstorm_probability.

_thunderstorm_probability puede ser una de las siguientes opciones:
thunderstormProbability

integer

La probabilidad de tormenta (valores de 0 a 100)

Campo de unión _cloud_cover.

_cloud_cover puede ser una de las siguientes opciones:
cloudCover

integer

Es el porcentaje del cielo cubierto por nubes (valores de 0 a 100).

Campo de unión _weather.

_weather puede ser una de las siguientes opciones:
weather

object (WeatherResultData)

Condiciones climáticas en la ubicación solicitada.

Campo de unión _air_quality.

_air_quality puede ser una de las siguientes opciones:
airQuality

object (AirQualityResultData)

Información sobre la calidad del aire en la ubicación solicitada.

Campo de unión _pollen.

_pollen puede ser una de las siguientes opciones:
pollen

object (PollenResultData)

Información sobre el polen en la ubicación solicitada.

Campo de unión _time_zone.

_time_zone puede ser una de las siguientes opciones:
timeZone

string

Es la cadena de zona horaria de IANA resuelta para la ubicación (p.ej., "America/New_York", "Asia/Tokyo").

Temperatura

Representación JSON 
{
  "unit": enum (Unit),

  // Union field _degrees can be only one of the following:
  "degrees": number
  // End of list of possible types for union field _degrees.
}
Campos
unit

enum (Unit)

Opcional. Es el código de la unidad que se usa para medir el valor de la temperatura.

Campo de unión _degrees.

_degrees puede ser una de las siguientes opciones:
degrees

number

Es el valor de la temperatura (en grados) en la unidad especificada.

AirPressure

Representación JSON 
{

  // Union field _mean_sea_level_millibars can be only one of the following:
  "meanSeaLevelMillibars": number
  // End of list of possible types for union field _mean_sea_level_millibars.
}
Campos

Campo de unión _mean_sea_level_millibars.

_mean_sea_level_millibars puede ser una de las siguientes opciones:
meanSeaLevelMillibars

number

Es la presión atmosférica media al nivel del mar en milibares.

SunEvents

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 polar ártico), es posible que no haya una hora de salida del sol para un día. En estos casos, este campo no se establecerá.

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

string (Timestamp format)

La hora en que se pone el sol.

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

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

Marca de tiempo

Representación JSON 
{
  "seconds": string,
  "nanos": integer
}
Campos
seconds

string (int64 format)

Representa los segundos del horario UTC desde el tiempo Unix 1970-01-01T00:00:00Z. Debe estar entre -62135596800 y 253402300799 inclusive (lo que corresponde a 0001-01-01T00:00:00Z a 9999-12-31T23:59:59Z).
nanos

integer

Fracciones no negativas de un segundo a una resolución de nanosegundos. Este campo es la parte de nanosegundos de la duración, no una alternativa a los segundos. Los valores de segundos negativos con fracciones deben tener valores nanos no negativos que se cuentan hacia adelante en el tiempo. Deben ser valores de 0 a 999,999,999 inclusive.

MoonEvents

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

enum (Phase)

Opcional. La fase lunar.
moonriseTimes[]

string (Timestamp format)

Es la hora en la 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 excepcionales (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 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".
moonsetTimes[]

string (Timestamp format)

Es el momento en que la parte superior de la luna desaparece por debajo del 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 pone después de la medianoche del día siguiente). Sin embargo, en casos excepcionales (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 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".

WeatherCondition

Representación JSON 
{
  "iconBaseUri": string,
  "description": {
    object (LocalizedText)
  },
  "type": enum (Type)
}
Campos
iconBaseUri

string

Es el URI base del ícono, sin incluir la extensión del tipo de archivo. Para mostrar el ícono, agrega un tema si lo deseas y la extensión del tipo de archivo (.png o .svg) a este URI. De forma predeterminada, el ícono tiene un tema claro, pero se puede agregar _dark para el modo oscuro. Por ejemplo: "https://maps.gstatic.com/weather/v1/dust.svg" o "https://maps.gstatic.com/weather/v1/dust_dark.svg", donde icon_base_uri es "https://maps.gstatic.com/weather/v1/dust".
description

object (LocalizedText)

Es la descripción textual de esta condición climática (localizada).
type

enum (Type)

Es el tipo de condición climática.

LocalizedText

Representación JSON 
{
  "text": string,
  "languageCode": string
}
Campos
text

string

Es la cadena localizada en el idioma correspondiente a google.type.LocalizedText.language_code que se indica a continuación.
languageCode

string

Es el código de idioma según la norma BCP-47 del texto, como "en-US" o "sr-Latn".

Para obtener más información, consulta http://www.unicode.org/reports/tr35/#Unicode_locale_identifier.

Precipitaciones

Representación JSON 
{
  "probability": {
    object (PrecipitationProbability)
  },
  "snowQpf": {
    object (QuantitativePrecipitationForecast)
  },
  "qpf": {
    object (QuantitativePrecipitationForecast)
  }
}
Campos
probability

object (PrecipitationProbability)

La probabilidad de precipitación (valores de 0 a 100).
snowQpf

object (QuantitativePrecipitationForecast)

Es la cantidad de nieve, medida como equivalente de agua líquida, que se acumuló durante un período determinado. Nota: QPF es la abreviatura de Quantitative Precipitation Forecast (consulta la definición de QuantitativePrecipitationForecast para obtener más detalles).
qpf

object (QuantitativePrecipitationForecast)

Es la cantidad de lluvia, medida como equivalente de agua líquida, que se acumuló durante un período. Nota: QPF es la abreviatura de Quantitative Precipitation Forecast (consulta la definición de QuantitativePrecipitationForecast para obtener más detalles).

PrecipitationProbability

Representación JSON 
{
  "type": enum (Type),

  // Union field _percent can be only one of the following:
  "percent": integer
  // End of list of possible types for union field _percent.
}
Campos
type

enum (Type)

Opcional. Un código que indica el tipo de precipitación.

Campo de unión _percent.

_percent puede ser una de las siguientes opciones:
percent

integer

Un porcentaje de 0 a 100 que indica las probabilidades de precipitaciones.

QuantitativePrecipitationForecast

Representación JSON 
{
  "unit": enum (Unit),

  // Union field _quantity can be only one of the following:
  "quantity": number
  // End of list of possible types for union field _quantity.
}
Campos
unit

enum (Unit)

Es el código de la unidad que se usa para medir la cantidad de precipitación acumulada.

Campo de unión _quantity.

_quantity puede ser una de las siguientes opciones:
quantity

number

Es la cantidad de precipitación, medida como equivalente de agua líquida, que se acumuló durante un período.

Wind

Representación JSON 
{
  "direction": {
    object (WindDirection)
  },
  "speed": {
    object (WindSpeed)
  },
  "gust": {
    object (WindSpeed)
  }
}
Campos
direction

object (WindDirection)

La dirección del viento, el ángulo desde el que viene.
speed

object (WindSpeed)

La velocidad del viento
gust

object (WindSpeed)

La ráfaga de viento (aumento repentino de la velocidad del viento)

WindDirection

Representación JSON 
{
  "cardinal": enum (Cardinal),

  // Union field _degrees can be only one of the following:
  "degrees": integer
  // End of list of possible types for union field _degrees.
}
Campos
cardinal

enum (Cardinal)

Opcional. Es el código que representa la dirección cardinal desde la que sopla el viento.

Campo de unión _degrees.

_degrees puede ser una de las siguientes opciones:
degrees

integer

La dirección del viento en grados (valores de 0 a 360).

WindSpeed

Representación JSON 
{
  "unit": enum (Unit),

  // Union field _value can be only one of the following:
  "value": number
  // End of list of possible types for union field _value.
}
Campos
unit

enum (Unit)

Opcional. Es el código que representa la unidad que se usa para medir la velocidad del viento.

Campo de unión _value.

_value puede ser una de las siguientes opciones:
value

number

Es el valor de la velocidad del viento.

Ubicación

Representación JSON 
{

  // Union field location_type can be only one of the following:
  "latLng": {
    object (LatLng)
  },
  "placeId": string,
  "address": string
  // End of list of possible types for union field location_type.
}
Campos
Campo de unión location_type. Diferentes formas de representar una ubicación location_type puede ser solo uno de los parámetros siguientes:
latLng

object (LatLng)

Es un punto especificado con coordenadas geográficas.
placeId

string

Es el ID de lugar asociado con la ubicación.
address

string

Dirección legible por humanos (p.ej., dirección, ciudad o código postal).

LatLng

Representación JSON 
{
  "latitude": number,
  "longitude": number
}
Campos
latitude

number

La latitud expresada en grados. Debe pertenecer al rango [-90.0, +90.0].
longitude

number

La longitud expresada en grados. Debe pertenecer al rango [-180.0, +180.0].

Atribución

Representación JSON 
{
  "title": string,
  "url": string
}
Campos
title

string

Es el título que se mostrará para la atribución.
url

string

Es la URL a la que se vinculará la atribución.

WeatherResultData

Representación JSON 
{
  "weatherCondition": {
    object (WeatherCondition)
  },
  "precipitation": {
    object (Precipitation)
  },
  "wind": {
    object (Wind)
  },
  "attribution": {
    object (Attribution)
  },

  // Union field _date_time can be only one of the following:
  "dateTime": string
  // End of list of possible types for union field _date_time.

  // Union field _temperature can be only one of the following:
  "temperature": {
    object (Temperature)
  }
  // End of list of possible types for union field _temperature.

  // Union field _feels_like_temperature can be only one of the following:
  "feelsLikeTemperature": {
    object (Temperature)
  }
  // End of list of possible types for union field _feels_like_temperature.

  // Union field _heat_index can be only one of the following:
  "heatIndex": {
    object (Temperature)
  }
  // End of list of possible types for union field _heat_index.

  // Union field _air_pressure can be only one of the following:
  "airPressure": {
    object (AirPressure)
  }
  // End of list of possible types for union field _air_pressure.

  // Union field _date can be only one of the following:
  "date": {
    object (Date)
  }
  // End of list of possible types for union field _date.

  // Union field _max_temperature can be only one of the following:
  "maxTemperature": {
    object (Temperature)
  }
  // End of list of possible types for union field _max_temperature.

  // Union field _min_temperature can be only one of the following:
  "minTemperature": {
    object (Temperature)
  }
  // End of list of possible types for union field _min_temperature.

  // Union field _feels_like_max_temperature can be only one of the following:
  "feelsLikeMaxTemperature": {
    object (Temperature)
  }
  // End of list of possible types for union field _feels_like_max_temperature.

  // Union field _feels_like_min_temperature can be only one of the following:
  "feelsLikeMinTemperature": {
    object (Temperature)
  }
  // End of list of possible types for union field _feels_like_min_temperature.

  // Union field _max_heat_index can be only one of the following:
  "maxHeatIndex": {
    object (Temperature)
  }
  // End of list of possible types for union field _max_heat_index.

  // Union field _sun_events can be only one of the following:
  "sunEvents": {
    object (SunEvents)
  }
  // End of list of possible types for union field _sun_events.

  // Union field _moon_events can be only one of the following:
  "moonEvents": {
    object (MoonEvents)
  }
  // End of list of possible types for union field _moon_events.

  // Union field _relative_humidity can be only one of the following:
  "relativeHumidity": integer
  // End of list of possible types for union field _relative_humidity.

  // Union field _uv_index can be only one of the following:
  "uvIndex": integer
  // End of list of possible types for union field _uv_index.

  // Union field _thunderstorm_probability can be only one of the following:
  "thunderstormProbability": integer
  // End of list of possible types for union field _thunderstorm_probability.

  // Union field _cloud_cover can be only one of the following:
  "cloudCover": integer
  // End of list of possible types for union field _cloud_cover.
}
Campos
weatherCondition

object (WeatherCondition)

Es la condición climática.
precipitation

object (Precipitation)

La probabilidad de precipitaciones y la cantidad de precipitaciones acumuladas.
wind

object (Wind)

Las condiciones del viento
attribution

object (Attribution)

Es la atribución obligatoria que se muestra con el clima.

Campo de unión _date_time.

_date_time puede ser una de las siguientes opciones:
dateTime

string (Timestamp format)

Es la marca de tiempo de esta entrada del clima actual o por hora.

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

Campo de unión _temperature.

_temperature puede ser una de las siguientes opciones:
temperature

object (Temperature)

La temperatura por hora

Campo de unión _feels_like_temperature.

_feels_like_temperature puede ser una de las siguientes opciones:
feelsLikeTemperature

object (Temperature)

La medición por hora de la sensación térmica.

Campo de unión _heat_index.

_heat_index puede ser una de las siguientes opciones:
heatIndex

object (Temperature)

Es la temperatura del índice de calor por hora.

Campo de unión _air_pressure.

_air_pressure puede ser una de las siguientes opciones:
airPressure

object (AirPressure)

Son las condiciones de presión atmosférica por hora.

Campo de unión _date.

_date puede ser una de las siguientes opciones:
date

object (Date)

Es la fecha del calendario civil del pronóstico del tiempo diario.

Campo de unión _max_temperature.

_max_temperature puede ser una de las siguientes opciones:
maxTemperature

object (Temperature)

La temperatura máxima (alta) durante el día.

Campo de unión _min_temperature.

_min_temperature puede ser una de las siguientes opciones:
minTemperature

object (Temperature)

La temperatura mínima (baja) durante el día.

Campo de unión _feels_like_max_temperature.

_feels_like_max_temperature puede ser una de las siguientes opciones:
feelsLikeMaxTemperature

object (Temperature)

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

Campo de unión _feels_like_min_temperature.

_feels_like_min_temperature puede ser una de las siguientes opciones:
feelsLikeMinTemperature

object (Temperature)

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

Campo de unión _max_heat_index.

_max_heat_index puede ser una de las siguientes opciones:
maxHeatIndex

object (Temperature)

La temperatura máxima del índice de calor durante el día.

Campo de unión _sun_events.

_sun_events puede ser una de las siguientes opciones:
sunEvents

object (SunEvents)

Son los eventos relacionados con el Sol (p.ej., el amanecer y el atardecer).

Campo de unión _moon_events.

_moon_events puede ser una de las siguientes opciones:
moonEvents

object (MoonEvents)

Los eventos relacionados con la luna (p. ej., salida y puesta de la luna)

Campo de unión _relative_humidity.

_relative_humidity puede ser una de las siguientes opciones:
relativeHumidity

integer

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

Campo de unión _uv_index.

_uv_index puede ser una de las siguientes opciones:
uvIndex

integer

Es el índice ultravioleta (UV) máximo.

Campo de unión _thunderstorm_probability.

_thunderstorm_probability puede ser una de las siguientes opciones:
thunderstormProbability

integer

La probabilidad de tormenta (valores de 0 a 100)

Campo de unión _cloud_cover.

_cloud_cover puede ser una de las siguientes opciones:
cloudCover

integer

Es el porcentaje del cielo cubierto por nubes (valores de 0 a 100).

Fecha

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.

AirQualityResultData

Representación JSON 
{
  "hourlyResults": [
    {
      object (AirQualityHourlyResult)
    }
  ],
  "attribution": {
    object (Attribution)
  }
}
Campos
hourlyResults[]

object (AirQualityHourlyResult)

Son los datos de calidad del aire por hora para el período solicitado (contiene 1 entrada para las condiciones actuales o las consultas de una sola hora, hasta 24 entradas para una consulta de solo fecha pasada o futura, o las horas actuales y restantes cuando la fecha es hoy).
attribution

object (Attribution)

Es la atribución obligatoria que se debe mostrar con los datos de calidad del aire.

AirQualityHourlyResult

Representación JSON 
{
  "indexes": [
    {
      object (AirQualityIndex)
    }
  ],
  "pollutants": [
    {
      object (Pollutant)
    }
  ],
  "healthRecommendations": {
    object (HealthRecommendations)
  },
  "dateTime": {
    object (DateTime)
  }
}
Campos
indexes[]

object (AirQualityIndex)

Índices de calidad del aire (p. ej., ICA universal e ICA local)
pollutants[]

object (Pollutant)

Información detallada sobre los contaminantes, que se propaga cuando air_quality_options.include_pollutant_concentration es verdadero.
healthRecommendations

object (HealthRecommendations)

Recomendaciones de salud para diferentes grupos de población.
dateTime

object (DateTime)

La fecha y hora locales en la zona horaria de la ubicación para esta entrada de calidad del aire por hora (consta de year, month, day, hours, minutes, seconds y utc_offset).

AirQualityIndex

Representación JSON 
{
  "displayName": string,
  "valueDisplay": string,
  "category": string,
  "dominantPollutant": string,

  // Union field _value can be only one of the following:
  "value": integer
  // End of list of possible types for union field _value.
}
Campos
displayName

string

Es el nombre visible del índice (p. ej., "ICA universal", "ICA de la EPA de EE.UU.").
valueDisplay

string

Representación de cadena con formato del valor del ICA.
category

string

Es la categoría de calidad del aire en formato de texto (p.ej., "Calidad del aire buena", "Calidad del aire moderada").
dominantPollutant

string

Es el código del contaminante dominante (p.ej., "pm25", "o3").

Campo de unión _value.

_value puede ser una de las siguientes opciones:
value

integer

Es el valor numérico del ICA.

Contaminante

Representación JSON 
{
  "displayName": string,
  "fullName": string,
  "concentration": {
    object (Concentration)
  },
  "additionalInfo": {
    object (AdditionalInfo)
  }
}
Campos
displayName

string

Nombre visible corto del contaminante (p.ej., "PM2.5", "O3").
fullName

string

Nombre químico o común completo del contaminante (p.ej., "Material particulado fino (<2.5 μm)", "Ozono").
concentration

object (Concentration)

Es la concentración medida del contaminante.
additionalInfo

object (AdditionalInfo)

Información adicional sobre las fuentes del contaminante y sus efectos en la salud.

Concentración

Representación JSON 
{
  "unit": enum (Unit),

  // Union field _value can be only one of the following:
  "value": number
  // End of list of possible types for union field _value.
}
Campos
unit

enum (Unit)

Es la unidad de medida de la concentración.

Campo de unión _value.

_value puede ser una de las siguientes opciones:
value

number

Es el valor numérico de la concentración.

AdditionalInfo

Representación JSON 
{
  "sources": string,
  "effects": string
}
Campos
sources

string

Son las principales fuentes de emisión del contaminante.
effects

string

Posibles efectos en la salud por la exposición al contaminante

HealthRecommendations

Representación JSON 
{
  "generalPopulation": string,
  "elderly": string,
  "lungDiseasePopulation": string,
  "heartDiseasePopulation": string,
  "athletes": string,
  "pregnantWomen": string,
  "children": string
}
Campos
generalPopulation

string

Orientación para la población en general.
elderly

string

Orientación para la población de adultos mayores.
lungDiseasePopulation

string

Orientación para personas con enfermedades pulmonares o afecciones respiratorias.
heartDiseasePopulation

string

Orientación para personas con enfermedades cardiovasculares o cardíacas.
athletes

string

Orientación para atletas y personas activas que realizan actividades al aire libre.
pregnantWomen

string

Orientación para mujeres embarazadas
children

string

Orientación para niños.

Fecha y hora

Representación JSON 
{
  "year": integer,
  "month": integer,
  "day": integer,
  "hours": integer,
  "minutes": integer,
  "seconds": integer,
  "nanos": integer,

  // Union field time_offset can be only one of the following:
  "utcOffset": string,
  "timeZone": {
    object (TimeZone)
  }
  // End of list of possible types for union field time_offset.
}
Campos
year

integer

Opcional. Año de la fecha. Debe ser entre 1 y 9999, o bien 0 si se especifica una fecha y hora sin año.
month

integer

Opcional. Mes del año. Debe ser del 1 al 12 o 0 si se especifica una fecha y hora sin un mes.
day

integer

Opcional. Día del mes. Debe ser entre 1 y 31 y ser válido para el año y el mes, o bien 0 si se especifica una fecha y hora sin un día.
hours

integer

Opcional. Horas del día en formato de 24 horas. Debe ser de 0 a 23, el valor predeterminado es 0 (medianoche). Una API puede permitir el valor “24:00:00” para casos como el horario de cierre de empresas.
minutes

integer

Opcional. Minutos de horas del día. Debe ser un valor entre 0 y 59. El valor predeterminado es 0.
seconds

integer

Opcional. Segundos de minutos de la hora. Normalmente, debe ser de 0 a 59, el valor predeterminado es 0. Una API puede permitir el valor 60 si permite segundos bisiestos.
nanos

integer

Opcional. Fracciones de segundos en nanosegundos. Debe ser de 0 a 999,999,999, el valor predeterminado es 0.
Campo de unión time_offset. Opcional. Especifica la diferencia horaria con UTC o la zona horaria de DateTime. Elige con cuidado entre ellos, teniendo en cuenta que los datos de la zona horaria pueden cambiar en el futuro (por ejemplo, un país modifica las fechas de inicio y finalización del horario de verano, y ya se habían almacenado los valores de DateTime futuros en el rango afectado). Si se omite, se considera que la fecha y hora están en la hora local. time_offset puede ser solo uno de los parámetros siguientes:
utcOffset

string (Duration format)

Compensación de UTC. Deben ser segundos enteros, entre -18 horas y +18 horas. Por ejemplo, una diferencia de UTC de -4:00 se representaría como { seconds: -14400 }.

Una duración en segundos con hasta nueve dígitos decimales, que terminan en “s”. Ejemplo: "3.5s".
timeZone

object (TimeZone)

Zona horaria.

Duración

Representación JSON 
{
  "seconds": string,
  "nanos": integer
}
Campos
seconds

string (int64 format)

Son los segundos firmados del intervalo de tiempo. Debe ser un valor entre -315,576,000,000 y +315,576,000,000 inclusive. Nota: Estos límites se calculan de la siguiente manera: 60 s/min * 60 min/h * 24 h/día * 365.25 días/año * 10,000 años
nanos

integer

Fracciones con signo de un segundo con una resolución de nanosegundos del intervalo de tiempo. Las duraciones de menos de un segundo se representan con un campo seconds de 0 y un campo nanos positivo o negativo. En el caso de las duraciones de un segundo o más, un valor distinto de cero para el campo nanos debe tener el mismo signo que el campo seconds. Deben ser valores de -999,999,999 a +999,999,999 inclusive.

TimeZone

Representación JSON 
{
  "id": string,
  "version": string
}
Campos
id

string

Zona horaria de la base de datos de zonas horarias de IANA. Por ejemplo, "America/New_York".
version

string

Opcional. Número de versión de la base de datos de zonas horarias de IANA. Por ejemplo, "2019a".

PollenResultData

Representación JSON 
{
  "dailyForecast": {
    object (DailyPollenForecast)
  },
  "attribution": {
    object (Attribution)
  }
}
Campos
dailyForecast

object (DailyPollenForecast)

Es la previsión diaria de polen para la fecha solicitada.
attribution

object (Attribution)

Es la atribución obligatoria que se debe mostrar con los datos de polen.

DailyPollenForecast

Representación JSON 
{
  "date": {
    object (Date)
  },
  "categories": [
    {
      object (PollenCategoryInfo)
    }
  ],
  "plantSpecies": [
    {
      object (PlantSpeciesInfo)
    }
  ]
}
Campos
date

object (Date)

Es la fecha del calendario civil de la previsión.
categories[]

object (PollenCategoryInfo)

Desglose de categorías generales de polen (árboles, gramíneas y malezas)
plantSpecies[]

object (PlantSpeciesInfo)

Desglose detallado de las especies de plantas

PollenCategoryInfo

Representación JSON 
{
  "displayName": string,
  "inSeason": boolean,
  "index": {
    object (PollenIndex)
  },
  "healthRecommendations": [
    string
  ]
}
Campos
displayName

string

Es el nombre visible de la categoría (p.ej., "Árbol", "Pasto", "Maleza").
inSeason

boolean

Indica si esta categoría de polen está floreciendo activamente en la región.
index

object (PollenIndex)

Es la medición del Índice Universal de Polen (IUP) para esta categoría.
healthRecommendations[]

string

Consejos de salud prácticos para grupos sensibles al polen

PollenIndex

Representación JSON 
{
  "category": string,
  "description": string,

  // Union field _value can be only one of the following:
  "value": integer
  // End of list of possible types for union field _value.
}
Campos
category

string

Es la clasificación de categoría localizada (p.ej., "Ninguno", "Muy bajo", "Bajo", "Moderado", "Alto", "Muy alto").
description

string

Descripción del nivel de riesgo de polen.

Campo de unión _value.

_value puede ser una de las siguientes opciones:
value

integer

Es el valor numérico de UPI (escala de 0 a 5).

PlantSpeciesInfo

Representación JSON 
{
  "code": string,
  "displayName": string,
  "family": string,
  "inSeason": boolean,
  "index": {
    object (PollenIndex)
  },
  "season": string,
  "crossReactions": string
}
Campos
code

string

Código de especie legible por máquinas (p.ej., "BIRCH", "JAPANESE_CEDAR", "RAGWEED").
displayName

string

Nombre visible localizado de la especie de planta (p.ej., "Abedul").
family

string

Es el nombre de la familia botánica (p.ej., "Betulaceae (familia del abedul)").
inSeason

boolean

Indica si esta especie de planta está en temporada.
index

object (PollenIndex)

Es la medición del Índice universal de polen (IUP) para esta especie.
season

string

Es la descripción de la temporada de floración típica (p.ej., "Finales del invierno, primavera").
crossReactions

string

Alérgenos con reactividad cruzada conocidos (p.ej., "Polen de aliso, avellano, haya y roble").

Unidad

Representa una unidad que se usa para medir temperaturas.

Enums
UNIT_UNSPECIFIED No se especificó la unidad de temperatura.
CELSIUS La temperatura se mide en grados Celsius.
FAHRENHEIT La temperatura se mide en grados Fahrenheit.

Fase

Marca la fase lunar.

Enums
PHASE_UNSPECIFIED Indica que no se especificó la fase lunar.
NEW_MOON La Luna no está iluminada por el Sol.
WAXING_CRESCENT La luna está iluminada 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 está iluminada 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 está iluminada 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 está iluminada entre un 0% y un 50% en su lado izquierdo en el hemisferio norte 🌘 y en su lado derecho en el hemisferio sur 🌒.

Tipo

Marca el tipo de condición climática en el contexto de un elemento de previsión.

Nota: Por el momento, las condiciones con valores del 42 al 139 solo se devuelven para ubicaciones en Japón y Corea.

Enums
TYPE_UNSPECIFIED No se especifica la condición climática.
CLEAR No hay nubes.
MOSTLY_CLEAR Intervalos nubosos.
PARTLY_CLOUDY Parcialmente nublado (algunas nubes)
MOSTLY_CLOUDY Mayormente nublado (más nubes que sol)
CLOUDY Nublado (solo nubes, sin sol)
WINDY Viento fuerte.
WIND_AND_RAIN Viento fuerte con precipitaciones.
LIGHT_RAIN_SHOWERS Lluvia ligera intermitente.
CHANCE_OF_SHOWERS Probabilidad de lluvias intermitentes.
SCATTERED_SHOWERS Lluvias intermitentes.
RAIN_SHOWERS Los chubascos se consideran precipitaciones de menor duración que la lluvia y se caracterizan por su carácter repentino en cuanto a las horas de inicio y finalización, y por los cambios rápidos de intensidad.
HEAVY_RAIN_SHOWERS Chubascos intensos
LIGHT_TO_MODERATE_RAIN Lluvia (cantidad leve a moderada)
MODERATE_TO_HEAVY_RAIN Lluvia (de moderada a intensa en cantidad)
RAIN Lluvias moderadas.
LIGHT_RAIN Llovizna.
HEAVY_RAIN Lluvia intensa.
RAIN_PERIODICALLY_HEAVY Lluvias, por momentos intensas.
LIGHT_SNOW_SHOWERS Nieve ligera que cae con diferentes intensidades durante períodos breves.
CHANCE_OF_SNOW_SHOWERS Probabilidad de nevadas intensas.
SCATTERED_SNOW_SHOWERS Nieve que cae con intensidades variables durante períodos breves.
SNOW_SHOWERS Chubascos de nieve.
HEAVY_SNOW_SHOWERS Nevadas intensas.
LIGHT_TO_MODERATE_SNOW Nevadas leves a moderadas.
MODERATE_TO_HEAVY_SNOW Nevadas moderadas a intensas.
SNOW Nevadas moderadas.
LIGHT_SNOW Nevadas leves.
HEAVY_SNOW Nevada intensa.
SNOWSTORM Nieve con posibles truenos y relámpagos.
SNOW_PERIODICALLY_HEAVY Nevadas, por momentos intensas.
HEAVY_SNOW_STORM Nevadas intensas con posibles truenos y relámpagos.
BLOWING_SNOW Nieve con viento intenso.
RAIN_AND_SNOW Mezcla de lluvia y nieve.
HAIL Granizo.
HAIL_SHOWERS Granizo que cae con intensidades variables durante períodos breves.
THUNDERSTORM Tormenta eléctrica.
THUNDERSHOWER Una lluvia acompañada de truenos y relámpagos.
LIGHT_THUNDERSTORM_RAIN Tormentas eléctricas con lluvia de poca intensidad.
SCATTERED_THUNDERSTORMS Tormentas eléctricas con lluvias de intensidad variable durante períodos breves
HEAVY_THUNDERSTORM Tormentas eléctricas intensas.
CLEAR_AFTER_FOG_IN_THE_MORNING Despejado después de niebla por la mañana.
CLEAR_BUT_LATER_TURNING_CLOUDY Despejado, pero luego se irá nublando.
CLEAR_BUT_LATER_TURNING_TO_RAIN_AND_SNOW_MAIN_CONSTITUENT_RAIN Despejado, pero con lluvia y nieve más tarde (principalmente lluvia)
CLEAR_BUT_LATER_TURNING_TO_SNOW_AND_RAIN_MAIN_CONSTITUENT_SNOW Despejado, pero con nieve y lluvia más tarde (principalmente nieve)
CLEAR_BUT_THUNDERSTORMS_LATER Despejado, pero con tormentas eléctricas más tarde.
CLEAR_IN_THE_MORNING_BUT_CLOUDY_IN_THE_EVENING Despejado por la mañana, pero nublado por la tarde.
CLEAR_IN_THE_MORNING_WITH_BRIEF_RAIN_IN_THE_EVENING Despejado por la mañana con lluvias ligeras por la tarde.
CLEAR_MORNING_WITH_BRIEF_RAIN Mañana despejada con breves períodos de lluvia.
CLEAR_WITH_BRIEF_RAIN Despejado con lluvias ligeras.
CLEAR_WITH_BRIEF_RAIN_AND_SNOW_RAIN_AS_MAIN_CONSTITUENT Despejado con breves períodos de lluvia y nieve (principalmente lluvia)
CLEAR_WITH_BRIEF_RAIN_LATER Despejado con lluvias de corta duración más tarde.
CLEAR_WITH_BRIEF_SNOW Despejado con nevadas ligeras.
CLEAR_WITH_BRIEF_SNOW_AND_RAIN_SNOW_AS_MAIN_CONSTITUENT Despejado con breves períodos de nieve y lluvia (principalmente nieve)
CLEAR_WITH_BRIEF_SNOW_LATER Despejado con nevadas ligeras más tarde.
CLEAR_WITH_PERIODIC_CLOUDS_LATER Despejado con intervalos nubosos más tarde.
CLEAR_WITH_PERIODIC_RAIN Despejado con intervalos de lluvia.
CLEAR_WITH_PERIODIC_RAIN_ACCOMPANIED_BY_THUNDER Despejado con intervalos de lluvia acompañados de truenos
CLEAR_WITH_PERIODIC_RAIN_AND_SNOW_RAIN_AS_MAIN_CONSTITUENT Despejado con intervalos de lluvia y nieve (principalmente lluvia)
CLEAR_WITH_PERIODIC_RAIN_LATER Despejado con intervalos de lluvia más tarde.
CLEAR_WITH_PERIODIC_SNOW Despejado con intervalos de nieve.
CLEAR_WITH_PERIODIC_SNOW_AND_RAIN_SNOW_AS_MAIN_CONSTITUENT Despejado con intervalos de nieve y lluvia (principalmente nieve)
CLEAR_WITH_PERIODIC_SNOW_LATER Despejado con intervalos de nieve más tarde.
CLEAR_WITH_RAIN_AFTER_MIDNIGHT Despejado con lluvias después de la medianoche.
CLEAR_WITH_RAIN_IN_THE_NIGHT Despejado con lluvia por la noche.
CLEAR_WITH_RAIN_LATER Despejado con lluvia más tarde.
CLEAR_WITH_SNOW_ALONG_THE_MOUNTAINS Despejado con nevadas en las montañas.
CLEAR_WITH_SNOW_LATER Despejado con nevadas más tarde.
CLEAR_WITH_THUNDERSTORMS_ALONG_THE_MOUNTAINS Despejado con tormentas eléctricas en las montañas.
CLEAR_WITH_THUNDERSTORMS_IN_THE_AFTERNOON Despejado con tormentas eléctricas por la tarde.
CLOUDY_BUT_CLEAR_LATER Nublado, pero despejado más tarde.
CLOUDY_BUT_LATER_TURNING_TO_RAIN_AND_SNOW_MAIN_CONSTITUENT_RAIN Nublado, pero con lluvia y nieve más tarde (principalmente lluvia)
CLOUDY_BUT_LATER_TURNING_TO_SNOW_AND_RAIN_MAIN_CONSTITUENT_SNOW Nublado, pero con nieve y lluvia más tarde (principalmente nieve)
CLOUDY_BUT_PERIODICALLY_CLEAR_LATER Nublado, pero se despejará de forma intermitente más tarde.
CLOUDY_BUT_THUNDERSTORMS_LATER Nublado, pero con tormentas eléctricas más tarde.
CLOUDY_MORNING_WITH_BRIEF_RAIN Nublado por la mañana con breves períodos de lluvia.
CLOUDY_PERIODICALLY_CLEAR Nublado, con intervalos de cielo despejado.
CLOUDY_SNOWING_IN_THE_EVENING Nublado con nieve por la tarde.
CLOUDY_SNOWING_IN_THE_NIGHT Nublado con nieve por la noche.
CLOUDY_WITH_BRIEF_RAIN Nublado con lluvias ligeras.
CLOUDY_WITH_BRIEF_RAIN_AND_SNOW_RAIN_AS_MAIN_CONSTITUENT Nublado con breves períodos de lluvia y nieve (principalmente lluvia)
CLOUDY_WITH_BRIEF_RAIN_LATER Nublado con lluvias ligeras más tarde.
CLOUDY_WITH_BRIEF_SNOW Nublado con nevadas ligeras.
CLOUDY_WITH_BRIEF_SNOW_AND_RAIN_SNOW_AS_MAIN_CONSTITUENT Nublado con breves períodos de nieve y lluvia (principalmente nieve)
CLOUDY_WITH_BRIEF_SNOW_LATER Nublado con nevadas de corta duración más tarde.
CLOUDY_WITH_BRIEF_THUNDERSTORM Nublado con tormentas eléctricas ligeras
CLOUDY_WITH_FOG_ON_THE_OCEAN_AND_AT_THE_SEASHORE Nublado con niebla en el mar y la costa.
CLOUDY_WITH_PERIODIC_RAIN Nublado con intervalos de lluvia.
CLOUDY_WITH_PERIODIC_RAIN_ACCOMPANIED_BY_THUNDER Nublado con intervalos de lluvia acompañados de truenos
CLOUDY_WITH_PERIODIC_RAIN_AND_SNOW_RAIN_AS_MAIN_CONSTITUENT Nublado con intervalos de lluvia y nieve (principalmente lluvia)
CLOUDY_WITH_PERIODIC_RAIN_LATER Nublado con intervalos de lluvia más tarde.
CLOUDY_WITH_PERIODIC_SNOW Nublado con intervalos de nieve.
CLOUDY_WITH_PERIODIC_SNOW_ACCOMPANIED_BY_THUNDER Nublado con intervalos de nieve y truenos
CLOUDY_WITH_PERIODIC_SNOW_AND_RAIN_SNOW_AS_MAIN_CONSTITUENT Nublado con intervalos de nieve y lluvia (principalmente nieve)
CLOUDY_WITH_PERIODIC_SNOW_LATER Nublado con intervalos de nieve más tarde.
CLOUDY_WITH_RAIN_AFTER_MIDNIGHT Nublado con lluvias después de la medianoche.
CLOUDY_WITH_RAIN_FROM_ABOUT_NOON Nublado con lluvia a partir del mediodía.
CLOUDY_WITH_RAIN_FROM_EVENING Nublado con lluvias a partir de la tarde.
CLOUDY_WITH_RAIN_LATER Nublado con lluvias más tarde.
CLOUDY_WITH_SNOW_FROM_AROUND_NOON Nublado con nieve a partir del mediodía.
CLOUDY_WITH_SNOW_LATER Nublado con nieve más tarde.
FOG Niebla.
RAINSNOW_MIX_LATER_BECOMING_CLEAR_RAIN_AS_MAIN Mezcla de lluvia y nieve (principalmente lluvia), pero despejado más tarde
RAINSNOW_MIX_RAIN_AS_MAIN Mezcla de lluvia y nieve (principalmente lluvia)
RAINY_BUT_PERIODICALLY_CLEAR Lluvioso, pero con intervalos de cielo despejado.
RAIN_ACCOMPANIED_BY_LIGHTNING Lluvia acompañada de relámpagos.
RAIN_ACCOMPANIED_BY_WINDSTORM Lluvia acompañada de fuertes ráfagas de viento.
RAIN_CLEAR_AT_NIGHT Lluvioso, pero despejado por la noche.
RAIN_CLEAR_FROM_AROUND_EVENING Lluvioso, pero despejado a partir de la tarde.
RAIN_CLEAR_FROM_AROUND_NOON Lluvioso, pero despejado a partir del mediodía.
RAIN_LATER_BECOMING_CLEAR Lluvioso, pero despejado más tarde.
RAIN_LATER_BECOMING_CLOUDY Lluvioso, pero nublado más tarde.
RAIN_LATER_BECOMING_SNOW Lluvia que se convertirá en nieve más tarde.
RAIN_LATER_WITH_PERIODIC_SNOW Lluvia con intervalos de nieve más tarde.
RAIN_SNOW_AT_NIGHT Lluvia y nieve por la noche.
RAIN_SNOW_IN_THE_EVENING Lluvia y nieve por la tarde.
RAIN_TEMPORARILY_BECOMING_SLEET Lluvia que por momentos se convertirá en aguanieve
RAIN_THAT_PERIODICALLY_STOPS Lluvia intermitente.
RAIN_WITH_BRIEF_SNOW Lluvia con breves períodos de nieve.
RAIN_WITH_PERIODIC_SNOW Lluvia con intervalos de nieve.
SNOWRAIN_MIX_LATER_BECOMING_CLEAR_SNOW_AS_MAIN Mezcla de nieve y lluvia (principalmente nieve), pero despejado más tarde.
SNOWRAIN_MIX_LATER_BECOMING_CLOUDY_SNOW_AS_MAIN Mezcla de nieve y lluvia (principalmente nieve), pero nublado más tarde
SNOWRAIN_MIX_SNOW_AS_MAIN Mezcla de nieve y lluvia (principalmente nieve)
SNOW_ACCOMPANIED_BY_LIGHTNING Nevadas acompañadas de relámpagos.
SNOW_BECOMING_SLEET Nieve que se convertirá en aguanieve.
SNOW_LATER_CLEAR Nieve, pero despejado más tarde.
SNOW_LATER_CLOUDY Nieve, pero nublado más tarde.
SNOW_LATER_RAIN Nieve que se convertirá en lluvia más tarde.
SNOW_PERIODICALLY_CLEAR Nieve con intervalos de cielo despejado.
SNOW_THAT_PERIODICALLY_STOPS Nevadas intermitentes.
SNOW_TURNING_TO_RAIN_AROUND_NOON Nevadas que se convertirán en lluvia hacia el mediodía.
SNOW_TURNING_TO_RAIN_IN_THE_EVENING Nevadas que se convertirán en lluvia por la tarde.
SNOW_TURNING_TO_RAIN_IN_THE_NIGHT Nieve que se convertirá en lluvia por la noche.
SNOW_WITH_BRIEF_RAIN Nevadas con lluvias de corta duración
SNOW_WITH_BRIEF_SLEET Nevadas con aguanieve de poca intensidad.
SNOW_WITH_PERIODIC_RAIN Nieve con intervalos de lluvia.
VERY_HOT Muy caliente.
SLEET Aguanieve.
HEAVY_RAIN_TO_RAINSTORM Lluvias intensas a aguaceros.

Tipo

Representa el tipo de precipitación en una ubicación determinada.

Enums
TYPE_UNSPECIFIED Tipo de precipitación no especificado.
NONE Sin precipitaciones.
SNOW Precipitación de nieve.
RAIN Precipitación de lluvia.
LIGHT_RAIN Precipitación de lluvia ligera.
HEAVY_RAIN Precipitaciones intensas
RAIN_AND_SNOW Precipitaciones de lluvia y nieve.
SLEET Precipitaciones de aguanieve.
FREEZING_RAIN Precipitación de aguanieve.
PRECIPITATION_TYPE_HAIL Precipitación de granizo.

Unidad

Representa la unidad que se usa para medir la cantidad de precipitación acumulada.

Enums
UNIT_UNSPECIFIED Unidad de precipitación no especificada.
MILLIMETERS La cantidad de precipitaciones se mide en milímetros.
INCHES La cantidad de precipitación se mide en pulgadas.

Cardenal

Representa un punto cardinal (incluidos los puntos intermedios).

Enums
CARDINAL_UNSPECIFIED No se especifica la dirección cardinal.
NORTH La dirección cardinal norte.
NORTH_NORTHEAST La dirección intercardinal secundaria norte-noreste.
NORTHEAST La dirección intercardinal noreste.
EAST_NORTHEAST La dirección intercardinal secundaria este-noreste.
EAST Es la dirección cardinal este.
EAST_SOUTHEAST La dirección intercardinal secundaria este-sureste.
SOUTHEAST La dirección intercardinal sureste.
SOUTH_SOUTHEAST La dirección intercardinal secundaria sur-sureste.
SOUTH La dirección cardinal sur.
SOUTH_SOUTHWEST La dirección intercardinal secundaria sur-suroeste.
SOUTHWEST La dirección intercardinal sudoeste.
WEST_SOUTHWEST La dirección intercardinal secundaria oeste-suroeste.
WEST La dirección cardinal oeste.
WEST_NORTHWEST La dirección intercardinal secundaria oeste-noroeste.
NORTHWEST La dirección intercardinal noroeste.
NORTH_NORTHWEST La dirección intercardinal secundaria norte-noroeste.

Unidad

Representa la unidad que se usa para medir la velocidad.

Enums
UNIT_UNSPECIFIED No se especificó la unidad de velocidad.
KILOMETERS_PER_HOUR La velocidad se mide en kilómetros por hora.
MILES_PER_HOUR La velocidad se mide en millas por hora.

Unidad

Son las unidades que se usan para medir la concentración de contaminantes.

Enums
UNIT_UNSPECIFIED Unidad de concentración no especificada.
PARTS_PER_BILLION Partes por mil millones (ppb).
MICROGRAMS_PER_CUBIC_METER Microgramos por metro cúbico (µg/m³).

Anotaciones de herramientas

Las anotaciones de herramientas se envían a los clientes de MCP para describir el riesgo básico de una herramienta determinada. La mayoría de los clientes tratan estas sugerencias como no confiables, pero se pueden usar para decidir cuándo se puede enviar un mensaje de confirmación a un usuario.

Junto con la cadena de título, las siguientes sugerencias booleanas se definen de la siguiente manera:

  • readOnlyHint: Si es verdadero, la herramienta no modifica su entorno. Valor predeterminado: false.
  • destructiveHint: Si es verdadero, la herramienta puede realizar acciones destructivas. Si es falso, la herramienta solo puede realizar acciones aditivas. Valor predeterminado: true.
  • idempotentHint: Si es verdadero, llamar a la herramienta de forma repetida con los mismos argumentos no tendrá ningún efecto adicional en su entorno. Valor predeterminado: false.
  • openWorldHint: Si es verdadero, la herramienta puede interactuar con un "mundo abierto" de entidades externas. Si es falso, la herramienta solo puede interactuar con entidades internas. Por ejemplo, una herramienta de búsqueda web sería de mundo abierto, mientras que una herramienta de memoria no lo sería.

Sugerencia destructiva: ❌ | Sugerencia idempotente: ❌ | Sugerencia de solo lectura: ✅ | Sugerencia de mundo abierto: ❌