MCP Tools Reference: mapstools.googleapis.com

ツール: compute_routes

出発地と目的地の間の移動ルートを計算します。必要に応じて、中間地点を経由することもできます。各ルートの距離と所要時間を返します。

入力要件(重要):

  1. origin と destination(オブジェクト - 必須): それぞれ、次のいずれか 1 つのみを使用して指定する必要があります。

    • address(文字列、例: 'Eiffel Tower, Paris')。名前付きの場所、ランドマーク、ビジネスは直接解決されるため、ウェイポイントをジオコーディングするためだけに search_places を呼び出さないでください。お客様が言及した都市、地域、国をすべて含めます。
    • lat_lng(オブジェクト、{"latitude": number, "longitude": number})。
    • place_id(文字列、例: 'ChIJOwE_Id1w5EAR4Q27FkL6T_0')。例: search_places。
  2. intermediate_waypoints(オブジェクトの配列 - 省略可): 出発地と目的地の間に設定する、最大 25 か所の経由地(順番に並べる)。origin と同じ形式。TRANSIT ではサポートされていません。ユーザーがリクエストした経由地のみを含めます。10 個を超える中間ウェイポイントを指定すると、費用とレイテンシが増加します。

  3. travel_mode(列挙型 - 省略可): DRIVE(デフォルト)、WALK、BICYCLE、TRANSIT。

  4. タイミング(省略可 - 最大 1 つ設定): UTC オフセットを含む RFC 3339 タイムスタンプ(例: '2026-09-19T08:00:00-07:00')。デフォルトは「今すぐ出発」です。TRANSIT の場合、時間は過去 7 日以内、または将来 100 日以内です。他のモードの場合、時刻は 365 日後まで指定できます。過去の時刻は指定できません。

    • departure_time: ユーザーが出発時刻を指定した場合(例: 「明日の午前 8 時」)に使用します。
    • arrival_time: ユーザーが到着時刻を指定した場合(例: 「午前 9 時までに到着」)に使用します。
  5. routing_preference(列挙型 - 省略可):

    • ROUTING_PREFERENCE_TRAFFIC_UNAWARE(デフォルト): リアルタイムの交通状況、事故、通行止めを無視します。レイテンシが最も低い。
    • ROUTING_PREFERENCE_TRAFFIC_AWARE_OPTIMAL: 可能な場合は、リアルタイムの交通状況を使用します。WALK または BICYCLE ではサポートされていません。この設定は、お客様から交通状況、渋滞、交通状況を考慮した到着予定時刻について問い合わせを受けた場合にのみ行ってください。コストとレイテンシが増加します。
  6. location_bias(オブジェクト - 省略可): ウェイポイントの住所の場所名の曖昧さを解消するために使用される {"latitude": number, "longitude": number}。名前があいまい(例: 「Springfield」)で、ユーザーが地域を指定していない場合は、address で指定された名前をそのまま使用し、地域を推測するのではなく、目的の地域に location_bias を設定します。

  7. compute_alternative_routes(ブール値 - 省略可): ユーザーがルート オプションまたは代替ルートをリクエストした場合にのみ、true に設定します。デフォルトは false で、おすすめのルートのみが返されます。

  8. include_polyline(ブール値 - 省略可): ルート ジオメトリ(encoded_polyline)が必要な場合にのみ true に設定します。デフォルトは false です。

ツール呼び出しの手順:

  • 出発地または目的地が不明な場合は、ツールを呼び出す前にユーザーに確認する必要があります。
  • 「A から B までの距離は?」という質問の場合、B を origin、A を destination として使用します。

ツール呼び出しの例: {"origin":{"address":"Eiffel Tower"},"destination":{"place_id":"ChIJt_5xIthw5EARoJ71mGq7t74"},"intermediate_waypoints":[{"address":"Louvre Museum"}],"travel_mode":"DRIVE","departure_time":"2026-09-19T08:00:00+02:00"}

回答の手順:

  • 代替ルートがリクエストされた場合、ルートはおすすめ度の高い順に並べ替えられます。
  • routes が空の場合は、ルートが見つからなかったことをユーザーに伝えます。ルートを推測しないでください。
  • DRIVE 経路沿いの場所を検索するには、経路の retrieval_token を search_along_route に渡します。トークンは 10 分間有効です。
  • ツールから返された事実のみを述べてください。ターンバイターン方式の経路、交通機関の路線、駅、プラットフォーム、乗り換えを創作しないでください。
  • グラウンディングされた出力は、各ルートの attribution フィールド(使用可能な場合)を使用してソースに帰属させる必要があります。

