ルート マトリックス レスポンスを確認する

ルート行列リクエストは、出発地と目的地のウェイポイントの配列を入力として受け取ります。Routes API は、各出発地の地点から各目的地の地点までのルートを計算します。たとえば、2 つの出発地と 2 つの目的地を指定すると、API は 4 つの異なるルートを計算します。

API レスポンスには配列が含まれており、各配列要素は 1 つの出発地ウェイポイントから 1 つの目的地ウェイポイントへのルートに対応しています。したがって、2 つの出発地と 2 つの目的地の地点を指定すると、レスポンス配列には、計算されたルートごとに 1 つずつ、4 つの要素が含まれます。

レスポンスを使用して、さまざまなルート オプションをユーザーに提示し、ユーザーが要件に適したルートを選択できるようにします。

フィールド マスクについて

ルートを計算するメソッドを呼び出すときは、レスポンスで返すフィールドを定義するフィールド マスクを指定する必要があります。返されるフィールドのデフォルト リストはありません。このリストを省略すると、メソッドはエラーを返します。

このドキュメントの例では、フィールド マスクを考慮せずにレスポンス オブジェクト全体を示しています。本番環境では、項目マスクで明示的に指定したフィールドのみがレスポンスに含まれます。

詳細については、返される情報を選択するをご覧ください。

著作権の表示について

結果をユーザーに表示する際には、次の著作権に関する声明を含める必要があります。

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)
    }
  }
  …
]