MCP Tools Reference: mapstools.googleapis.com

ツール: lookup_weather

現在の天気、1 時間ごと、1 日ごとの予報など、包括的な天気データを取得します。

利用可能な特定のデータ: 気温（現在、体感温度、最高 / 最低、熱指数）、風（速度、突風、方向）、天体イベント（日の出 / 日の入り、月相）、降水量（種類、確率、量 / QPF）、大気条件（UV 指数、湿度、雲量、雷雨の確率）、ジオコーディングされた位置情報。

地域と地域に関するルール（重要）:

気象データをリクエストする場所は、location フィールドを使用して指定します。このフィールドは「oneof」構造です。つまり、正確な気象データを検索するには、以下の 3 つの場所サブフィールドのうち 1 つだけに値を指定する必要があります。

  1. 地理座標（lat_lng）

    • 正確な緯度 / 経度座標が提供されている場合に使用します。
    • 例: {"location": {"lat_lng": {"latitude": 34.0522, "longitude": -118.2437}}} // ロサンゼルス

  2. プレイス ID（place_id）

    • 明確な文字列識別子（Google マップのプレイス ID）。
    • place_id は search_places ツールから取得できます。
    • 例: {"location": {"place_id": "ChIJLU7jZClu5kcR4PcOOO6p3I0"}} // エッフェル塔

  3. 住所文字列（address）

    • ジオコーディングの特異性を必要とする自由形式の文字列。
    • 都市と地域: 地域 / 国を必ず含めます（例: 「ロンドン」ではなく「ロンドン、英国」）。
    • 番地: 完全な住所を入力します（例: 「1600 Pennsylvania Ave NW, Washington, DC」）。
    • 郵便番号: 国名を含める必要があります（例: 「90210」ではなく「90210, USA」）。
    • 例: {"location": {"address": "1600 Pennsylvania Ave NW, Washington, DC"}}

使用モード:

  • 現在の天気: location のみを提供します。date と hour は指定しないでください。

  • 1 時間ごとの予測: location、date、hour（0 ～ 23）を指定します。特定の時間（「午後 5 時」など）や、「数時間後」、「今日中」などの表現に使用します。お客様が分単位で指定した場合は、時間単位で切り捨てます。現在から 120 時間を超える 1 時間ごとの予報はサポートされていません。過去 24 時間までの時間単位の気象履歴がサポートされています。

  • 日次予測: location と date を指定します。hour は指定しないでください。一般的な日付のリクエスト（「明日の天気」、「金曜日の天気」、「12 月 25 日の天気」など）に使用します。今日の日付がコンテキストにない場合は、ユーザーに確認する必要があります。今日を含む 10 日を超える日次予測はサポートされていません。過去の天気はサポートされていません。

パラメータの制約:

  • タイムゾーン: date と hour の入力はすべて、ユーザーのタイムゾーンではなく、所在地の現地タイムゾーンを基準にする必要があります。
  • 日付形式: 入力は {year, month, day} 個の整数に分割する必要があります。
  • 単位: デフォルトは METRIC です。ユーザーが米国規格を暗示している場合や、明示的にリクエストしている場合は、units_system を IMPERIAL（華氏 / マイル）に設定します。

  • グラウンディングされた出力は、attribution フィールドの情報（利用可能な場合）を使用してソースに帰属させる必要があります。

次のコードサンプルは、curl を使用して lookup_weather MCP ツールを呼び出す方法を示しています。

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
}'

入力スキーマ

LookupWeather メソッドのリクエスト。リクエストされた場所の気象条件を表します。

LookupWeatherRequest

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.
}
フィールド
unitsSystem

enum (UnitsSystem)

省略可。返される気象条件に使用する単位系。指定しない場合、返される気象条件はメートル法になります（デフォルト = METRIC）。
location

object (Location)

必須。気象状況を取得する場所。

共用体フィールド _date。

_date は次のいずれかになります。
date

object (Date)

省略可。必要な気象情報の日付。注: この日付は、[場所] フィールドで指定された場所のローカル タイムゾーンに基づきます。日付は、過去 24 時間から 10 日後までの範囲で指定する必要があります。

共用体フィールド _hour。

_hour は次のいずれかになります。
hour

integer

