Compute Routes の概要

Compute Routes は、HTTPS リクエストを受け取り、2 つの場所間の最適なルートを返す Routes API サービスのメソッドです。複数の地点間の移動について、交通機関や自転車、車、原動機付自転車、徒歩でのルートをリアルタイムの交通情報とともに示します。

ルートマトリックスが必要な場合ルート マトリックスの詳細については、Compute Route Matrix の概要をご覧ください。

移行中ですか？Distance Matrix API（従来版）から移行する場合は、Routes API に移行する理由から移行手順をご覧ください。

Compute Routes を使用する理由

Compute Routes では、さまざまなルート詳細を使用して、費用と品質を最適化しながら、設定に応じて車両や荷物をルーティングできます。

Compute ルートでできること

Routes API の Compute Routes メソッドを使用すると、次のことができます。

  • さまざまな移動手段のルートを検索し、1 つまたは複数のデスティネーションに移動できます。

    • 移動手段: 公共交通機関、車、二輪車、徒歩、自転車。

    • 一連のウェイポイント。最も効率的な順序で移動するように最適化できます。

  • 出発地、目的地、経由地を複数の方法で指定する:

    • テキスト文字列。例: 「Chicago, IL」、「Darwin, NT, Australia」、「1800 Amphitheatre Parkway, Mountain View, CA 94043」、「CWF6+FWX Mountain View, California」

    • プレイス ID

    • 緯度と経度の座標（車両の向きを含む場合もあります）

  • ニーズと目標に基づいてルート オプションを微調整します。

  • フィールド マスクを使用して必要なデータのみをリクエストすることで、レイテンシと品質を制御できます。これにより、不要な処理時間やリクエストの請求レートの増加を回避できます。詳しくは、返す情報を選択するをご覧ください。

Compute Routes の仕組み

Routes API の ComputeRoutes メソッドは、リクエストの詳細を含む JSON リクエスト本文を含む HTTP POST リクエストを受け入れます。送信元、宛先、travelMode、返すフィールドを指定するフィールド マスクが必要です。

例

curl -X POST -d '{
    "origin": {
      "address": "1800 Amphitheatre Parkway, Mountain View, CA 94043"
    },
    "destination": {
      "address": "Sloat Blvd &, Upper Great Hwy, San Francisco, CA 94132"
    },
  "travelMode": "DRIVE"
  }' \
  -H 'Content-Type: application/json' -H 'X-Goog-Api-Key: YOUR_API_KEY' \
  -H 'X-Goog-FieldMask: routes.duration,routes.distanceMeters' \
  'https://routes.googleapis.com/directions/v2:computeRoutes'

サービスは、リクエストされたルートを計算し、リクエストされたフィールドを返します。

リソース

次の表に、Routes API Compute Routes メソッドで使用可能なリソースと、返されるデータを示します。

データリソース 返されたデータ 返品形式
ComputeRoutes ルート、区間、ステップを返します。リクエストに応じて、代替ルートも返します。 JSON

Compute Routes の使用方法

1 セットアップする まず、Google Cloud プロジェクトを設定するから始め、その後の設定手順を完了します。
2 Routes API の課金方法について 詳細については、使用量と課金をご覧ください。
3 ルートを計算してレスポンスを確認する 詳細については、ルートを取得するとルート レスポンスを確認するをご覧ください。

利用可能なクライアント ライブラリ

Compute ルートで使用可能なクライアント ライブラリのリストについては、クライアント ライブラリをご覧ください。

次のステップ