MCP Tools Reference: mapstools.googleapis.com

Ferramenta: lookup_weather

Recupera dados meteorológicos abrangentes, incluindo condições atuais, previsões por hora e diárias.

Dados específicos disponíveis: temperatura (atual, sensação térmica, máxima/mínima, índice de calor), vento (velocidade, rajadas, direção), eventos celestes (nascer/pôr do sol, fase da lua), precipitação (tipo, probabilidade, quantidade/QPF), condições atmosféricas (índice UV, umidade, cobertura de nuvens, probabilidade de tempestade) e endereço de local geocodificado.

Local e regras de local (CRÍTICO):

O local para o qual os dados meteorológicos são solicitados é especificado usando o campo location. Este campo é uma estrutura "oneof", ou seja, você PRECISA fornecer um valor para APENAS UM dos três subcampos de local abaixo para garantir uma consulta precisa dos dados meteorológicos.

  1. Coordenadas geográficas (lat_lng)

    • Use-o quando receber coordenadas exatas de latitude/longitude.
    • Exemplo: {"location": {"lat_lng": {"latitude": 34.0522, "longitude": -118.2437}}} // Los Angeles

  2. ID de lugar (place_id)

    • Um identificador de string inequívoco (ID de lugar do Google Maps).
    • O place_id pode ser buscado na ferramenta search_places.
    • Exemplo: {"location": {"place_id": "ChIJLU7jZClu5kcR4PcOOO6p3I0"}} // Torre Eiffel

  3. String de endereço (address)

    • Uma string de formato livre que requer especificidade para geocodificação.
    • Cidade e região: sempre inclua a região/país (por exemplo, "Londres, Reino Unido", não "Londres").
    • Endereço: informe o endereço completo (por exemplo, "Avenida Brasil, 1234, Rio de Janeiro, RJ").
    • Códigos postais/CEPs: PRECISAM ser acompanhados pelo nome de um país (por exemplo, "90210, EUA", NÃO "90210").
    • Exemplo: {"location": {"address": "1600 Pennsylvania Ave NW, Washington, DC"}}

Modos de uso:

  • Clima atual: forneça apenas location. Não especifique date e hour.

  • Previsão por hora: forneça location, date e hour (0 a 23). Use para horários específicos (por exemplo, "às 17h") ou termos como "nas próximas horas" ou "ainda hoje". Se o usuário especificar o minuto, arredonde para a hora mais próxima. Não há suporte para previsões de hora em hora além de 120 horas a partir de agora. O histórico de clima por hora é compatível com até 24 horas no passado.

  • Previsão diária: forneça location e date. Não especifique hour. Use para solicitações gerais de dias (por exemplo, "previsão do tempo para amanhã", "previsão do tempo para sexta-feira", "previsão do tempo para 25/12"). Se a data de hoje não estiver no contexto, esclareça isso com o usuário. Não é possível fazer previsões diárias para mais de 10 dias, incluindo hoje. O clima histórico não é compatível.

Restrições de parâmetros:

  • Fusos horários: todas as entradas de date e hour precisam ser relativas ao fuso horário local do local, não ao fuso horário do usuário.
  • Formato de data: as entradas precisam ser separadas em números inteiros {year, month, day}.
  • Unidades: o padrão é METRIC. Defina units_system como IMPERIAL para Fahrenheit/Milhas se o usuário sugerir os padrões dos EUA ou solicitar explicitamente.

  • A saída embasada precisa ser atribuída à fonte usando as informações do campo attribution, quando disponíveis.

O exemplo de código abaixo mostra como usar curl para chamar a ferramenta MCP lookup_weather.

Solicitação 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

Solicitação para o método LookupWeather, que representa as condições climáticas no local solicitado.

LookupWeatherRequest

Representação 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. O sistema de unidades que será usado para as condições climáticas retornadas. Se não for fornecido, as condições climáticas retornadas serão no sistema métrico (padrão = METRIC).
location

