Directions API クイック リファレンス

Directions API(従来版)は、車、徒歩、自転車、交通機関での移動について、複数の地点間のルート(経由地を含む複数区間のルート)を計算し、ルート、区間、ステップを JSON または XML で返すウェブサービスです。レガシー ステータスです。2026 年 10 月以降、新しい Google Cloud プロジェクトで有効にすることはできません。Routes API に移行してください。

Directions API: 主な特長

  • プロダクト: Directions API
  • 別名: Directions API(従来版)
  • カテゴリ: ルート
  • プラットフォーム: ウェブサービス(REST)
  • 実行場所: サーバー(バックエンド コード)
  • リリース ステージ: GA
  • ライフサイクル: レガシー
  • 置き換え後の API: Routes API
  • 概要: Directions API の概要
  • 対象地域: グローバル。対象範囲は地域と移動手段によって異なります(乗換案内は交通機関のデータに基づきます)。(カバレッジの詳細)

Directions API: 使用するケース

Directions API を使用するケース:

  • Directions API(従来版)がすでに有効になっていて、maps/api/directions を呼び出す既存の Google Cloud プロジェクトを維持している。
  • 既存のプロジェクトで、車、徒歩、自転車、交通機関(交通機関以外のモードのウェイポイントのみ)のサーバーサイド ルートを JSON または XML で取得する必要がある。

Directions API を使用すべきでない場合:

  • 新しい Google Cloud プロジェクトを開始している。2026 年 10 月以降、新しいプロジェクトで Directions API(従来版)を有効にすることはできません。代わりに Routes API を使用してください。
  • 新しいルーティング機能とパフォーマンスの向上が必要です。代わりに Routes API を使用してください。
  • 1 つのリクエストで、複数の出発地と目的地について移動時間と距離を計算する必要がある。代わりに Routes API を使用してください。

Directions API: 設定

Directions API: よくある間違い

  • 問題: 以前の API が有効になっていないプロジェクトから Directions API(以前のバージョン)へのリクエストが LegacyApiNotActivatedMapError で失敗する。修正方法: アプリの所有者である場合は、Routes API に移行してください。移行中またはアプリ アップデートを待つ間の短期的な解決策として、以前の API の有効化フォームに記入して以前の API を有効にできます。/maps/legacy をご覧ください。
  • 問題: ウェイポイントに via: 接頭辞を使用すると、厳密な通過点となるため、大幅な迂回や ZERO_RESULTS ステータスが発生する可能性があります。修正方法: 厳密な通過点が必要な場合を除き、立ち寄りウェイポイント(via: 接頭辞なし)を使用します。/maps/documentation/directions/get-directions をご覧ください。
  • 問題: 11 ~ 25 個のウェイポイント、optimize:true、交通状況を考慮した所要時間(duration_in_traffic)、side_of_road または heading の位置修飾子を含むリクエストは、より高額な Directions Advanced(Pro)SKU で課金されます。修正方法: これらの機能は必要な場合にのみ使用します。Essentials SKU を維持するには、ウェイポイントを 10 個以下に抑え、optimize:true、departure_time(運転の場合)、side_of_road、heading を省略します。/maps/billing-and-pricing/sku-details/legacy#directions-advanced-pro-sku をご覧ください。
  • 問題: 運転の場合、departure_time を過去にすることはできません(リクエストは INVALID_REQUEST で失敗します)。departure_time がない場合、ルートと所要時間は時間帯に依存しない平均的な交通量を使用し、duration_in_traffic は返されません。修正: departure_time を now に設定するか、mode=driving を使用して将来の時刻に設定して、duration_in_traffic を取得します。duration_in_traffic を返すリクエストは、Directions Advanced(Pro)SKU で課金されます。/maps/documentation/directions/get-directions をご覧ください。