Directions API の概要

Directions API は、HTTP リクエストを受け取り、2 地点間の JSON または XML 形式のルートを返すサービスです。

Directions API を使用する理由

Directions API を使用すると、交通機関、車、徒歩、自転車など、複数の移動手段のルートを取得できます。

Directions API でできること

Directions API を使用すると、次のような詳細情報を含めて、地点間のルートを計算できます。

  • 交通機関、車、徒歩、自転車など、複数の移動手段のルート。
  • 一連のウェイポイントを使用してルートをマルチパートします。
  • 出発地、目的地、地点は、テキスト文字列（「シカゴ、イリノイ、ダーウィン、NT、オーストラリア」など）、プレイス ID、緯度と経度の座標など、複数の方法で指定できます。

Directions API の仕組み

Directions API は、ルートを計算するときに最も効率的なルートを返します。このプロダクトでは、最も効率的なルートを決定する際、次の交通要素を考慮します。

  • 移動時間（メイン）
  • 距離
  • ターン数

次のリクエストの例では、オンタリオ州トロントからケベック州モントリオールまでの運転ルートを JSON 形式で返します。

https://maps.googleapis.com/maps/api/directions/json
  ?destination=Montreal
  &origin=Toronto
  &key=YOUR_API_KEY

リソース

次の表は、Directions API で利用できるリソースと、その API から返されるデータをまとめたものです。

データリソース 返されるデータ 戻り値の形式
ルート

出発地と目的地は、プレイス ID、住所、または緯度と経度の座標の形式で指定します。詳細については、必須パラメータをご覧ください。

 ルート、区間、歩数に分かれた詳細なルート。詳しくは、ルートのレスポンスをご覧ください。
  • JSON
  • XML

Directions API の使用方法

1 設定する。 まず Google Cloud プロジェクトを設定するで、以下の設定手順を完了します。
2 デモを試す API キーと Cloud プロジェクトを取得したら、無料でルートデモをお試しください。Directions API のデモをご覧ください。
3 リクエストを作成する リクエストの例と、指定可能なオプション（移動手段、地点、ルート制限など）をご確認ください。ルート検索の例をご覧ください。
4 回答の基本を理解する データ レスポンスを調べて、アプリでルートデータを使用する準備をします。詳しくは、ルート レスポンスをご覧ください。
5 ルートデータを独自のアプリに組み込む このデータを使用して、移動距離と移動時間を計算できます。

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

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

Google マップサービスの Java クライアント、Python クライアント、Go クライアント、Node.js クライアントはコミュニティでサポートされているクライアント ライブラリで、Apache 2.0 ライセンスでオープンソース化されています。GitHub からダウンロードしてください。GitHub には、インストール手順やサンプルコードも用意されています。

次のステップ