object (Location)

Obrigatório. O local para o qual as condições climáticas serão consultadas.

Campo de união _date.

_date pode ser apenas de um dos tipos a seguir:
date

object (Date)

Opcional. A data das informações meteorológicas necessárias. Observação: essa data é relativa ao fuso horário local do local especificado no campo de local. A data precisa ser entre as últimas 24 horas e os próximos 10 dias.

Campo de união _hour.

_hour pode ser apenas de um dos tipos a seguir:
hour

integer

Opcional. A hora das informações meteorológicas solicitadas, no formato de 24 horas (0-23). Esse valor é relativo ao fuso horário local do local especificado no campo de local. Não há suporte para previsões de hora em hora além de 120 horas a partir de agora. O histórico de clima por hora é compatível com até 24 horas no passado.

Data

Representação JSON 
{
  "year": integer,
  "month": integer,
  "day": integer
}
Campos
year

integer

Ano da data. Precisa ser de 1 a 9.999 ou 0 para especificar uma data sem ano.
month

integer

Mês do ano. Precisa ser de 1 a 12, ou 0 para especificar um ano sem um mês e dia.
day

integer

Dia do mês. Precisa ser de 1 a 31 e válido para o ano e o mês, ou 0 para especificar um ano sozinho ou um ano e mês em que o dia não é significativo.

Local

Representação 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ão location_type. Diferentes maneiras de representar um local. location_type pode ser apenas de um dos tipos a seguir:
latLng

object (LatLng)

Um ponto especificado usando coordenadas geográficas.
placeId

string

O ID de lugar associado ao local .
address

string

Endereço legível por humanos ou um Plus Code. Para mais detalhes, consulte https://plus.codes.

LatLng

Representação JSON 
{
  "latitude": number,
  "longitude": number
}
Campos
latitude

number

A latitude em graus. Precisa estar no intervalo [-90,0, +90,0].
longitude

number

A longitude em graus. Precisa estar no intervalo [-180,0, +180,0].

UnitsSystem

Representa o sistema de unidades usado para medir valores.

Tipos enumerados
UNITS_SYSTEM_UNSPECIFIED O sistema de unidades não foi especificado.
IMPERIAL O sistema de unidades imperiais (por exemplo, Fahrenheit, milhas etc.).
METRIC O sistema de unidades métricas (por exemplo, Celsius, quilômetros etc.).

Esquema de saída

Resposta para o RPC LookupWeather: representa as condições climáticas no local solicitado.

Essa resposta representa informações por hora e por dia. Portanto, ela é dividida em três seções: por hora, por dia e compartilhada. Os campos Only-Hourly e Only-Daily são marcados como opcionais. Para campos compartilhados entre informações por hora e diárias, alguns estão sempre presentes, então não são marcados como opcionais, enquanto os demais são marcados como opcionais porque nem sempre estão disponíveis.

LookupWeatherResponse

Representação 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)

A condição climática
precipitation

object (Precipitation)

A probabilidade e a quantidade de precipitação acumulada
wind

object (Wind)

As condições do vento
returnedLocation

object (Location)

Obrigatório. O local em que as informações meteorológicas são retornadas. Esse local é idêntico ao da solicitação, mas pode ser diferente se o local solicitado for um endereço de texto livre que se refere a uma localização aproximada (por exemplo, "Mountain View, CA").
attribution

object (Attribution)

Atribuição obrigatória para mostrar com o clima.

Campo de união _temperature.

_temperature pode ser apenas de um dos tipos a seguir:
temperature

object (Temperature)

A temperatura por hora

Campo de união _feels_like_temperature.

_feels_like_temperature pode ser apenas de um dos tipos a seguir:
feelsLikeTemperature

object (Temperature)

A medição por hora da sensação térmica.

Campo de união _heat_index.

_heat_index pode ser apenas de um dos tipos a seguir:
heatIndex

object (Temperature)

A temperatura do índice de calor por hora.

