Distance Matrix API

マトリックスAPIは、1回のリクエストで出発地と目的地のすべての組み合わせ間の移動時間と距離を計算します。典型的な用途には、ジョブに最も近いドライバーや技術者の特定、車両ルーティング問題の解決、顧客への配送時間枠の推定、施設計画のためのサービスエリアカバレッジの計算などがあります。

経路案内APIは、折れ曲がりの指示とジオメトリを含む2点間の単一の詳細ルートを返します。マトリックスAPIは、ルートジオメトリなしで複数の出発地-目的地ペアの距離と所要時間のテーブルを返します。多くの地点を効率的に比較する必要がある場合、マトリックスAPIは個別に経路案内を呼び出すよりも高速でコスト効率が高いです。

APIは1回のリクエストで最大100出発地×100目的地のマトリックスをサポートし、1回の呼び出しで最大10,000の出発地-目的地ペアを処理できます。マトリックスは正方形である必要はありません。最寄り地点の検索には1出発地×100目的地を送信し、車隊全体から顧客への割り当てには50×50を送信することができます。

マトリックスAPIは、自動車、徒歩、自転車、公共交通機関をサポートしています。移動モードはリクエストごとに設定します。1回のリクエスト内のすべてのペアは同じモードを使用します。混合モードの結果が必要な場合は、各モードで別々にリクエストを送信し、アプリケーション内でレスポンスをマージしてください。

デフォルトでは、マトリックスAPIは一般的な走行状況を代表する自由流速度を使用します。リアルタイムの交通量を考慮した所要時間は、対象プランで利用可能です。departure_timeパラメータに将来のタイムスタンプを設定すると、過去の交通パターンに基づいた時間帯別の移動時間推定値を受け取ることができます。

単一のクエリ地点を出発地として、候補地点のリストを目的地として送信します。APIは1回の呼び出しで、クエリ地点から各候補地点への移動時間と距離を返します。レスポンスを所要時間でソートすると、最寄りのオプションが見つかります。これは、各候補についてループで経路案内APIを呼び出すよりも大幅に効率的です。