省略可。リクエストされた天気情報の時間（24 時間形式、0 ～ 23）。この値は、location フィールドで指定された場所のローカル タイムゾーンを基準としています。現在から 120 時間を超える 1 時間ごとの予報はサポートされていません。過去 24 時間までの時間単位の気象履歴がサポートされています。

日付

JSON 表現 
{
  "year": integer,
  "month": integer,
  "day": integer
}
フィールド
year

integer

その日付の年。1～9999、または年のない日付を指定する場合は 0 にする必要があります。
month

integer

1 年の中の月。1～12、または月と日のない年を指定する場合は 0 にする必要があります。
day

integer

1 月の中の日付。1～31 で、その年と月で有効な値にする必要があります。または、日が重要でない場合は年のみか年と月を指定するには 0 にする必要があります。

ロケーション

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.
}
フィールド
共用体フィールド location_type。場所を表すさまざまな方法。location_type は次のいずれかになります。
latLng

object (LatLng)

地理座標を使用して指定されたポイント。
placeId

string

ビジネスに関連付けられたプレイス ID。
address

string

人が読める形式の住所または Plus Code。詳しくは https://plus.codes をご覧ください。

LatLng

JSON 表現 
{
  "latitude": number,
  "longitude": number
}
フィールド
latitude

number

緯度（度単位）。範囲 [-90.0, +90.0] 内になければなりません。
longitude

number

経度（度単位）。範囲 [-180.0, +180.0] 内になければなりません。

UnitsSystem

値の測定に使用される単位系を表します。

列挙型
UNITS_SYSTEM_UNSPECIFIED 単位系が指定されていません。
IMPERIAL ヤードポンド法（華氏、マイルなど）。
METRIC メートル法（摂氏、キロメートルなど）。

出力スキーマ

LookupWeather RPC のレスポンス。リクエストされた場所の気象条件を表します。

このレスポンスは、1 時間ごとと 1 日ごとの両方の情報を表しているため、1 時間ごと、1 日ごと、共有の 3 つのセクションに分割されています。Only-Hourly フィールドと Only-Daily フィールドは省略可能としてマークされています。時間単位と日単位の情報で共有されるフィールドのうち、常に存在するフィールドは省略可能としてマークされず、常に利用できるとは限らないフィールドは省略可能としてマークされます。

LookupWeatherResponse

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.
}
フィールド
weatherCondition

object (WeatherCondition)

気象条件
precipitation

object (Precipitation)

降水確率と積算降水量
wind

object (Wind)

風の状況
returnedLocation

object (Location)

必須。天気情報が返される場所。この場所はリクエストの場所と同じですが、リクエストされた場所が、おおよその位置情報（「Mountain View, CA」など）を検索するフリーテキストの住所である場合は、異なる場合があります。
attribution

object (Attribution)

天気とともに表示する必要がある帰属表示。

共用体フィールド _temperature。

_temperature は次のいずれかになります。
temperature

object (Temperature)

1 時間ごとの気温

共用体フィールド _feels_like_temperature。

_feels_like_temperature は次のいずれかになります。
feelsLikeTemperature

object (Temperature)

1 時間ごとの体感温度。

共用体フィールド _heat_index。

_heat_index は次のいずれかになります。
heatIndex

object (Temperature)

1 時間ごとの暑さ指数。

共用体フィールド _air_pressure。

_air_pressure は次のいずれかになります。
airPressure

object (AirPressure)

1 時間ごとの気圧条件。

共用体フィールド _max_temperature。

_max_temperature は次のいずれかになります。
maxTemperature

object (Temperature)

1 日の最高気温。

共用体フィールド _min_temperature。

_min_temperature は次のいずれかになります。
minTemperature

object (Temperature)

1 日の最低気温。

共用体フィールド _feels_like_max_temperature。

_feels_like_max_temperature は次のいずれかになります。
feelsLikeMaxTemperature

object (Temperature)

1 日の最高体感温度。

共用体フィールド _feels_like_min_temperature。

_feels_like_min_temperature は次のいずれかになります。
feelsLikeMinTemperature

object (Temperature)

1 日の最低体感温度。

共用体フィールド _max_heat_index。

_max_heat_index は次のいずれかになります。
maxHeatIndex

object (Temperature)

1 日の最高熱指数温度。