Campo de união _air_pressure.

_air_pressure pode ser apenas de um dos tipos a seguir:
airPressure

object (AirPressure)

As condições de pressão do ar por hora.

Campo de união _max_temperature.

_max_temperature pode ser apenas de um dos tipos a seguir:
maxTemperature

object (Temperature)

A temperatura máxima (alta) ao longo do dia.

Campo de união _min_temperature.

_min_temperature pode ser apenas de um dos tipos a seguir:
minTemperature

object (Temperature)

A temperatura mínima (baixa) ao longo do dia.

Campo de união _feels_like_max_temperature.

_feels_like_max_temperature pode ser apenas de um dos tipos a seguir:
feelsLikeMaxTemperature

object (Temperature)

A sensação térmica máxima (alta) ao longo do dia.

Campo de união _feels_like_min_temperature.

_feels_like_min_temperature pode ser apenas de um dos tipos a seguir:
feelsLikeMinTemperature

object (Temperature)

A sensação térmica mínima (baixa) ao longo do dia.

Campo de união _max_heat_index.

_max_heat_index pode ser apenas de um dos tipos a seguir:
maxHeatIndex

object (Temperature)

A temperatura máxima do índice de calor ao longo do dia.

Campo de união _sun_events.

_sun_events pode ser apenas de um dos tipos a seguir:
sunEvents

object (SunEvents)

Os eventos relacionados ao sol (por exemplo, nascer e pôr do sol).

Campo de união _moon_events.

_moon_events pode ser apenas de um dos tipos a seguir:
moonEvents

object (MoonEvents)

Os eventos relacionados à lua (por exemplo, nascer e pôr da lua).

Campo de união _relative_humidity.

_relative_humidity pode ser apenas de um dos tipos a seguir:
relativeHumidity

integer

A porcentagem de umidade relativa (valores de 0 a 100). Defina como opcional porque nem sempre está disponível.

Campo de união _uv_index.

_uv_index pode ser apenas de um dos tipos a seguir:
uvIndex

integer

O índice ultravioleta (UV) máximo. Defina como opcional porque nem sempre está disponível.

Campo de união _thunderstorm_probability.

_thunderstorm_probability pode ser apenas de um dos tipos a seguir:
thunderstormProbability

integer

A probabilidade de tempestade (valores de 0 a 100). Defina como opcional porque nem sempre está disponível.

Campo de união _cloud_cover.

_cloud_cover pode ser apenas de um dos tipos a seguir:
cloudCover

integer

A porcentagem do céu coberta por nuvens (valores de 0 a 100). Defina como opcional porque nem sempre está disponível.

Temperatura

Representação 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)

O código da unidade usada para medir o valor da temperatura.

Campo de união _degrees.

_degrees pode ser apenas de um dos tipos a seguir:
degrees

number

O valor da temperatura (em graus) na unidade especificada.

AirPressure

Representação 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ão _mean_sea_level_millibars.

_mean_sea_level_millibars pode ser apenas de um dos tipos a seguir:
meanSeaLevelMillibars

number

A pressão atmosférica média ao nível do mar em milibares.

SunEvents

Representação JSON 
{
  "sunriseTime": string,
  "sunsetTime": string
}
Campos
sunriseTime

string (Timestamp format)

O horário em que o sol nasce.

OBSERVAÇÃO: em alguns casos específicos (por exemplo, ao norte do círculo polar ártico), pode não haver um horário de nascer do sol para um dia. Nesses casos, esse campo não será definido.

Usa o padrão RFC 3339, em que a saída gerada é sempre convertida em Z e tem 0, 3, 6 ou 9 dígitos fracionários. Além de "Z", outros ajustes também são aceitos. Exemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
sunsetTime

string (Timestamp format)

O horário em que o sol se põe.

OBSERVAÇÃO: em alguns casos específicos (por exemplo, ao norte do círculo polar ártico), pode não haver um horário de pôr do sol para um dia. Nesses casos, esse campo não será definido.

