Directions API の概要

Directions API は、HTTP リクエストを受け取り、場所間のルートを 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 で利用可能なリソースと、返されるデータを示します。

データリソース 返されたデータ 返品形式
ルート

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

 ルート、区間、ステップに分かれた詳細なルート案内。詳しくは、ルート レスポンスをご覧ください。
  • JSON
  • XML

Directions API の使用方法

1 セットアップする まず、Google Cloud プロジェクトを設定するから始め、その後の設定手順を完了します。
2 デモを試す API キーとクラウド プロジェクトを取得したら、無料のルート検索デモをお試しください。Directions API のデモをご覧ください。
3 リクエストを作成する リクエストの例を確認し、移動手段、ウェイポイント、ルート制限など、指定できるオプションについて学びます。指示の例をご覧ください。
4 レスポンスの基本を理解する データ レスポンスを確認して、アプリでルートデータを使用する準備をします。詳しくは、ルート レスポンスを取得するをご覧ください。
5 独自のアプリにルートデータを組み込む このデータを使用して、移動距離と所要時間を計算できます。

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

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

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

次のステップ