共用体フィールド _sun_events。

_sun_events は次のいずれかになります。
sunEvents

object (SunEvents)

太陽に関連するイベント（日の出、日の入りなど）。

共用体フィールド _moon_events。

_moon_events は次のいずれかになります。
moonEvents

object (MoonEvents)

月に関連するイベント（月の出、月の入りなど）。

共用体フィールド _relative_humidity。

_relative_humidity は次のいずれかになります。
relativeHumidity

integer

相対湿度の割合（0 ～ 100 の値）。常に利用できるとは限らないため、オプションとして定義します。

共用体フィールド _uv_index。

_uv_index は次のいずれかになります。
uvIndex

integer

最大紫外線（UV）指数。常に利用できるとは限らないため、オプションとして定義します

共用体フィールド _thunderstorm_probability。

_thunderstorm_probability は次のいずれかになります。
thunderstormProbability

integer

雷雨の確率（0 ～ 100 の値）。常に利用できるとは限らないため、オプションとして定義します。

共用体フィールド _cloud_cover。

_cloud_cover は次のいずれかになります。
cloudCover

integer

雲に覆われた空の割合（0 ～ 100 の値）。常に利用できるとは限らないため、オプションとして定義します。

温度

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.
}
フィールド
unit

enum (TemperatureUnit)

温度値の測定に使用される単位のコード。

共用体フィールド _degrees。

_degrees は次のいずれかになります。
degrees

number

指定された単位の温度値（度）。

AirPressure

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.
}
フィールド

共用体フィールド _mean_sea_level_millibars。

_mean_sea_level_millibars は次のいずれかになります。
meanSeaLevelMillibars

number

平均海面気圧（ミリバール）。

SunEvents

JSON 表現 
{
  "sunriseTime": string,
  "sunsetTime": string
}
フィールド
sunriseTime

string (Timestamp format)

日の出の時刻。

注: 特殊なケース（北極圏の北など）では、1 日に日の出時刻がない場合があります。このような場合、このフィールドは設定されません。

RFC 3339 を使用します。生成された出力は常に Z 正規化され、小数点以下は 0、3、6、または 9 桁になります。「Z」以外のオフセットも使用できます。例: "2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z"、"2014-10-02T15:01:23+05:30"。
sunsetTime

string (Timestamp format)

日の入りの時刻。

注: 特殊なケース（北極圏など）では、1 日に日没時間がない場合があります。このような場合、このフィールドは設定されません。

RFC 3339 を使用します。生成された出力は常に Z 正規化され、小数点以下は 0、3、6、または 9 桁になります。「Z」以外のオフセットも使用できます。例: "2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z"、"2014-10-02T15:01:23+05:30"。

タイムスタンプ

JSON 表現 
{
  "seconds": string,
  "nanos": integer
}
フィールド
seconds

string (int64 format)

UNIX エポック 1970-01-01T00:00:00Z からの UTC 時刻の秒数を表します。-62135596800～253402300799 の範囲（両端を含む）にする必要があります（これは 0001-01-01T00:00:00Z～9999-12-31T23:59:59Z に対応します）。
nanos

integer

ナノ秒分解能による、秒の負ではない小数以下部分。このフィールドは、秒の代替ではなく、期間のナノ秒部分です。小数以下を含む負の秒の値は、時間を前方にカウントする負ではない nanos 値を持つ必要があります。0～999,999,999 にする必要があります（両端を含む）。

MoonEvents

JSON 表現 
{
  "moonriseTimes": [
    string
  ],
  "moonsetTimes": [
    string
  ],
  "moonPhase": enum (MoonPhase)
}
フィールド
moonriseTimes[]

string (Timestamp format)

月の上端が地平線の上に現れる時刻（https://en.wikipedia.org/wiki/Moonrise_and_moonset) を参照）。

注: ほとんどの場合、月の出は 1 日に 1 回です。それ以外の場合、リストは空になることがあります（例: 月が翌日の深夜以降に昇る場合）。ただし、特殊なケース（極地など）では、リストに複数の値が含まれることがあります。この場合、値は昇順で並べ替えられます。

RFC 3339 を使用します。生成された出力は常に Z 正規化され、小数点以下は 0、3、6、または 9 桁になります。「Z」以外のオフセットも使用できます。例: "2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z"、"2014-10-02T15:01:23+05:30"。
moonsetTimes[]

