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

ルート行列リクエストは、出発地と目的地のウェイポイントの配列を入力として受け取ります。その後、Routes API が各出発地点からのルートを計算します。 ありますたとえば、2 つのオリジンを 2 つの目的地の地点に到着すると、API は 4 つの routes:

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

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

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

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

このドキュメントの例では、レスポンス オブジェクト全体を 考慮する必要があります本番環境では、次のようなレスポンスが返されます。 フィールド マスクで明示的に指定したフィールドのみを含めます。

詳しくは、返される情報を選択するをご覧ください。

著作権の表示について

検索結果をユーザーに表示するときは、次の著作権表示を含める必要があります。

Powered by Google, ©YEAR Google

例:

Powered by Google, ©2023 Google

レスポンスでルートを特定する

originIndexdestinationIndex のレスポンス プロパティを使用して、 レスポンスの各ルートが含まれます。これらのプロパティには、次のゼロベースのインデックスが含まれます。 入力 origin と入力 destination ウェイポイントで、 ありますこれが最初の出発地と目的地の 配列のインデックス 0 にあります。

たとえば、レスポンスのルートには次のものが含まれます。

"originIndex": 1,
"destinationIndex": 0

これらのプロパティは、ルートが出発地から計算されたことを示します 入力配列のインデックス 1 にあるウェイポイントと、 インデックス 0。

次のルートの場合:

"originIndex": 4,
"destinationIndex": 1

ルートは、入力画像のインデックス 4 にある出発地の地点から計算されました 入力配列のインデックス 1 にある目的地の地点から順に返されます。

回答について

JSON オブジェクト API レスポンスを表す配列には配列が含まれ、各配列要素は は、1 つの出発地ウェイポイントから 1 つの目的地ウェイポイントへのルートを定義します。

originIndex プロパティと destinationIndex プロパティに加え、各ルートは そのルートに固有の情報(distanceMetersdurationtravelAdvisory

レスポンスの形式は次のとおりです。

[
  // 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)
    }
  }
  
]