Pro SKU で、Maps Experience エージェントツールの機能をさらに活用しましょう。アクセスについては、営業担当者にお問い合わせください。

Google は AI 技術を使用して、コンテンツをご希望の言語に翻訳しています。AI 翻訳には誤りが含まれる場合があります。

ルートを計算する

compute_routes ツールは、指定された移動手段の出発地と目的地の間のルートを返します。レスポンスには、ルートの距離と所要時間が含まれます。デフォルトでは、ルートはライブ交通情報なしで計算されます。Pro では、リアルタイムの交通情報を考慮したルート設定と、より多くの経由地を含むルート設定が追加されます。

このページでは、Pro オプションを含むリクエストオプション、レスポンスの内容、リクエストの課金方法について説明します。ツールの完全なスキーマについては、compute_routes リファレンスをご覧ください。

リクエストオプション

オプション	説明
`origin`、`destination`	必須。それぞれがウェイポイント（`address`（人が読める形式の住所または Plus Codes）、`place_id`、`lat_lng`）です。形式を混在させることもできます。たとえば、出発地には住所、目的地にはプレイス ID を指定できます。
`travel_mode`	移動手段。`DRIVE`（デフォルト）、`WALK`、`BICYCLE`、`TRANSIT` のいずれかです。`WALK` ルートはベータ版であり、歩道や歩行者用通路が明確に表示されないことがあります。アプリに表示するすべての徒歩ルートについて、この警告をユーザーに表示する必要があります。
`routing_preference`	ルートの計算に交通データを使用する方法: `ROUTING_PREFERENCE_TRAFFIC_UNAWARE`（デフォルト）または `ROUTING_PREFERENCE_TRAFFIC_AWARE_OPTIMAL`（Pro オプション）。`ROUTING_PREFERENCE_TRAFFIC_AWARE_OPTIMAL` は `WALK` または `BICYCLE` ではサポートされていません。トラフィックアウェアルーティングをご覧ください。
`intermediate_waypoints`	出発地と目的地の間の経由地（順序付き）。ルートは、指定された順序でこれらの地点を通過します。リクエストには、最大 10 個の中間地点を含めることができます。Pro オプションでは 11 ～ 25 個の中間地点を含めることができます。25 を超えるリクエストは `INVALID_ARGUMENT` エラーを返します。乗換案内では、中間の経由地はサポートされていません。
`departure_time` または `arrival_time`	出発地を出発する時刻または目的地に到着する時刻（RFC 3339 タイムスタンプ）。設定できるのは 1 つだけです。デフォルトは現在の時刻に出発します。`TRANSIT` の場合、時刻は過去 7 日間または将来 100 日間まで指定できます。他の移動手段の場合、時間は過去に設定できず、最大 365 日先まで設定できます。
`compute_alternative_routes`	`true` の場合、代替ルートが利用可能であれば、レスポンスには推奨ルートに加えて代替ルートが含まれます。デフォルトは `false` です。
`include_polyline`	`true` の場合、レスポンスの各ルートに `encodedPolyline` が含まれます。デフォルト値は `false` です。
`location_bias`	テキストウェイポイントの解決方法をバイアスする緯度と経度（住所の曖昧さを解消する場合など）。

Pro オプション

2 つのオプションで Pro SKU を選択します。いずれかまたは両方を使用するリクエストは、Pro SKU で課金されます。

Pro オプション	用途
`routing_preference` を `ROUTING_PREFERENCE_TRAFFIC_AWARE_OPTIMAL` に設定	ユーザーが、交通状況、渋滞、または現在の交通状況を考慮した移動時間について尋ねている。トラフィックアウェアルーティングをご覧ください。
11 ～ 25`intermediate_waypoints`	出発地と目的地の間に 10 か所以上の経由地が必要なルート。

移動モード、タイミング、代替ルート、ポリライン、位置バイアスなど、その他のオプションはすべて Essentials SKU で課金されます。

トラフィックを考慮したルーティング

デフォルトでは、ルートはライブ交通状況（ROUTING_PREFERENCE_TRAFFIC_UNAWARE）なしで計算されます。この設定では、レイテンシが最も低くなります。徒歩ルートや大まかな計画など、交通状況が重要でない、または適用されないリクエストに適しています。

