Directions API を使用するメリット
Directions API では、複数の移動手段(交通機関、車、徒歩、自転車など)のルートを取得できます。
Directions API でできること
Directions API を使用すると、ロケーション間のルートを計算して、次のような情報を取得できます。
- 交通機関、車、徒歩、自転車など、複数の移動手段のルート。
- 一連のウェイポイントを使用したマルチパート ルート。
- 出発地、目的地、地点は、テキスト文字列(「Chicago, IL」、「Darwin, NT, Australia」など)、プレイス ID、緯度と経度の座標など、複数の方法で指定できます。
Directions API の仕組み
Directions API は、ルートの計算時に最も効率的なルートを返します。このプロダクトでは、最も効率的なルートを決定する際に、次の旅行要素を考慮します。
- 移動時間(メイン)
- 距離
- 右左折の回数
次のリクエストの例では、オンタリオ州トロントからケベック州モントリオールまでの運転ルートが JSON 形式で返されます。
https://maps.googleapis.com/maps/api/directions/json ?destination=Montreal &origin=Toronto &key=YOUR_API_KEY
リソース
次の表は、Directions API で利用できるリソースと返されるデータをまとめたものです。
データリソース | 返されるデータ | 戻り値の形式 |
---|---|---|
ルート
出発地と目的地を、プレイス ID、住所、または緯度と経度の座標の形式で指定します。詳細については、必須パラメータをご覧ください。 |
ルート、区間、歩数に分割された詳細なルート。詳細については、ルートのレスポンスをご覧ください。 |
|
Directions API の使用方法
1 | 設定 | Google Cloud プロジェクトの設定から始めて、次の設定手順を完了します。 |
2 | デモを試す | API キーと Cloud プロジェクトを作成したら、手順のデモを無料で試します。Directions 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 には、インストール手順とサンプルコードも記載されています。
次のステップ
- Directions API の使用を開始する: スタートガイドに移動します。
- ルートのリクエストを開始する: ルートを検索するに移動します。
- ベスト プラクティスを実践する: ウェブサービスのベスト プラクティスをご覧ください。