次のコードサンプルは、curl を使用して compute_routes 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": "compute_routes",
    "arguments": {
      // Provide these details according to the MCP tool specification.
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

入力スキーマ

ComputeRoutesRequest。

ComputeRoutesRequest

JSON 表現
{
  "origin": {
    object (Waypoint)
  },
  "destination": {
    object (Waypoint)
  },
  "travelMode": enum (RouteTravelMode),
  "intermediateWaypoints": [
    {
      object (Waypoint)
    }
  ],
  "routingPreference": enum (RoutingPreference),
  "locationBias": {
    object (LatLng)
  },
  "includePolyline": boolean,
  "computeAlternativeRoutes": boolean,

  // Union field timing can be only one of the following:
  "departureTime": string,
  "arrivalTime": string
  // End of list of possible types for union field timing.
}
フィールド
origin

object (Waypoint)

必須。出発地のウェイポイント。

destination

object (Waypoint)

必須。目的地のウェイポイント。

travelMode

enum (RouteTravelMode)

省略可。移動手段を指定します。

intermediateWaypoints[]

object (Waypoint)

省略可。出発地と目的地の間に設定する、順番に通過する中間地点。最大 25 個の中間地点がサポートされています。

10 個を超える中間地点を指定すると、費用とレイテンシが増加します。travel_mode が TRANSIT の場合、中間地点はサポートされません。

routingPreference

enum (RoutingPreference)

省略可。ルートの計算に交通状況データを使用する方法を指定します。travel_mode が WALK または BICYCLE の場合、ROUTING_PREFERENCE_TRAFFIC_AWARE_OPTIMAL はサポートされません。TRANSIT の場合、遅延やキャンセルなどのリアルタイムの乗換案内データが有効になります。

locationBias

object (LatLng)

省略可。検索結果をバイアスする場所(ウェイポイントのテキストクエリの曖昧さを解消するなど)。

includePolyline

boolean

省略可。レスポンス ルートにエンコードされたポリラインを含めるかどうか。デフォルトは false です。true に設定すると、Route.encoded_polyline が返されます。

computeAlternativeRoutes

boolean

省略可。推奨ルートに加えて代替ルートを計算するかどうか。デフォルトは false で、この場合はおすすめのルートのみが返されます。true に設定すると、利用可能なすべてのルートが返されます。ただし、リクエストによっては代替ルートが利用できない場合もあります。

共用体フィールド timing。出発地を出発する時刻、または最終ウェイポイントに到着する時刻を指定します。指定しない場合、デフォルトは現在の時刻に出発します。TRANSIT の場合、時刻は過去 7 日以内、将来 100 日以内にする必要があります。他の移動手段の場合、時刻は過去ではなく、365 日以内にする必要があります。timing は次のいずれかになります。
departureTime

string (Timestamp format)

省略可。出発時刻に基づいてルートを計算する必要があることを示します。

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

arrivalTime

string (Timestamp format)

省略可。到着時刻に基づいてルートを計算する必要があることを示します。

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 表現
{

  // 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 表現
{
  "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 にする必要があります(両端を含む)。

RouteTravelMode

移動手段を指定するために使用される値のセット。

列挙型
ROUTE_TRAVEL_MODE_UNSPECIFIED 移動手段が指定されていません。デフォルトは DRIVE です。
DRIVE 乗用車で移動する。
WALK 徒歩で移動します。注: WALK ルートはベータ版であり、明確な歩道や歩行者用通路が欠落している場合があります。アプリに表示するすべての徒歩ルートについて、この警告をユーザーに表示する必要があります。
BICYCLE 自転車で移動する。
TRANSIT 公共交通機関で移動する。

RoutingPreference

ルートを計算する際に考慮する要素を指定する値のセット。

列挙型
ROUTING_PREFERENCE_UNSPECIFIED ルーティング設定が指定されていません。デフォルトは ROUTING_PREFERENCE_TRAFFIC_UNAWARE です。
ROUTING_PREFERENCE_TRAFFIC_UNAWARE リアルタイムの交通状況を考慮せずにルートを計算します。交通状況が重要でない場合や、交通状況が適用されない場合に適しています。この値を使用すると、レイテンシが最も低くなります。
ROUTING_PREFERENCE_TRAFFIC_AWARE_OPTIMAL

交通データが利用可能な場合は、リアルタイムの交通状況を考慮してルートを計算します。TRANSIT の場合、遅延やキャンセルなどのリアルタイムの交通機関データを使用します(利用可能な場合)。

この値は Pro ティアをトリガーし、請求額とレイテンシが増加します。

出力スキーマ

ComputeRoutesResponse。

ComputeRoutesResponse

JSON 表現
{
  "routes": [
    {
      object (Route)
    }
  ]
}
フィールド
routes[]

object (Route)

リクエストされた出発地と目的地の間のルートが含まれます。最もおすすめのルートから順に並べられます。ComputeRoutesRequest.compute_alternative_routes が true に設定されていない限り、返されるルートは 1 つだけです。

ルーティング

JSON 表現
{
  "distanceMeters": integer,
  "duration": string,
  "attribution": {
    object (Attribution)
  },
  "encodedPolyline": string,
  "retrievalToken": string
}
フィールド
distanceMeters

integer

ルートの移動距離(メートル単位)。

duration

string (Duration format)

ルートの移動に必要な時間。

s で終わる小数 9 桁までの秒単位の期間。例: "3.5s"。

attribution

object (Attribution)

ルートとともに表示する必要がある帰属表示。

encodedPolyline

string

ルートのエンコードされたポリライン。https://developers.google.com/maps/documentation/utilities/polylinealgorithm をご覧ください。

retrievalToken

string

SearchAlongRoute などのダウンストリーム ツールでこの特定のルートを取得するために使用できるトークン。10 分間有効です。

所要時間

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

string (int64 format)

期間の秒数(符号付き)。-315,576,000,000 ~+315,576,000,000 の範囲(境界を含む)になります。注: これらの境界は、60 秒/分 * 60 分/時間 * 24 時間/日 * 365.25 日/年 * 10,000 年から計算されます。

nanos

integer

期間のナノ秒分解能による、秒の符号付き小数以下部分。1 秒未満の期間は、0 の seconds フィールドと、正または負の nanos フィールドで表されます。1 秒以上の期間の場合、nanos フィールドのゼロ以外の値は、seconds フィールドと同じ符号にする必要があります。-999,999,999~+999,999,999 の範囲内(境界含む)である必要があります。

アトリビューション

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

string

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

url

string

帰属表示のリンク先 URL。

ツールのアノテーション

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

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

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

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