routing_preference を ROUTING_PREFERENCE_TRAFFIC_AWARE_OPTIMAL に設定すると、交通状況データが利用可能な場合に、現在の交通状況を考慮してルートと所要時間が計算されます。ユーザーが現在の運転時間を尋ねた場合に使用します。TRANSIT ルートの場合、この設定では、遅延やキャンセルなどのリアルタイムの交通機関データが利用可能な場合に使用されます。WALK ルートまたは BICYCLE ルートではサポートされていません。これらのリクエストは INVALID_ARGUMENT エラーを返します。これは Pro オプションであるため、リクエストは Pro SKU で課金されます。このオプションを使用すると、レイテンシも増加します。

制限付き GA の期間中、プロジェクトが Pro の許可リストに登録されていない場合、このオプションは ROUTING_PREFERENCE_TRAFFIC_UNAWARE として扱われます。詳細については、制限付き GA の Pro オプションをご覧ください。

例

次のリクエストは、1 つの中間地点とエンコードされたポリラインを含む、交通状況を考慮した運転ルートをリクエストします。Pro SKU で請求されます。

{
  "method": "tools/call",
  "params": {
    "name": "compute_routes",
    "arguments": {
      "origin": {"address": "Ferry Building, San Francisco, CA"},
      "destination": {"address": "Golden Gate Park, San Francisco, CA"},
      "intermediate_waypoints": [
        {"address": "Palace of Fine Arts, San Francisco, CA"}
      ],
      "travel_mode": "DRIVE",
      "routing_preference": "ROUTING_PREFERENCE_TRAFFIC_AWARE_OPTIMAL",
      "include_polyline": true
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}

レスポンス

レスポンスには、推奨度の高い順に並べ替えられた routes[] が含まれます。compute_alternative_routes が true でない限り、返されるルートは 1 つだけです。各ルートには次のものが含まれます。

distanceMeters: ルートの移動距離（メートル単位）。
duration: ルートの移動に必要な時間。ROUTING_PREFERENCE_TRAFFIC_AWARE_OPTIMAL を使用すると、所要時間に交通状況が考慮されます。
encodedPolyline: include_polyline が true の場合の、エンコードされたポリラインとしてのルートのパス。他の Google Maps Platform API と組み合わせて、地図上にルートを描画できます。
attribution: ルートとともに表示する必要がある帰属情報。帰属表示の要件をご覧ください。

制限付き一般提供中の Pro オプション

制限付き GA 期間中、Pro オプションは Pro の許可リストに登録されているプロジェクトでのみ使用できます。プロジェクトがまだ許可リストに登録されていない場合:

ROUTING_PREFERENCE_TRAFFIC_AWARE_OPTIMAL は ROUTING_PREFERENCE_TRAFFIC_UNAWARE として扱われ、リクエストは Essentials SKU で課金されます。
10 個を超える中間地点を含むリクエストは、INVALID_ARGUMENT エラー（「サポートされる中間地点は最大 10 個です」）を返します。

アクセスをリクエストするには、制限付き GA 中の Pro オプションをご覧ください。

課金と割り当て

各 compute_routes リクエストは 1 つの課金対象イベントです。

Pro オプションを使用しないリクエストは、Essentials SKU で課金されます。
Pro オプションを使用するリクエストは、Pro SKU で課金されます。1 つのリクエストで両方の Pro オプションを使用しても、料金は変わりません。Pro の料金については、Essentials、Pro、Google マップによるグラウンディングの比較をご覧ください。

代替ルート、ポリライン、出発時刻、到着時刻、別の移動手段をリクエストしても、SKU は変更されません。

compute_routes の割り当ては、プロジェクトごとに 1 分あたり 300 クエリで、両方の SKU で共有されます。料金については、メインの料金表とインドの料金表をご覧ください。

上限

リクエストに含めることができる中間地点は最大 25 個です。11 ～ 25 個は Pro オプションです。これを超えるリクエストは INVALID_ARGUMENT エラーを返します。
乗換案内では、中間のウェイポイントはサポートされていません。中間ウェイポイントを含む乗換案内リクエストは、INVALID_ARGUMENT エラーを返します。
ROUTING_PREFERENCE_TRAFFIC_AWARE_OPTIMAL は、徒歩またはサイクリングルートではサポートされていません。
乗換案内ルートの場合、出発時刻と到着時刻は、過去 7 日間または 100 日先まで指定できます。他の移動手段の場合、過去の日時は指定できません。また、最大 365 日先まで指定できます。
ウェイポイントの座標は、有効な地理的境界内（緯度 -90 ～ 90、経度 -180 ～ 180）に存在する必要があります。
このツールは、ターンバイターンのステップ、区間、交通機関の路線の詳細を返しません。