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 には、インストール手順とサンプルコードも用意されています。

次のステップ