Distance Matrix API の概要

Distance Matrix API は HTTPS リクエストを受け付ける に特定の交通手段の出発地と目的地が含まれます。各 移動距離と所要時間が返されます。

Distance Matrix API を使用する理由

Distance Matrix API を使用すると、最も効率的な 複数の出発地と目的地を結ぶ移動ルートを作成します。対象 たとえば、どのワーカーをジョブサイトに送るか、どの倉庫から発送するかなどについて検討する必要があります。 提供します。

<ph type="x-smartling-placeholder">

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 とボストンの 2 つのルートがあり、それぞれ 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 には、インストール手順やサンプルコードも用意されています。

次のステップ