查看路徑矩陣回應

路線矩陣要求採用起點和目的地陣列的輸入方式 路點。接著，Routes API 會計算每個起點之間的路線 每個目的地的路線控點舉例來說，如果您指定兩個來源 接著，API 會計算四個 路徑。

API 回應會包含陣列，其中每個陣列元素都對應至 由一個起點路點到一個目的地路線控點的路線因此，如果您在 指定兩個起點路點和兩個目的地路點 (Response 陣列) 包含四個元素，每個計算的路線各一個。

你可以使用回覆內容，為消費者提供不同的路線選項 然後讓使用者依據自身需求選取適當的路徑。

關於欄位遮罩

呼叫方法來計算路線時，必須指定欄位 會定義要在回應中傳回哪些欄位的遮罩。由於沒有 傳回的欄位預設清單如果省略此清單，則方法會傳回 錯誤。

本文件中的範例顯示的是整個回應物件，但不會擷取 欄位遮罩在正式環境中，回應會 只包含您在欄位遮罩中明確指定的欄位。

詳情請參閱「選擇要傳回的資訊」。

關於顯示著作權

向使用者顯示結果時，您必須附上以下著作權聲明：

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 的目的地路點。

關於回覆

JSON 物件 代表 API 回應會包含陣列，其中每個陣列元素 定義從一個起點路線控點到一個目的地路線點的路線。

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