路線矩陣要求會將起點和目的地路線點陣列做為輸入內容。接著，Routes API 會計算從每個起點路線控點到每個目的地路線控點的路線。舉例來說，如果您指定兩個起點路線控點和兩個目的地路線控點，API 就會計算四個獨立的路線。
API 回應包含陣列，其中每個陣列元素都對應至從一個起點路線控點到一個目的地路線控點的路線。因此，如果您指定兩個起點路線控點和兩個目的地路線控點，回應陣列就會包含四個元素，每個計算路線一個。
您可以使用回應，為客戶提供不同的路線選項，然後讓使用者根據需求選取合適的路線。
關於欄位遮罩
呼叫方法來計算路線時，您必須指定欄位遮罩，定義要在回應中傳回哪些欄位。系統不會提供傳回欄位的預設清單。如果省略這個清單，方法會傳回錯誤。
本文件中的範例會顯示整個回應物件，但不會考量欄位遮罩。在實際工作環境中，回應只會包含您在欄位遮罩中明確指定的欄位。
詳情請參閱「選擇要傳回的資訊」。
關於顯示版權
向使用者顯示結果時，請務必加入下列版權聲明：
Powered by Google, ©YEAR Google
例如：
Powered by Google, ©2023 Google
在回應中指出路線
請使用 originIndex 和 destinationIndex 回應屬性，在回應中識別每個路線。這些屬性包含用於計算路線的輸入起點和輸入目的地路線點的以零為基底索引。也就是說，請求中的第一個起點路線點和第一個目的地路線點位於陣列索引 0。
例如，回應中的路線包含：
"originIndex": 1, "destinationIndex": 0
這些屬性表示路線是從輸入陣列中索引 1 的起點路標，以及索引 0 的目的地路標計算而來。
針對下一個路線：
"originIndex": 4, "destinationIndex": 1
路線是從輸入陣列中索引 4 的起點路線點，以及索引 1 的目的地路線點計算而得。
關於回應
代表 API 回應的 JSON 物件包含陣列，其中每個陣列元素都會定義從一個起點路標到一個目的地路標的路線。
除了 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)
}
}
…
]