Compute Route Matrix の概要

欧州経済領域（EEA）のデベロッパー

Compute Route Matrix は、HTTPS リクエストを受け取り、異なる出発地と目的地の間のルートのマトリックスの距離と所要時間を返す Routes API サービスのメソッドです。複数の目的地について、最大 625 個のルート要素を踏まえて移動時間と距離を算出します。

運転ルートが必要ですか？ルートの方向については、Compute ルートの概要をご覧ください。

移行しますか？Distance Matrix API（以前のバージョン）から移行する場合は、Routes API に移行する理由から始まる移行手順をご覧ください。

Compute Route Matrix を使用する理由

Compute Route Matrix を使用すると、次のような配送スケジュールの最も効率的なルートを特定できます。

  • 一連の荷物を集荷するワーカーの最適な割り当て方法

  • 荷物を最終目的地に発送するのに最適な倉庫を特定する

Compute Route Matrix でできること

Compute Route Matrix を使用すると、複数の出発地と目的地の間の可能なルートの行列を取得できます。サーバーサイド リクエストごとに複数の出発地と目的地を指定できます。出発地の数と目的地の数の積は 625 までです。行列全体が計算される前にレスポンスの要素をストリーミングできるため、レスポンスのレイテンシが短縮されます。

このようなルートデータをリクエストして、複数の出発地と目的地の間で乗客、荷物、作業員を最も効率的にルート設定する方法を特定できます。

  • 選択した移動手段の距離（キロメートルまたはマイル）

  • 交通状況を考慮した推定所要時間

Compute Route Matrix の仕組み

ComputeRouteMatrix メソッドは、リクエストの詳細を含む JSON リクエスト本文を含む HTTP POST リクエストを受け入れます。少なくとも 1 つの出発地、2 つ以上の目的地、travelMode、および返すフィールドを指定するフィールド マスクが必要です。

例

curl -X POST -d '{
  "origins": [
    {
      "waypoint": {
        "location": {
          "latLng": {
            "latitude": 37.420761,
            "longitude": -122.081356
          }
        }
      }
    },
    {
      "waypoint": {
        "location": {
          "latLng": {
            "latitude": 37.403184,
            "longitude": -122.097371
          }
        }
      }
    }
  ],
  "destinations": [
    {
      "waypoint": {
        "location": {
          "latLng": {
            "latitude": 37.420999,
            "longitude": -122.086894
          }
        }
      }
    },
    {
      "waypoint": {
        "location": {
          "latLng": {
            "latitude": 37.383047,
            "longitude": -122.044651
          }
        }
      }
    }
  ],
  "travelMode": "DRIVE"
}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: YOUR_API_KEY' \
-H 'X-Goog-FieldMask: originIndex,destinationIndex,duration,distanceMeters,status,condition' \
'https://routes.googleapis.com/distanceMatrix/v2:computeRouteMatrix'

レスポンスには、すべての出発地と目的地のウェイポイントの組み合わせによるルートが含まれます。

リソース

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

データ リソース 返されたデータ 戻り値の形式
ComputeRouteMatrix 1 つの出発地経由地から 1 つの目的地経由地までのルートの配列を返します。 JSON

Compute Route Matrix の使用方法

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

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

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

次のステップ