string (Timestamp format)

月の上端が地平線の下に沈む時刻（https://en.wikipedia.org/wiki/Moonrise_and_moonset) を参照）。

注: ほとんどの場合、月の入りの時刻は 1 日に 1 回です。それ以外の場合、リストは空になることがあります（例: 月が翌日の深夜以降に沈む場合）。ただし、特殊なケース（極地など）では、リストに複数の値が含まれることがあります。この場合、値は昇順で並べ替えられます。

RFC 3339 を使用します。生成された出力は常に Z 正規化され、小数点以下は 0、3、6、または 9 桁になります。「Z」以外のオフセットも使用できます。例: "2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z"、"2014-10-02T15:01:23+05:30"。
moonPhase

enum (MoonPhase)

月相（月の満ち欠け）。

WeatherCondition

JSON 表現 
{
  "iconBaseUri": string,
  "description": {
    object (LocalizedText)
  },
  "type": enum (Type)
}
フィールド
iconBaseUri

string

ファイル形式の拡張子を除いた、アイコンのベース URI。アイコンを表示するには、必要に応じてテーマとファイル形式の拡張子（.png または .svg）をこの URI に追加します。デフォルトでは、アイコンはライトモードですが、_dark を追加するとダークモードになります。たとえば、「https://maps.gstatic.com/weather/v1/dust.svg」または「https://maps.gstatic.com/weather/v1/dust_dark.svg」です。ここで、icon_base_uri は「https://maps.gstatic.com/weather/v1/dust」です。
description

object (LocalizedText)

この気象条件のテキストによる説明（ローカライズ済み）。
type

enum (Type)

気象条件のタイプ。

LocalizedText

JSON 表現 
{
  "text": string,
  "languageCode": string
}
フィールド
text

string

以下の google.type.LocalizedText.language_code に対応する言語のローカライズされた文字列。
languageCode

string

テキストの BCP-47 言語コード（「en-US」や「sr-Latn」など）。

詳しくは、http://www.unicode.org/reports/tr35/#Unicode_locale_identifier をご覧ください。

降水量

JSON 表現 
{
  "probability": {
    object (PrecipitationProbability)
  },
  "snowQpf": {
    object (QuantitativePrecipitationForecast)
  },
  "qpf": {
    object (QuantitativePrecipitationForecast)
  }
}
フィールド
probability

object (PrecipitationProbability)

降水確率（0 ～ 100 の値）。
snowQpf

object (QuantitativePrecipitationForecast)

一定期間に積もった雪の量（液体水当量として測定）。注: QPF は Quantitative Precipitation Forecast（定量的降水量予測）の略です（詳細については、QuantitativePrecipitationForecast の定義をご覧ください）。
qpf

object (QuantitativePrecipitationForecast)

一定期間に蓄積された降水量（液体の水に換算して測定）。注: QPF は Quantitative Precipitation Forecast（定量的降水量予測）の略です（詳細については、QuantitativePrecipitationForecast の定義をご覧ください）。

PrecipitationProbability

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.
}
フィールド
type

enum (PrecipitationType)

降水の種類を示すコード。

共用体フィールド _percent。

_percent は次のいずれかになります。
percent

integer

降水確率を示す 0 ～ 100 の割合。

QuantitativePrecipitationForecast

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.
}
フィールド
unit

enum (Unit)

積算降水量の測定に使用される単位のコード。

共用体フィールド _quantity。

_quantity は次のいずれかになります。
quantity

number

一定期間に蓄積された降水量（液体換算）。

Wind

JSON 表現 
{
  "direction": {
    object (WindDirection)
  },
  "speed": {
    object (WindSpeed)
  },
  "gust": {
    object (WindSpeed)
  }
}
フィールド
direction

object (WindDirection)

風の方向、風が吹いてくる角度。
speed

object (WindSpeed)

風速。
gust

object (WindSpeed)

突風（風速の急激な増加）。

WindDirection

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.
}
フィールド
cardinal

enum (CardinalDirection)

風が吹いている方角を表すコード。

共用体フィールド _degrees。

_degrees は次のいずれかになります。
degrees

integer

風向き（度単位、0 ～ 360 の値）。

