Distance Matrix API の概要

Distance Matrix API は、特定の移動手段の出発地と目的地を含む HTTPS リクエストを受け入れるサービスです。出発地と目的地の組み合わせごとに、移動距離と所要時間を返します。

Distance Matrix API を使用する理由

Distance Matrix API を使用すると、複数の出発地と目的地を結ぶ最も効率的な移動ルートを特定できます。たとえば、どのワーカーを現場に送信するか、どのウェアハウスからパッケージを送信するかなどです。

Distance Matrix API でできること

Distance Matrix API を使用すると、出発地と目的地のマトリックスに対して移動距離と移動時間を取得できます。車、自転車、交通機関、徒歩などの移動手段や、バス、地下鉄、電車、路面電車、電車などの移動手段など、複数のオプションを指定できます。

Distance Matrix API は、出発地と目的地間の推奨ルートに基づく情報を提供します。リクエストできる距離データの種類は次のとおりです。

  • 選択した移動手段の距離
  • 距離(キロメートルまたはマイル)
  • 交通状況に基づく推定移動時間

地図と API レスポンスの出発地と目的地を示す地図

Distance Matrix API の仕組み

Distance Matrix API は、任意の数の出発地(出発地)と目的地を使用し、各出発地とリクエストされたすべての目的地の間の距離と移動時間を返します。距離はリクエストの最初の出発地から始まり、徐々に次の出発地へと進んでいきます。

たとえば、リクエストで A と B を出発地、C と D を目的地として指定した場合、距離と移動時間の順序が次の順序で返されます。

  • A ~ C
  • A~D
  • B から C
  • B ~ D

次の例は、2 つの出発地(ワシントン DC とボストン)のリクエストで、1 つの目的地であるニューヨーク市ニューヨーク市を JSON 形式で指定したリクエストです。

https://maps.googleapis.com/maps/api/distancematrix/json
  ?destinations=New%20York%20City%2C%20NY
  &origins=Washington%2C%20DC%7CBoston
  &units=imperial
  &key=YOUR_API_KEY

リソース

次の表は、Distance Matrix API で使用可能なリソースと返されるデータをまとめたものです。

データリソース 返されるデータ 戻り値の形式
距離行列

出発地と目的地を、プレイス ID、住所、または緯度と経度の座標の形式で指定します。

  • 各出発地から各目的地までの距離と移動時間
  • 渋滞時間(運転モードと出発時刻を指定した場合)
  • JSON
  • XML

Distance Matrix API の使用方法

1 設定 Google Cloud プロジェクトの設定から始めて、次の設定手順を完了します。
2 距離行列のリクエストを試す API キーを取得したら、ブラウザから直接 Distance Matrix API のテストを開始できます。例については、スタートガイドサンプル リクエストをご覧ください。
3 より複雑なリクエストを作成する 複数の出発地と目的地を指定したリクエストを試してみてください。指定された出発時刻やルートの制限など、計算を制約するためのオプション パラメータについて学びます。 距離行列のリクエストとレスポンスのガイドのオプション パラメータをご覧ください。
4 レスポンスの基本を理解する データ レスポンスを確認して、アプリで距離行列データを使用するための準備をします。詳しくは、距離行列のレスポンスをご覧ください。
5 距離行列のデータを独自のアプリに組み込むことができます。 このデータを使用して移動距離と時間を計算できます。

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

次のいずれかのクライアント ライブラリを介して、任意の言語でこの API を呼び出します。

Google マップ サービス向けの Java クライアント、Python クライアント、Go クライアント、Node.js クライアントは、コミュニティがサポートするクライアント ライブラリで、Apache 2.0 ライセンスに基づいてオープンソース化されています。GitHub からダウンロードしてください。GitHub には、インストール手順とサンプルコードも記載されています。

次のステップ