Distance Matrix API クイック リファレンス

Distance Matrix API(レガシー)は、出発地と目的地のマトリックスについて、各ペア間の推奨ルートに基づいて移動距離と移動時間を返すウェブサービスです。移動手段(車、徒歩、自転車、交通機関)、交通機関モード、単位、交通状況に基づく所要時間の出発時刻を設定できます。JSON または XML を返します。

Distance Matrix API: 主な特長

  • プロダクト: Distance Matrix API
  • 別名: Distance Matrix API(従来版)、Distance Matrix(従来版)
  • カテゴリ: ルート
  • プラットフォーム: ウェブサービス(REST)
  • 実行場所: サーバー(バックエンド コード)
  • リリース ステージ: GA
  • ライフサイクル: レガシー
  • 置き換え後の API: Routes API
  • 概要: Distance Matrix API の概要

Distance Matrix API: 使用するタイミング

Distance Matrix API の用途:

  • Distance Matrix API(従来版)がすでに有効になっていて、/maps/api/distancematrix を呼び出す既存のプロジェクトを管理している。
  • サーバーから、複数の出発地と複数の目的地間の移動距離と移動時間を取得する必要がある。
  • departure_time とオプションの traffic_model を使用して、運転時の交通状況を考慮した所要時間を取得する必要があります。

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

  • 新しい Google Cloud プロジェクトを開始する。2026 年 10 月以降、新しいプロジェクトで Distance Matrix API(レガシー)を有効にすることはできません。代わりに Routes API を使用してください。
  • 新しい機能、またはストリーミング レスポンス(computeRouteMatrix)で最大 625 個の要素を含むルート マトリックスが必要な場合は、代わりに Routes API を使用してください。
  • 距離と所要時間の値だけでなく、地点間のステップとポリラインを含む完全なルートが必要です。代わりに Routes API を使用してください。

Distance Matrix API: 設定

Distance Matrix API: よくある間違い

  • 問題: サーバーサイドのリクエストは、100 要素(出発地 × 目的地)に制限され、出発地は 25 か所、目的地は 25 か所に制限されています。これより大きいリクエストは、MAX_ELEMENTS_EXCEEDED または MAX_DIMENSIONS_EXCEEDED を返します。修正方法: マトリックスを、要素数が 100 以下、出発地または目的地が 25 以下のリクエストに分割します。/maps/documentation/distance-matrix/usage-and-billing#usage-limits をご覧ください。
  • 問題: departure_time を指定しない場合、ルートと所要時間は平均的な交通状況(時間的な要素を考慮に入れない)に基づいて選択され、duration_in_traffic は返されません。結果は時間の経過とともに変化する可能性があります。修正方法: departure_time を now に設定するか、mode=driving を使用して将来の時刻に設定すると、交通状況を考慮した所要時間を取得できます。交通情報のリクエストは、課金レートが高くなります。/maps/documentation/distance-matrix/distance-matrix をご覧ください。
  • 問題: units パラメータは、距離フィールドのテキストのみを変更します。距離の値は常にメートル単位です。修正: distance.value をメートルとして読み取るか、表示に distance.text を使用します。/maps/documentation/distance-matrix/distance-matrix をご覧ください。
  • 問題: Distance Matrix API(従来版)が有効になっていないプロジェクトからこの API を呼び出すと、status で REQUEST_DENIED が返され、LegacyApiNotActivatedMapError にリンクする error_message が返されます。AI アシスタントは、デフォルトでレガシー API コードを生成することがよくあります。修正: Routes API computeRouteMatrix(X-Goog-FieldMask ヘッダー付き)に移行します。短期的な対策として、フォームでのみ以前の API を有効にします。/maps/legacy#LegacyApiNotActivatedMapError をご覧ください。