ルーティングマトリックス

ルーティイングマトリックスは、行と列に配列された長方形の配列です。行は、送信元に対応し、列は宛先に対応します。 マトリックスのエントリは、要求された内容に応じて、移動時間 ( 秒 ) または距離 ( メートル ) を表す整数です。

マトリックスの最初の次元は常に 行数 N です。2 番目の次元は列 数 M です。このようなマトリックスは M x N マトリックスと呼ばれ、次の一般的な形式になります。

原点と目的地の数が等しい場合、対応するマトリックスは正方形になります。 定義により、対角線上の各エントリについて、原点と目的地が一致します。 ただし、マトリックスは対称ではありませ ん。つまり、起点 o から終点 d のエントリは、起点 d から原点 o のエントリとは異なります。これは、ほとんどの場合、最短ルートのリターンルートが異なるためです。

レスポンス内の表現

API 応答は、ルーティングマトリックスを 1 次元の配列として表します。 位置 k の各エントリ は、 次の式で行 i および列 j のマトリックスのエントリに対応しています。

K = M·i + J

つまり、最初 の M エントリが最初の行、次の M エントリが 2 番目の行となります。

エラーのマトリックス

出発地と目的地の間のルートを計算できない場合があります。 この問題は、目的地が出発地から到達できないか、または出発地または目的地のいずれかがマップに一致しなかったために発生する可能性があります。 この場合、このようなエラーが少なくとも 1 つ発生すると、サービスは、マトリックスの各エントリにエラーコードが含まれた整数のマトリックスをレスポンスに追加します。 コード 0 はエラーなしを示しています。 コード 3 は、ルートが計算されたものの、いくつかの違反があることを意味します。たとえば、フェリーの回避が要求されたときにフェリーを使用したり、希望する運転時間に通行止めになっている道路を通過したりします。

その他の値については 、『 API リファレンス』を参照してください。