WindSpeed

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.
}
フィールド
unit

enum (SpeedUnit)

風速の測定に使用される単位を表すコード。

共用体フィールド _value。

_value は次のいずれかになります。
value

number

風速の値。

ロケーション

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.
}
フィールド
共用体フィールド location_type。場所を表すさまざまな方法。location_type は次のいずれかになります。
latLng

object (LatLng)

地理座標を使用して指定されたポイント。
placeId

string

ビジネスに関連付けられたプレイス ID。
address

string

人が読める形式の住所または Plus Code。詳しくは https://plus.codes をご覧ください。

LatLng

JSON 表現 
{
  "latitude": number,
  "longitude": number
}
フィールド
latitude

number

緯度（度単位）。範囲 [-90.0, +90.0] 内になければなりません。
longitude

number

経度（度単位）。範囲 [-180.0, +180.0] 内になければなりません。

アトリビューション

JSON 表現 
{
  "title": string,
  "url": string
}
フィールド
title

string

アトリビューションに表示するタイトル。
url

string

帰属表示のリンク先 URL。

TemperatureUnit

温度の測定に使用される単位を表します。

列挙型
TEMPERATURE_UNIT_UNSPECIFIED 温度の単位が指定されていません。
CELSIUS 温度は摂氏で測定されます。
FAHRENHEIT 温度は華氏で測定されます。

MoonPhase

月相（月の満ち欠け）を示します。

列挙型
MOON_PHASE_UNSPECIFIED 月相が指定されていません。
NEW_MOON 月は太陽に照らされていない。
WAXING_CRESCENT 北半球では右側が 0%～ 50% 🌒、南半球では左側が 0%～ 50% 🌘 照らされています。
FIRST_QUARTER 北半球では右側が 50.1% 🌓、南半球では左側が 50.1% 🌗 照らされています。
WAXING_GIBBOUS 月は、北半球では右側が 50%～ 100% 照らされ 🌔、南半球では左側が 50%～ 100% 照らされます 🌖。
FULL_MOON 月が完全に照らされている。
WANING_GIBBOUS 北半球では左側が 50%～ 100% 照らされ 🌖、南半球では右側が 50%～ 100% 照らされます 🌔。
LAST_QUARTER 月は、北半球では左側が 50.1% 照らされ 🌗、南半球では右側が 50.1% 照らされています 🌓。
WANING_CRESCENT 北半球では左側が 0%～ 50% 照らされ 🌘、南半球では右側が 0%～ 50% 照らされます 🌒。

タイプ

天気予報要素のコンテキストで気象条件のタイプをマークします。

列挙型
TYPE_UNSPECIFIED 気象条件が指定されていません。
CLEAR 雲はありません。
MOSTLY_CLEAR ときどき曇り。
PARTLY_CLOUDY ところにより曇り（雲が少しある）。
MOSTLY_CLOUDY おおむね曇り（太陽よりも雲が多い）。
CLOUDY 曇り（雲に覆われ、太陽が見えない）。
WINDY 強風。
WIND_AND_RAIN 強風と降水。
LIGHT_RAIN_SHOWERS 弱い雨が断続的に降るでしょう。
CHANCE_OF_SHOWERS 断続的に雨が降る可能性があります。
SCATTERED_SHOWERS 断続的な雨。
RAIN_SHOWERS にわか雨は、雨よりも持続時間が短く、開始時間と終了時間が突然で、強度が急激に変化することが特徴です。
HEAVY_RAIN_SHOWERS 激しいにわか雨。
LIGHT_TO_MODERATE_RAIN 雨（弱い雨からやや強い雨）。
MODERATE_TO_HEAVY_RAIN 雨（並～強）。
RAIN 中降りの雨。
LIGHT_RAIN 弱い雨。
HEAVY_RAIN 大雨。
RAIN_PERIODICALLY_HEAVY 雨時々大雨。
LIGHT_SNOW_SHOWERS 強弱を繰り返しながら短時間降る弱い雪。
CHANCE_OF_SNOW_SHOWERS にわか雪の可能性あり。
SCATTERED_SNOW_SHOWERS さまざまな強さで短時間降る雪。
SNOW_SHOWERS にわか雪。
HEAVY_SNOW_SHOWERS 強いにわか雪。
LIGHT_TO_MODERATE_SNOW 弱い雪からやや強い雪。
MODERATE_TO_HEAVY_SNOW 中降りの雪または大雪。
SNOW 中降りの雪。
LIGHT_SNOW 弱い雪。
HEAVY_SNOW 大雪。
SNOWSTORM 雪。雷を伴う可能性があります。
SNOW_PERIODICALLY_HEAVY 雪、ときどき激しい雪。
HEAVY_SNOW_STORM 大雪。雷を伴う可能性があります。
BLOWING_SNOW 雪、強風。
RAIN_AND_SNOW 雨と雪が混じった天気。
HAIL ひょう。
HAIL_SHOWERS さまざまな強さで短時間降るひょう。
THUNDERSTORM 雷雨。
THUNDERSHOWER 雷を伴うにわか雨。
LIGHT_THUNDERSTORM_RAIN 弱い雷雨。
SCATTERED_THUNDERSTORMS さまざまな強度の雨が短時間降る雷雨。
HEAVY_THUNDERSTORM 激しい雷雨。

