Distance Matrix API（以前のバージョン）の概要

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

はじめに

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 つの出発地（ワシントン D.C. とボストン）と 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 より複雑なリクエストを作成する 複数の出発地と目的地を指定するリクエストを試してください。計算を制約する省略可能なパラメータ（指定した出発時刻やルートの制限など）について学習します。Distance Matrix（従来版）のリクエストとレスポンスガイドの省略可能なパラメータをご覧ください。
4 レスポンスの基本を理解する データ レスポンスを調べて、アプリで距離行列データを使用する準備をします。詳細については、 距離行列のレスポンス をご覧ください。
5 距離行列データを独自のアプリに組み込む このデータを使用して、移動距離と所要時間を計算できます。

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

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

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

次のステップ