Usa o padrão RFC 3339, em que a saída gerada é sempre convertida em Z e tem 0, 3, 6 ou 9 dígitos fracionários. Além de "Z", outros ajustes também são aceitos. Exemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".

Carimbo de data/hora

Representação JSON 
{
  "seconds": string,
  "nanos": integer
}
Campos
seconds

string (int64 format)

Representa os segundos do horário UTC desde a época Unix 1970-01-01T00:00:00Z. Precisa estar entre -62135596800 e 253402300799, inclusive (o que corresponde a 0001-01-01T00:00:00Z a 9999-12-31T23:59:59Z).
nanos

integer

Frações não negativas de um segundo com resolução de nanossegundos. Esse campo é a parte de nanossegundos da duração, não uma alternativa aos segundos. Os valores de segundos negativos com frações ainda precisam ter valores em nanossegundos não negativos que representam períodos posteriores. O valor precisa ser de 0 a 999.999.999.

MoonEvents

Representação JSON 
{
  "moonriseTimes": [
    string
  ],
  "moonsetTimes": [
    string
  ],
  "moonPhase": enum (MoonPhase)
}
Campos
moonriseTimes[]

string (Timestamp format)

O momento em que a parte de cima da lua aparece acima do horizonte (consulte https://en.wikipedia.org/wiki/Moonrise_and_moonset)).

OBSERVAÇÃO: na maioria dos casos, há um único horário de nascer da lua por dia. Em outros casos, a lista pode estar vazia (por exemplo, quando a lua nasce depois da meia-noite do dia seguinte). No entanto, em casos específicos (por exemplo, em regiões polares), a lista pode conter mais de um valor. Nesses casos, os valores são classificados em ordem crescente.

Usa o padrão RFC 3339, em que a saída gerada é sempre convertida em Z e tem 0, 3, 6 ou 9 dígitos fracionários. Além de "Z", outros ajustes também são aceitos. Exemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
moonsetTimes[]

string (Timestamp format)

O momento em que a parte superior da lua desaparece abaixo do horizonte (consulte https://en.wikipedia.org/wiki/Moonrise_and_moonset)).

OBSERVAÇÃO: na maioria dos casos, há um único horário de pôr da lua por dia. Em outros casos, a lista pode estar vazia (por exemplo, quando a lua se põe após a meia-noite do dia seguinte). No entanto, em casos específicos (por exemplo, em regiões polares), a lista pode conter mais de um valor. Nesses casos, os valores são classificados em ordem crescente.

Usa o padrão RFC 3339, em que a saída gerada é sempre convertida em Z e tem 0, 3, 6 ou 9 dígitos fracionários. Além de "Z", outros ajustes também são aceitos. Exemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
moonPhase

enum (MoonPhase)

A fase da lua.

WeatherCondition

Representação JSON 
{
  "iconBaseUri": string,
  "description": {
    object (LocalizedText)
  },
  "type": enum (Type)
}
Campos
iconBaseUri

string

O URI de base do ícone, sem a extensão do tipo de arquivo. Para exibir o ícone, anexe um tema, se quiser, e a extensão do tipo de arquivo (.png ou .svg) a esse URI. Por padrão, o ícone tem um tema claro, mas _dark pode ser adicionado ao final para o modo escuro. Por exemplo: "https://maps.gstatic.com/weather/v1/dust.svg" ou "https://maps.gstatic.com/weather/v1/dust_dark.svg", em que icon_base_uri é "https://maps.gstatic.com/weather/v1/dust".
description

object (LocalizedText)

A descrição textual dessa condição climática (localizada).
type

enum (Type)

O tipo de condição climática.

LocalizedText

Representação JSON 
{
  "text": string,
  "languageCode": string
}
Campos
text

string

String localizada no idioma correspondente a google.type.LocalizedText.language_code abaixo.
languageCode

string

O código de idioma BCP-47 do texto, como "en-US" ou "sr-Latn".

Para mais informações, consulte http://www.unicode.org/reports/tr35/#Unicode_locale_identifier.

Precipitação

Representação JSON 
{
  "probability": {
    object (PrecipitationProbability)
  },
  "snowQpf": {
    object (QuantitativePrecipitationForecast)
  },
  "qpf": {
    object (QuantitativePrecipitationForecast)
  }
}
Campos
probability

object (PrecipitationProbability)

A probabilidade de precipitação (valores de 0 a 100).
snowQpf

object (QuantitativePrecipitationForecast)

A quantidade de neve, medida como equivalente de água líquida, que se acumulou durante um período. Observação: QPF é uma abreviação de Quantitative Precipitation Forecast (consulte a definição de QuantitativePrecipitationForecast para mais detalhes).
qpf

object (QuantitativePrecipitationForecast)

A quantidade de chuva, medida como equivalente de água líquida, que se acumulou durante um período. Observação: QPF é uma abreviação de Quantitative Precipitation Forecast (consulte a definição de QuantitativePrecipitationForecast para mais detalhes).

PrecipitationProbability

Representação 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)

Um código que indica o tipo de precipitação.

Campo de união _percent.

_percent pode ser apenas de um dos tipos a seguir:
percent

integer

Uma porcentagem de 0 a 100 que indica as chances de precipitação.

QuantitativePrecipitationForecast

Representação 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)

