路線矩陣要求會接受起點和目的地路線控點的輸入陣列。接著,Routes API 會計算從每個起點路線點到各個目的地路線控點的路線。舉例來說,如果您指定兩個起點路線控點和兩個目的地路線控點,API 會計算四個不同的路徑。
API 回應包含一個陣列,其中每個陣列元素都會對應至從一個起點路線點到一個目的地路線控點的路線。因此,如果您指定兩個起點路線控點和兩個目的地路線控點,則回應陣列會包含四個元素,每個計算的路線各一個。
透過此回應,您可以向客戶提供不同的路線選項,讓使用者選擇符合自身需求的路徑。
關於欄位遮罩
呼叫方法計算路線時,您必須指定欄位遮罩,以定義要在回應中傳回的欄位。沒有傳回欄位的預設清單。如果省略這份清單,這些方法就會傳回錯誤。
本文件中的範例顯示完整的回應物件,而不考慮欄位遮罩。在實際工作環境中,回應只會包含您在欄位遮罩中明確指定的欄位。
詳情請參閱選擇要傳回的資訊。
關於顯示版權
向使用者顯示結果時,您必須加入以下版權聲明:
Powered by Google, ©YEAR Google
例如:
Powered by Google, ©2023 Google
找出回應中的路徑
使用 originIndex
和 destinationIndex
回應屬性來識別回應中的各個路徑。這些屬性包含輸入 origin 的以零為基準的索引,以及用來計算路線的輸入「目的地」路線控點。這表示要求中的第一個起點路線和第一個目的地路線控點位於陣列索引 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) } } … ]