このページは Cloud Translation API によって翻訳されました。

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

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

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

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

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

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

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

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

著作権の表示について

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

Powered by Google, ©YEAR Google

例:

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

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

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

"originIndex": 1,
"destinationIndex": 0

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

次のルートの場合:

"originIndex": 4,
"destinationIndex": 1

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

回答について

「 JSON オブジェクト API レスポンスを表す配列には配列が含まれ、各配列要素はは、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)
    }
  }
  …
]