O código da unidade usada para medir a quantidade de precipitação acumulada.

Campo de união _quantity.

_quantity pode ser apenas de um dos tipos a seguir:
quantity

number

A quantidade de precipitação, medida como equivalente de água líquida, que se acumulou ao longo de um período.

Wind

Representação JSON 
{
  "direction": {
    object (WindDirection)
  },
  "speed": {
    object (WindSpeed)
  },
  "gust": {
    object (WindSpeed)
  }
}
Campos
direction

object (WindDirection)

A direção do vento, o ângulo de onde ele vem.
speed

object (WindSpeed)

A velocidade do vento.
gust

object (WindSpeed)

A rajada de vento (aumento repentino na velocidade do vento).

WindDirection

Representação 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)

O código que representa o ponto cardeal de onde o vento está soprando.

Campo de união _degrees.

_degrees pode ser apenas de um dos tipos a seguir:
degrees

integer

A direção do vento em graus (valores de 0 a 360).

WindSpeed

Representação 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)

O código que representa a unidade usada para medir a velocidade do vento.

Campo de união _value.

_value pode ser apenas de um dos tipos a seguir:
value

number

O valor da velocidade do vento.

Local

Representação 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ão location_type. Diferentes maneiras de representar um local. location_type pode ser apenas de um dos tipos a seguir:
latLng

object (LatLng)

Um ponto especificado usando coordenadas geográficas.
placeId

string

O ID de lugar associado ao local .
address

string

Endereço legível por humanos ou um Plus Code. Para mais detalhes, consulte https://plus.codes.

LatLng

Representação JSON 
{
  "latitude": number,
  "longitude": number
}
Campos
latitude

number

A latitude em graus. Precisa estar no intervalo [-90,0, +90,0].
longitude

number

A longitude em graus. Precisa estar no intervalo [-180,0, +180,0].

Atribuição

Representação JSON 
{
  "title": string,
  "url": string
}
Campos
title

string

O título a ser exibido para a atribuição.
url

string

O URL para vincular à atribuição.

TemperatureUnit

Representa uma unidade usada para medir temperaturas.

Tipos enumerados
TEMPERATURE_UNIT_UNSPECIFIED A unidade de temperatura não foi especificada.
CELSIUS A temperatura é medida em Celsius.
FAHRENHEIT A temperatura é medida em Fahrenheit.

MoonPhase

Marca a fase da lua.

