ルート マトリックス リクエストは、出発地と目的地の地点の配列を入力として受け取ります。Routes API は、各出発地の地点から各目的地の地点までのルートを計算します。たとえば、2 つの出発地と 2 つの目的地を指定すると、API は 4 つの異なるルートを計算します。
API レスポンスには配列が含まれ、各配列要素は 1 つの出発地ウェイポイントから 1 つの目的地ウェイポイントへのルートに対応しています。そのため、2 つの出発地と 2 つの目的地を指定した場合、レスポンス配列には 4 つの要素(計算されたルートごとに 1 つ)が含まれます。
このレスポンスを使用して、ユーザーにさまざまなルート オプションを提示し、ユーザーが要件に適したルートを選択できるようにします。
フィールド マスクについて
ルートを計算するメソッドを呼び出すときは、レスポンスで返すフィールドを定義するフィールド マスクを指定する必要があります。返されるフィールドのデフォルト リストはありません。このリストを省略すると、メソッドはエラーを返します。
このドキュメントの例では、フィールド マスクを考慮せずにレスポンス オブジェクト全体を示しています。本番環境では、レスポンスにはフィールド マスクで明示的に指定したフィールドのみが含まれます。
詳しくは、返される情報を選択するをご覧ください。
著作権の表示について
検索結果をユーザーに表示するときは、次の著作権表示を含める必要があります。
Powered by Google, ©YEAR Google
次に例を示します。
Powered by Google, ©2023 Google
レスポンスでルートを特定する
レスポンスの各ルートを識別するには、originIndex
および destinationIndex
レスポンス プロパティを使用します。これらのプロパティには、ルートの計算に使用される入力 origin と入力 destination ウェイポイントのゼロベース インデックスが含まれます。つまり、リクエストの最初の出発地の地点と最初の目的地の地点が配列インデックス 0 にあるということです。
たとえば、レスポンスのルートには次のものが含まれます。
"originIndex": 1, "destinationIndex": 0
これらのプロパティは、入力配列のインデックス 1 の出発地の地点と、インデックス 0 の目的地の地点からルートが計算されたことを示します。
次の経路の場合:
"originIndex": 4, "destinationIndex": 1
ルートは、入力配列のインデックス 4 にある出発地ウェイポイントと、入力配列のインデックス 1 にある目的地ウェイポイントから計算されました。
回答について
API レスポンスを表す JSON オブジェクトには配列が含まれており、各配列要素は 1 つの出発地の地点から 1 つの目的地の地点へのルートを定義します。
各経路には、originIndex
プロパティと destinationIndex
プロパティのほかに、その経路に固有の情報(distanceMeters
、duration
、travelAdvisory
など)が含まれます。
レスポンスの形式は次のとおりです。
[ // One array element for each combination of origin and destination waypoints. { // The route for source waypoint 0 and destination waypoint 0. "originIndex": 0, "destinationIndex": 0, "status": { object (Status) }, "condition": enum (RouteMatrixElementCondition), "distanceMeters": integer, "duration": string, "staticDuration": string, "travelAdvisory": { object (RouteTravelAdvisory) }, "fallbackInfo": { object (FallbackInfo) } } { // The route for source waypoint 0 and destination waypoint 1. "originIndex": 0, "destinationIndex": 1, "status": { object (Status) }, "condition": enum (RouteMatrixElementCondition), "distanceMeters": integer, "duration": string, "staticDuration": string, "travelAdvisory": { object (RouteTravelAdvisory) }, "fallbackInfo": { object (FallbackInfo) } } … ]