MCP Tools Reference: mapstools.googleapis.com

Herramienta: lookup_weather

Recupera datos meteorológicos integrales, incluidas las condiciones actuales y los pronósticos por hora y por día.

Datos específicos disponibles: 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), condiciones atmosféricas (índice UV, humedad, cobertura de nubes, probabilidad de tormentas eléctricas) y dirección de ubicación geocodificada.

Ubicación y reglas de ubicación (CRÍTICO):

La ubicación para la que se solicitan datos meteorológicos se especifica con el campo location. Este campo es una estructura "oneof", lo que significa que DEBES proporcionar un valor para SOLO UNO de los tres subcampos de ubicación que se indican a continuación para garantizar una búsqueda precisa de datos meteorológicos.

  1. Coordenadas geográficas (lat_lng)

    • Úsala cuando se te proporcionen coordenadas exactas de latitud y longitud.
    • Ejemplo: {"location": {"lat_lng": {"latitude": 34.0522, "longitude": -118.2437}}} // Los Ángeles

  2. ID de lugar (place_id)

    • Es un identificador de cadena inequívoco (ID de lugar de Google Maps).
    • El place_id se puede recuperar de la herramienta search_places.
    • Ejemplo: {"location": {"place_id": "ChIJLU7jZClu5kcR4PcOOO6p3I0"}} // Torre Eiffel

  3. Cadena de dirección (address)

    • Es una cadena de formato libre que requiere especificidad para la geocodificación.
    • Ciudad y región: Siempre incluye la región o el país (p.ej., "Londres, Reino Unido", no "Londres").
    • Dirección: Proporciona la dirección completa (p.ej., "1600 Pennsylvania Ave NW, Washington, DC").
    • Códigos postales: DEBEN estar acompañados del nombre del país (p. ej., "90210, EE.UU.", NO "90210").
    • Ejemplo: {"location": {"address": "1600 Pennsylvania Ave NW, Washington, DC"}}

Modos de uso:

  • Clima actual: Proporciona solo location. No especifiques date ni hour.

  • Pronóstico por hora: Proporciona location, date y hour (0-23). Úsalo para horarios específicos (p. ej., "a las 5 p.m.") o términos como "en las próximas horas" o "más tarde hoy". Si el usuario especifica minutos, redondea hacia abajo a la hora más cercana. No se admite la previsión por hora más allá de las 120 horas a partir de ahora. El clima histórico por hora se admite hasta 24 horas en el pasado.

  • Pronóstico diario: Proporciona location y date. No especifiques hour. Se usa para solicitudes generales del día (p.ej., "clima para mañana", "clima el viernes", "clima el 25/12"). Si la fecha de hoy no está en el contexto, debes aclararla con el usuario. No se admite la previsión diaria más allá de los 10 días, incluido el día de hoy. No se admite el clima histórico.

Restricciones de parámetros:

  • Zonas horarias: Todas las entradas de date y hour deben ser relativas a la zona horaria local de la ubicación, no a la zona horaria del usuario.
  • Formato de fecha: Las entradas deben separarse en {year, month, day} números enteros.
  • Unidades: El valor predeterminado es METRIC. Establece units_system en IMPERIAL para Fahrenheit/millas si el usuario implica estándares de EE.UU. o lo solicita explícitamente.

  • El resultado fundamentado debe atribuirse a la fuente con la información del campo attribution cuando esté disponible.

En la siguiente muestra de código, se muestra 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

Es una 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)
  },

  // 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.
}
Campos
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).
location

object (Location)

Obligatorio. Es la ubicación para la que se obtendrán las condiciones climáticas.

Campo de unión _date.

_date puede ser una de las siguientes opciones:
date

object (Date)

Opcional. Es la fecha de la información meteorológica requerida. Nota: Esta fecha es relativa a la zona horaria local de la ubicación especificada en el campo de ubicación. La fecha debe estar entre las últimas 24 horas y los próximos 10 días.

Campo de unión _hour.

_hour puede ser una de las siguientes opciones:
hour

integer

Opcional. Hora de la información meteorológica solicitada, en formato de 24 horas (0 a 23). Este valor es relativo a la zona horaria local de la ubicación especificada en el campo de ubicación. No se admite la previsión por hora más allá de las 120 horas a partir de ahora. El clima histórico por hora se admite hasta 24 horas en el pasado.

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. Son las 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 a la ubicación .
address

string

Dirección legible o Plus Code. Visita https://plus.codes para obtener más información.

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

UnitsSystem

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

Enums
UNITS_SYSTEM_UNSPECIFIED El sistema de unidades no está especificado.
IMPERIAL El sistema de unidades imperiales (p. ej., Fahrenheit, millas, etcétera)
METRIC El sistema de unidades métricas (p.ej., Celsius, kilómetros, etcétera).

Esquema de salida

Es la respuesta para el RPC de LookupWeather, que representa las condiciones climáticas en la ubicación solicitada.

Esta respuesta representa información tanto por hora como diaria, por lo que se divide en tres secciones: Hourly, Daily y Shared. Los campos Solo por hora y Solo por día están marcados como opcionales. En el caso de los campos que se comparten entre la información diaria y la horaria, algunos siempre están presentes, por lo que no se marcan como opcionales, mientras que el resto se marcan como opcionales 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.
}
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 se busca en una ubicación aproximada (p.ej., "Mountain View, CA").
attribution

object (Attribution)

Es la atribución obligatoria que se debe mostrar 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)

Es la medida por hora de cómo se siente la temperatura.

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)

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)

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

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

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

Es 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., amanecer y atardecer).

Campo de unión _moon_events.

_moon_events puede ser una de las siguientes opciones:
moonEvents

object (MoonEvents)

