MCP Tools Reference: mapstools.googleapis.com

Herramienta: lookup_weather

Recupera datos meteorológicos completos, incluidas las condiciones actuales y los pronósticos por hora y diarios.

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 (salida/puesta del sol, 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 los 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 los 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)

    • 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: Incluye siempre 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 ir 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). Úsala para horas específicas (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 el minuto, 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. Se admite el clima histórico por hora hasta 24 horas en el pasado.

  • Pronóstico diario: Proporciona location y date. No especifiques hour. Se usa para solicitudes generales de días (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 de más de 10 días, incluido el día de hoy. No se admiten los datos históricos del clima.

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 estar separadas 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 se debe atribuir a la fuente con la información del campo attribution cuando esté disponible.

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

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

Campo de unión _date.

_date puede ser una de las siguientes opciones:

date

object (Date)

Opcional. La fecha de la información meteorológica requerida. Nota: Esta fecha se relaciona con 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. La hora de la información meteorológica solicitada, en formato de 24 horas (0-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. Se admite el clima histórico por hora 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. 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

Es una dirección legible por humanos o un 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 No se especificó el sistema de unidades.
IMPERIAL El sistema de unidades imperiales (p.ej., Fahrenheit, millas, etc.)
METRIC Es el sistema de unidades métricas (p. ej., Celsius, kilómetros, etc.).

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

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)

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 del aire 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)

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

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

Es el í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

La probabilidad de tormenta (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

Es el 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 media al 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 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
{
  "moonriseTimes": [
    string
  ],
  "moonsetTimes": [
    string
  ],
  "moonPhase": enum (MoonPhase)
}
Campos
moonriseTimes[]

string (Timestamp format)

Es la hora en 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 el limbo 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".

moonPhase

enum (MoonPhase)

La fase lunar.

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. Nota: QPF es la abreviatura de Quantitative Precipitation Forecast (consulta la definición de QuantitativePrecipitationForecast para obtener más detalles).

qpf

object (QuantitativePrecipitationForecast)

La cantidad de lluvia, 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).

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)

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 precipitación.

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 (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

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

Es una dirección legible por humanos o un 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 No se especificó la unidad de temperatura.
CELSIUS La temperatura se mide en grados Celsius.
FAHRENHEIT La temperatura se mide en grados Fahrenheit.

MoonPhase

Marca la fase lunar.

Enums
MOON_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 el lado izquierdo en el hemisferio norte 🌘 y en el 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 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 repentina aparición y desaparición, así como por sus rápidos cambios 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)
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 diversas intensidades durante períodos breves
HEAVY_THUNDERSTORM Tormentas eléctricas intensas.

PrecipitationType

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

Enums
PRECIPITATION_TYPE_UNSPECIFIED Tipo de precipitación no especificado.
NONE No hay precipitaciones.
SNOW Precipitación de nieve.
RAIN Precipitaciones 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.

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.

CardinalDirection

Representa un punto cardinal (incluidos los puntos intermedios).

Enums
CARDINAL_DIRECTION_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 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-sudoeste.
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.

SpeedUnit

Representa la unidad que se usa para medir la velocidad.

Enums
SPEED_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.

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: ❌