Tipos enumerados
MOON_PHASE_UNSPECIFIED Fase da lua não especificada.
NEW_MOON A lua não é iluminada pelo sol.
WAXING_CRESCENT A lua está iluminada de 0% a 50% no lado direito no hemisfério norte 🌒 e no lado esquerdo no hemisfério sul 🌘.
FIRST_QUARTER A lua está 50,1% iluminada no lado direito no hemisfério norte 🌓 e no lado esquerdo no hemisfério sul 🌗.
WAXING_GIBBOUS A lua está iluminada de 50% a 100% no lado direito no hemisfério norte 🌔 e no lado esquerdo no hemisfério sul 🌖.
FULL_MOON A Lua está totalmente iluminada.
WANING_GIBBOUS A lua está iluminada de 50% a 100% no lado esquerdo no hemisfério norte 🌖 e no lado direito no hemisfério sul 🌔.
LAST_QUARTER A lua está 50,1% iluminada no lado esquerdo no hemisfério norte 🌗 e no lado direito no hemisfério sul 🌓.
WANING_CRESCENT A lua é iluminada de 0% a 50% no lado esquerdo no hemisfério norte 🌘 e no lado direito no hemisfério sul 🌒.

Tipo

Marca o tipo de condição climática no contexto de um elemento de previsão.

Tipos enumerados
TYPE_UNSPECIFIED A condição climática não foi especificada.
CLEAR Sem nuvens.
MOSTLY_CLEAR Períodos nublados.
PARTLY_CLOUDY Parcialmente nublado (algumas nuvens).
MOSTLY_CLOUDY Predominantemente nublado (mais nuvens do que sol).
CLOUDY Nublado (muitas nuvens, sem sol).
WINDY Vento forte.
WIND_AND_RAIN Vento forte com precipitação.
LIGHT_RAIN_SHOWERS Chuva fraca intermitente.
CHANCE_OF_SHOWERS Chance de chuva intermitente.
SCATTERED_SHOWERS Chuva intermitente.
RAIN_SHOWERS As pancadas de chuva são consideradas precipitações de menor duração do que a chuva, caracterizadas por início e fim repentinos e mudanças rápidas de intensidade.
HEAVY_RAIN_SHOWERS Pancadas intensas.
LIGHT_TO_MODERATE_RAIN Chuva (fraca a moderada).
MODERATE_TO_HEAVY_RAIN Chuva (moderada a intensa).
RAIN Chuva moderada.
LIGHT_RAIN Chuva fraca.
HEAVY_RAIN Chuva forte.
RAIN_PERIODICALLY_HEAVY Chuva, com períodos mais fortes.
LIGHT_SNOW_SHOWERS Neve fraca que cai com intensidades variadas por breves períodos.
CHANCE_OF_SNOW_SHOWERS Possibilidade de pancadas de neve.
SCATTERED_SNOW_SHOWERS Neve que cai com intensidades variadas por breves períodos.
SNOW_SHOWERS Pancadas de neve.
HEAVY_SNOW_SHOWERS Pancadas intensas de neve.
LIGHT_TO_MODERATE_SNOW Neve fraca a moderada.
MODERATE_TO_HEAVY_SNOW Neve moderada a intensa.
SNOW Neve moderada.
LIGHT_SNOW Neve fraca.
HEAVY_SNOW Neve intensa.
SNOWSTORM Neve com possibilidade de trovões e relâmpagos.
SNOW_PERIODICALLY_HEAVY Neve, com períodos mais intensos.
HEAVY_SNOW_STORM Neve intensa com possíveis trovões e relâmpagos.
BLOWING_SNOW Neve com vento intenso.
RAIN_AND_SNOW Mistura de chuva e neve.
HAIL Granizo.
HAIL_SHOWERS Granizo que cai com intensidades variadas por breves períodos.
THUNDERSTORM Tempestade.
THUNDERSHOWER Uma chuva acompanhada de trovões e relâmpagos.
LIGHT_THUNDERSTORM_RAIN Chuva com trovadas leves.
SCATTERED_THUNDERSTORMS Tempestades com chuva de várias intensidades por breves períodos.
HEAVY_THUNDERSTORM Tempestade intensa.