Son 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

Porcentaje de humedad relativa (valores de 0 a 100). Se define como opcional porque no siempre está disponible.

Campo de unión _uv_index.

_uv_index puede ser una de las siguientes opciones:
uvIndex

integer

Índice ultravioleta (UV) máximo. Se define como opcional porque no siempre está disponible.

Campo de unión _thunderstorm_probability.

_thunderstorm_probability puede ser una de las siguientes opciones:
thunderstormProbability

integer

Es la probabilidad de tormenta eléctrica (valores de 0 a 100). Se define como opcional porque no siempre está disponible.

Campo de unión _cloud_cover.

_cloud_cover puede ser una de las siguientes opciones:
cloudCover

integer

Porcentaje del cielo cubierto por nubes (valores de 0 a 100). Se define como opcional porque no siempre está disponible.

Temperatura

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

  // 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 (TemperatureUnit)

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 a nivel del mar en milibares.

SunEvents

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

string (Timestamp format)

Es la hora en la 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 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)

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 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. Debe ser un valor entre 0 y 999,999,999, inclusive.

MoonEvents

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

string (Timestamp format)

Es el momento en que el extremo 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 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 la hora en la que el extremo superior de la Luna desaparece bajo 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 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".
moonPhase

enum (MoonPhase)

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

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 a continuación.
languageCode

string

Es el código de idioma 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)

Es 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. Nota: QPF es la abreviatura de pronóstico cuantitativo de precipitación (consulta la definición de QuantitativePrecipitationForecast para obtener más detalles).
qpf

object (QuantitativePrecipitationForecast)

Cantidad de lluvia acumulada durante un período, medida como equivalente de agua líquida. Nota: QPF es la abreviatura de pronóstico cuantitativo de precipitación (consulta la definición de QuantitativePrecipitationForecast para obtener más detalles).

PrecipitationProbability

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

  // 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 (PrecipitationType)

Es 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

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

Dirección del viento, el ángulo desde el que llega.
speed

object (WindSpeed)

Es la velocidad del viento.
gust

object (WindSpeed)

Ráfaga de viento (aumento repentino de la velocidad del viento).

WindDirection

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

  // 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 (CardinalDirection)

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

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

WindSpeed

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

  // 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 (SpeedUnit)

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. Son las 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 a la ubicación .
address

string

Dirección legible o Plus Code. Visita https://plus.codes para obtener más información.

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.

TemperatureUnit

Representa una unidad que se usa para medir temperaturas.

Enums
TEMPERATURE_UNIT_UNSPECIFIED La unidad de temperatura no está especificada.
CELSIUS La temperatura se mide en grados Celsius.
FAHRENHEIT La temperatura se mide en Fahrenheit.

MoonPhase

Marca la fase lunar.

Enums
MOON_PHASE_UNSPECIFIED Fase lunar sin especificar.
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 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 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 🌒.

Tipo

Marca el tipo de condición meteorológica en el contexto de un elemento de previsión.

Enums
TYPE_UNSPECIFIED No se especifica la condición climática.
CLEAR Sin nubes.
MOSTLY_CLEAR Nubes intermitentes
PARTLY_CLOUDY Parcialmente nublado (algunas nubes).
MOSTLY_CLOUDY Mayormente nublado (más nubes que sol)
CLOUDY Nublado (todas las 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 Las lluvias se consideran precipitaciones que tienen una duración más corta que la lluvia y se caracterizan por la repentinidad en términos de horas de inicio y finalización, y cambios rápidos en la intensidad.
HEAVY_RAIN_SHOWERS Lluvias intensas
LIGHT_TO_MODERATE_RAIN Lluvia (de leve a moderada en cantidad).
MODERATE_TO_HEAVY_RAIN Lluvia (de moderada a intensa en cantidad)
RAIN Lluvias moderadas.
LIGHT_RAIN Lluvia leve.
HEAVY_RAIN Lluvia intensa.
RAIN_PERIODICALLY_HEAVY Lluvias, por momentos intensas
LIGHT_SNOW_SHOWERS Nevadas leves que caen con diferentes intensidades durante períodos breves.
CHANCE_OF_SNOW_SHOWERS Probabilidad de nevadas.
SCATTERED_SNOW_SHOWERS Nevadas con intensidades variables durante períodos breves
SNOW_SHOWERS Chubascos de nieve.
HEAVY_SNOW_SHOWERS Chubascos de nieve intensos.
LIGHT_TO_MODERATE_SNOW Nevadas leves a moderadas
MODERATE_TO_HEAVY_SNOW Nevadas moderadas a intensas
SNOW Nevadas moderadas
LIGHT_SNOW Nevadas ligeras
HEAVY_SNOW Nevadas intensas
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 diferentes intensidades 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 lluvia de diversas intensidades durante períodos breves.
HEAVY_THUNDERSTORM Tormenta eléctrica intensa.

PrecipitationType

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

Enums
PRECIPITATION_TYPE_UNSPECIFIED Tipo de precipitación sin especificar.
NONE No hay precipitaciones.
SNOW Precipitaciones 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 lluvia helada.

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 precipitación se mide en milímetros.
INCHES La cantidad de precipitación se mide en pulgadas.

CardinalDirection

Representa una dirección cardinal (incluidas las direcciones ordinales).

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

SpeedUnit

Representa la unidad que se usa para medir la velocidad.

Enums
SPEED_UNIT_UNSPECIFIED La unidad de velocidad no está especificada.
KILOMETERS_PER_HOUR La velocidad se mide en kilómetros por hora.
MILES_PER_HOUR La velocidad se mide en millas por hora.

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 le puede enviar un mensaje de confirmación a un usuario.

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

  • 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 varias veces 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.

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