はじめに
距離行列 API(レガシー)は、特定の交通手段の出発地と目的地を含む HTTPS リクエストを受け入れるサービスです。出発地と目的地の組み合わせごとに、移動距離と所要時間を返します。
Distance Matrix API を使用する理由
Distance Matrix API を使用すると、複数の出発地と目的地の候補から最も効率的な移動ルートを特定できます。たとえば、どの作業員を現場に派遣するか、どの倉庫から荷物を発送するかなどです。
Distance Matrix API でできること
Distance Matrix API を使用すると、複数の出発地と目的地間の移動距離と所要時間を取得できます。移動手段(車、自転車、公共交通機関、徒歩など)や公共交通機関のモード(バス、地下鉄、電車、路面電車、鉄道など)を含む、いくつかのオプションを指定できます。
Distance Matrix API は、出発地と目的地の間の推奨ルートに基づいて情報を提供します。リクエストできる距離データは次のとおりです。
- 選択した移動手段の距離
- 距離(キロメートルまたはマイル)
- 交通状況を考慮した推定所要時間
Distance Matrix API の仕組み
Distance Matrix API は、任意の数の出発地(出発地点)と目的地を使用し、リクエストの最初の出発地から始まり、次の出発地へと段階的に進みながら、各出発地とリクエストされたすべての目的地間の距離と所要時間を返します。
たとえば、リクエストで出発地として A と B、目的地として C と D を指定した場合、距離と所要時間は次の順序で返されます。
- A ~ C
- A~D
- B to C
- B ~ D
次の例は、ワシントン 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、住所、緯度と経度の座標の形式で指定します。 |
|
|
Distance Matrix API の使用方法
1 | セットアップする | Google Cloud プロジェクトを設定するから始め、その後の設定手順を完了します。 |
2 | 距離行列リクエストを試す | API キーを取得したら、ブラウザから Distance Matrix API のテストを開始できます。例については、スタートガイドのサンプル リクエストをご覧ください。 |
3 | より複雑なリクエストを作成する | 複数の出発地と目的地を指定するリクエストを試します。指定された出発時刻やルートの制限など、計算を制約する省略可能なパラメータについて学習します。距離行列のリクエストとレスポンス ガイドのオプション パラメータをご覧ください。 |
4 | レスポンスの基本を理解する | データ レスポンスを調べて、アプリで距離行列データを使用する準備をします。詳しくは、距離行列レスポンスをご覧ください。 |
5 | 距離行列データを独自のアプリに組み込む | このデータを使用して、移動距離と所要時間を計算できます。 |
利用可能なクライアント ライブラリ
次のいずれかのクライアント ライブラリを使用して、選択した言語でこの API を呼び出します。
- Google マップ サービス向け Java クライアント
- Google マップ サービス向け Python クライアント
- Google マップ サービス向け Go クライアント
- Google マップ サービス向け Node.js クライアント
Google マップ サービス向けの Java クライアント、Python クライアント、Go クライアント、Node.js クライアントは、コミュニティがサポートするクライアント ライブラリであり、Apache 2.0 ライセンスの下でオープンソース化されています。GitHub からダウンロードできます。インストール手順とサンプルコードも GitHub で確認できます。
次のステップ
- 距離行列の使用を開始する: スタートガイドをご覧ください。
- リクエストとレスポンスのサンプルを始める: 距離行列のリクエストとレスポンスに移動します。
- ベスト プラクティスに従う: ウェブ サービスのベスト プラクティスに移動します。