本頁面由 Cloud Translation API 翻譯而成。

查看路徑矩陣回應

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

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

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

關於欄位遮罩

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

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

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

關於顯示著作權

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

Powered by Google, ©YEAR 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)
    }
  }
  …
]