PrecipitationType

特定の場所における降水の種類を表します。

列挙型
PRECIPITATION_TYPE_UNSPECIFIED 未指定の降水タイプ。
NONE 降水なし。
SNOW 降雪。
RAIN 降雨。
LIGHT_RAIN 弱い雨。
HEAVY_RAIN 大雨。
RAIN_AND_SNOW 雨と雪の両方の降水量。
SLEET みぞれ。
FREEZING_RAIN 着氷性の雨。

単位

積算降水量の測定に使用される単位を表します。

列挙型
UNIT_UNSPECIFIED 降水量の単位が指定されていません。
MILLIMETERS 降水量はミリメートル単位で測定されます。
INCHES 降水量はインチ単位で測定されます。

CardinalDirection

基本方位（序数方位を含む）を表します。

列挙型
CARDINAL_DIRECTION_UNSPECIFIED 基本方位が指定されていません。
NORTH 北の方角。
NORTH_NORTHEAST 北北東の二次中間方向。
NORTHEAST 北東の四隅方向。
EAST_NORTHEAST 東南東の二次的な四方位。
EAST 東の方角。
EAST_SOUTHEAST 東南東の二次中間方向。
SOUTHEAST 南東の四隅方向。
SOUTH_SOUTHEAST 南南東の二次的な四方位。
SOUTH 南の方角。
SOUTH_SOUTHWEST 南南西の二次的な四方位。
SOUTHWEST 南西の四隅方向。
WEST_SOUTHWEST 西南西の二次中間方位。
WEST 西。
WEST_NORTHWEST 西北西の二次四方位。
NORTHWEST 北西の四隅方向。
NORTH_NORTHWEST 北北西の二次中間方位。

SpeedUnit

速度の測定に使用される単位を表します。

列挙型
SPEED_UNIT_UNSPECIFIED 速度単位が指定されていません。
KILOMETERS_PER_HOUR 速度はキロメートル毎時で測定されます。
MILES_PER_HOUR 速度はマイル / 時で測定されます。

ツールのアノテーション

ツールのアノテーションは、特定のツールの基本的なリスクを説明するために MCP クライアントに送信されます。ほとんどのクライアントは、これらのヒントを信頼できないものとして扱いますが、確認プロンプトをユーザーに送信するタイミングを決定するために使用できます。

タイトル文字列とともに、次のブール値のヒントが定義されています。

  • readOnlyHint: true の場合、ツールは環境を変更しません。デフォルトは false です。
  • destructiveHint: true の場合、ツールは破壊的なアクションを実行できます。false の場合、ツールは追加アクションのみを実行できます。デフォルト値は true です。
  • idempotentHint: true の場合、同じ引数でツールを繰り返し呼び出しても、環境に副次的影響は発生しません。デフォルトは false です。
  • openWorldHint: true の場合、ツールは外部エンティティの「オープンワールド」とやり取りできます。false の場合、ツールは内部エンティティとのみやり取りできます。たとえば、ウェブ検索ツールはオープン ワールドですが、メモリツールはオープン ワールドではありません。

破壊的ヒント: ❌ | べき等ヒント: ❌ | 読み取り専用ヒント: ✅ | オープン ワールド ヒント: ❌