PrecipitationType

Representa o tipo de precipitação em um determinado local.

Tipos enumerados
PRECIPITATION_TYPE_UNSPECIFIED Tipo de precipitação não especificado.
NONE Sem precipitação.
SNOW Precipitação de neve.
RAIN Precipitação de chuva.
LIGHT_RAIN Precipitação de chuva leve.
HEAVY_RAIN Precipitação de chuva intensa.
RAIN_AND_SNOW Precipitações de chuva e neve.
SLEET Precipitação de granizo.
FREEZING_RAIN Precipitação de chuva congelante.

Unidade

Representa a unidade usada para medir a quantidade de precipitação acumulada.

Tipos enumerados
UNIT_UNSPECIFIED Unidade de precipitação não especificada.
MILLIMETERS A quantidade de precipitação é medida em milímetros.
INCHES A quantidade de precipitação é medida em polegadas.

CardinalDirection

Representa uma direção cardinal (incluindo direções ordinais).

Tipos enumerados
CARDINAL_DIRECTION_UNSPECIFIED A direção cardinal não foi especificada.
NORTH A direção cardeal norte.
NORTH_NORTHEAST A direção intercardinal secundária norte-nordeste.
NORTHEAST A direção intercardinal nordeste.
EAST_NORTHEAST A direção intercardinal secundária leste-nordeste.
EAST A direção leste.
EAST_SOUTHEAST A direção intercardinal secundária leste-sudeste.
SOUTHEAST A direção intercardinal sudeste.
SOUTH_SOUTHEAST A direção intercardinal secundária sul-sudeste.
SOUTH A direção cardeal sul.
SOUTH_SOUTHWEST A direção intercardinal secundária sul-sudoeste.
SOUTHWEST A direção intercardinal sudoeste.
WEST_SOUTHWEST A direção intercardinal secundária oeste-sudoeste.
WEST A direção oeste.
WEST_NORTHWEST A direção intercardinal secundária oeste-noroeste.
NORTHWEST A direção intercardinal noroeste.
NORTH_NORTHWEST A direção intercardinal secundária norte-noroeste.

SpeedUnit

Representa a unidade usada para medir a velocidade.

Tipos enumerados
SPEED_UNIT_UNSPECIFIED A unidade de velocidade não foi especificada.
KILOMETERS_PER_HOUR A velocidade é medida em quilômetros por hora.
MILES_PER_HOUR A velocidade é medida em milhas por hora.

Anotações de ferramentas

As anotações de ferramentas são enviadas aos clientes do MCP para descrever o risco básico de uma determinada ferramenta. A maioria dos clientes trata essas dicas como não confiáveis, mas elas podem ser usadas para decidir quando um pedido de confirmação pode ser enviado a um usuário.

Além da string de título, as seguintes dicas booleanas são definidas:

  • readOnlyHint: se for verdadeiro, a ferramenta não modifica o ambiente. (Padrão: falso).
  • destructiveHint: se for verdadeiro, a ferramenta poderá realizar ações destrutivas. Se for falso, a ferramenta só poderá realizar ações aditivas. Padrão: verdadeiro.
  • idempotentHint: se for verdadeiro, chamar a ferramenta repetidamente com os mesmos argumentos não terá efeito adicional no ambiente. (Padrão: falso).
  • openWorldHint: se for verdadeiro, a ferramenta poderá interagir com um "mundo aberto" de entidades externas. Se for falso, a ferramenta só poderá interagir com entidades internas. Por exemplo, uma ferramenta de pesquisa na Web seria de mundo aberto, enquanto uma ferramenta de memória não seria.

Dica destrutiva: ❌ | Dica idempotente: ❌ | Dica somente leitura: ✅ | Dica de jogos de mundo aberto: ❌