ツール: compute_routes
出発地と目的地の間の移動ルートを計算します。必要に応じて、中間地点を経由することもできます。各ルートの距離と所要時間を返します。
入力要件(重要):
originとdestination(オブジェクト - 必須): それぞれ、次のいずれか 1 つのみを使用して指定する必要があります。address(文字列、例:'Eiffel Tower, Paris')。名前付きの場所、ランドマーク、ビジネスは直接解決されるため、ウェイポイントをジオコーディングするためだけにsearch_placesを呼び出さないでください。お客様が言及した都市、地域、国をすべて含めます。lat_lng(オブジェクト、{"latitude": number, "longitude": number})。place_id(文字列、例:'ChIJOwE_Id1w5EAR4Q27FkL6T_0')。例:search_places。
intermediate_waypoints(オブジェクトの配列 - 省略可): 出発地と目的地の間に設定する、最大 25 か所の経由地(順番に並べる)。originと同じ形式。TRANSITではサポートされていません。ユーザーがリクエストした経由地のみを含めます。10 個を超える中間ウェイポイントを指定すると、費用とレイテンシが増加します。travel_mode(列挙型 - 省略可):DRIVE(デフォルト)、WALK、BICYCLE、TRANSIT。タイミング(省略可 - 最大 1 つ設定): UTC オフセットを含む RFC 3339 タイムスタンプ(例:
'2026-09-19T08:00:00-07:00')。デフォルトは「今すぐ出発」です。TRANSITの場合、時間は過去 7 日以内、または将来 100 日以内です。他のモードの場合、時刻は 365 日後まで指定できます。過去の時刻は指定できません。departure_time: ユーザーが出発時刻を指定した場合(例: 「明日の午前 8 時」)に使用します。arrival_time: ユーザーが到着時刻を指定した場合(例: 「午前 9 時までに到着」)に使用します。
routing_preference(列挙型 - 省略可):ROUTING_PREFERENCE_TRAFFIC_UNAWARE(デフォルト): リアルタイムの交通状況、事故、通行止めを無視します。レイテンシが最も低い。ROUTING_PREFERENCE_TRAFFIC_AWARE_OPTIMAL: 可能な場合は、リアルタイムの交通状況を使用します。WALKまたはBICYCLEではサポートされていません。この設定は、お客様から交通状況、渋滞、交通状況を考慮した到着予定時刻について問い合わせを受けた場合にのみ行ってください。コストとレイテンシが増加します。
location_bias(オブジェクト - 省略可): ウェイポイントの住所の場所名の曖昧さを解消するために使用される{"latitude": number, "longitude": number}。名前があいまい(例: 「Springfield」)で、ユーザーが地域を指定していない場合は、addressで指定された名前をそのまま使用し、地域を推測するのではなく、目的の地域にlocation_biasを設定します。compute_alternative_routes(ブール値 - 省略可): ユーザーがルート オプションまたは代替ルートをリクエストした場合にのみ、trueに設定します。デフォルトはfalseで、おすすめのルートのみが返されます。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 ( |
| フィールド | |
|---|---|
origin |
必須。出発地のウェイポイント。 |
destination |
必須。目的地のウェイポイント。 |
travelMode |
省略可。移動手段を指定します。 |
intermediateWaypoints[] |
省略可。出発地と目的地の間に設定する、順番に通過する中間地点。最大 25 個の中間地点がサポートされています。 10 個を超える中間地点を指定すると、費用とレイテンシが増加します。 |
routingPreference |
省略可。ルートの計算に交通状況データを使用する方法を指定します。 |
locationBias |
省略可。検索結果をバイアスする場所(ウェイポイントのテキストクエリの曖昧さを解消するなど)。 |
includePolyline |
省略可。レスポンス ルートにエンコードされたポリラインを含めるかどうか。デフォルトは |
computeAlternativeRoutes |
省略可。推奨ルートに加えて代替ルートを計算するかどうか。デフォルトは false で、この場合はおすすめのルートのみが返されます。true に設定すると、利用可能なすべてのルートが返されます。ただし、リクエストによっては代替ルートが利用できない場合もあります。 |
共用体フィールド timing。出発地を出発する時刻、または最終ウェイポイントに到着する時刻を指定します。指定しない場合、デフォルトは現在の時刻に出発します。TRANSIT の場合、時刻は過去 7 日以内、将来 100 日以内にする必要があります。他の移動手段の場合、時刻は過去ではなく、365 日以内にする必要があります。timing は次のいずれかになります。 |
|
departureTime |
省略可。出発時刻に基づいてルートを計算する必要があることを示します。 RFC 3339 を使用します。生成された出力は常に Z 正規化され、小数点以下は 0、3、6、または 9 桁になります。「Z」以外のオフセットも使用できます。例: |
arrivalTime |
省略可。到着時刻に基づいてルートを計算する必要があることを示します。 RFC 3339 を使用します。生成された出力は常に Z 正規化され、小数点以下は 0、3、6、または 9 桁になります。「Z」以外のオフセットも使用できます。例: |
ウェイポイント
| JSON 表現 |
|---|
{ // Union field |
| フィールド | |
|---|---|
共用体フィールド location_type。場所を表すさまざまな方法。location_type は次のいずれかになります。 |
|
latLng |
地理座標を使用して指定されたポイント。 |
placeId |
ウェイポイントに関連付けられたプレイス ID。 |
address |
人が読める形式の住所または Plus Code。詳しくは https://plus.codes をご覧ください。 |
LatLng
| JSON 表現 |
|---|
{ "latitude": number, "longitude": number } |
| フィールド | |
|---|---|
latitude |
緯度(度単位)。範囲 [-90.0, +90.0] 内になければなりません。 |
longitude |
経度(度単位)。範囲 [-180.0, +180.0] 内になければなりません。 |
タイムスタンプ
| JSON 表現 |
|---|
{ "seconds": string, "nanos": integer } |
| フィールド | |
|---|---|
seconds |
UNIX エポック 1970-01-01T00:00:00Z からの UTC 時刻の秒数を表します。-62135596800~253402300799 の範囲(両端を含む)にする必要があります(これは 0001-01-01T00:00:00Z~9999-12-31T23:59:59Z に対応します)。 |
nanos |
ナノ秒分解能による、秒の負ではない小数以下部分。このフィールドは、秒の代替ではなく、期間のナノ秒部分です。小数以下を含む負の秒の値は、時間を前方にカウントする負ではない 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 |
交通データが利用可能な場合は、リアルタイムの交通状況を考慮してルートを計算します。 この値は Pro ティアをトリガーし、請求額とレイテンシが増加します。 |
出力スキーマ
ComputeRoutesResponse。
ComputeRoutesResponse
| JSON 表現 |
|---|
{
"routes": [
{
object ( |
| フィールド | |
|---|---|
routes[] |
リクエストされた出発地と目的地の間のルートが含まれます。最もおすすめのルートから順に並べられます。 |
ルーティング
| JSON 表現 |
|---|
{
"distanceMeters": integer,
"duration": string,
"attribution": {
object ( |
| フィールド | |
|---|---|
distanceMeters |
ルートの移動距離(メートル単位)。 |
duration |
ルートの移動に必要な時間。
|
attribution |
ルートとともに表示する必要がある帰属表示。 |
encodedPolyline |
ルートのエンコードされたポリライン。https://developers.google.com/maps/documentation/utilities/polylinealgorithm をご覧ください。 |
retrievalToken |
SearchAlongRoute などのダウンストリーム ツールでこの特定のルートを取得するために使用できるトークン。10 分間有効です。 |
所要時間
| JSON 表現 |
|---|
{ "seconds": string, "nanos": integer } |
| フィールド | |
|---|---|
seconds |
期間の秒数(符号付き)。-315,576,000,000 ~+315,576,000,000 の範囲(境界を含む)になります。注: これらの境界は、60 秒/分 * 60 分/時間 * 24 時間/日 * 365.25 日/年 * 10,000 年から計算されます。 |
nanos |
期間のナノ秒分解能による、秒の符号付き小数以下部分。1 秒未満の期間は、0 の |
アトリビューション
| JSON 表現 |
|---|
{ "title": string, "url": string } |
| フィールド | |
|---|---|
title |
アトリビューションに表示するタイトル。 |
url |
帰属表示のリンク先 URL。 |
ツールのアノテーション
ツールのアノテーションは、特定のツールの基本的なリスクを説明するために MCP クライアントに送信されます。ほとんどのクライアントは、これらのヒントを信頼できないものとして扱いますが、確認プロンプトをユーザーに送信するタイミングを決定するために使用できます。
タイトル文字列とともに、次のブール値ヒントが定義されています。
readOnlyHint: true の場合、ツールは環境を変更しません。デフォルトは false です。destructiveHint: true の場合、ツールは破壊的なアクションを実行できます。false の場合、ツールは追加アクションのみを実行できます。デフォルト値は true です。idempotentHint: true の場合、同じ引数でツールを繰り返し呼び出しても、環境に副次的影響は発生しません。デフォルトは false です。openWorldHint: true の場合、ツールは外部エンティティの「オープンワールド」とやり取りできます。false の場合、ツールは内部エンティティとのみやり取りできます。たとえば、ウェブ検索ツールはオープン ワールドですが、メモリツールはオープン ワールドではありません。
破壊的ヒント: ❌ | べき等ヒント: ❌ | 読み取り専用ヒント: ✅ | オープン ワールド ヒント: ❌