根據預設,Routes API 會傳回 default 路徑,這通常是從起點到目的地的最快路線。當您要求替代路徑時,API 會傳回最多三個路徑和預設路徑。方便客戶選擇最符合需求的路線。
要求替代路徑的注意事項
如要要求替代路線,請注意下列事項:
您只能針對沒有中繼路線控點的路線要求替代路徑。在路線指定中繼路線控點時,要求替代路線不會導致錯誤。不過,系統不會傳回替代路徑。
回應包含最多三個替代路徑。但有時候沒有可用的替代路徑,因此回應只會包含預設路徑。
由於計算替代路徑需要額外處理程序,要求替代路徑可能會增加 API 的回應時間。
替代路徑要求範例
如要要求替代路線,請將 computeAlternativeRoutes
設為 true
。以下範例說明如何在 computeRoutes 方法 (REST) 要求中要求替代路徑。
curl -X POST -d '{ "origin":{ "location":{ "latLng":{ "latitude":42.340173523716736, "longitude":-71.05997968330408 } } }, "destination":{ "location":{ "latLng":{ "latitude":42.075698891472804, "longitude": -72.59806562080408 } } }, "travelMode": "DRIVE", "routingPreference":"TRAFFIC_AWARE", "computeAlternativeRoutes": true }' \ -H 'Content-Type: application/json' -H 'X-Goog-Api-Key: YOUR_API_KEY' \ -H 'X-Goog-FieldMask: routes.duration,routes.distanceMeters,routes.routeLabels' \ 'https://routes.googleapis.com/directions/v2:computeRoutes'
在這個範例中,您指定了欄位遮罩,讓回應只包含每條路線的 duration
、distanceMeters,
和 routeLabels
屬性。您的客戶就能根據這些資訊選擇要採取的路線。詳情請參閱「選擇要傳回的資訊」。
替代路徑回應範例
在回應中,使用 routeLabels
陣列屬性找出觸及路徑:
針對預設路線,
routeLabels
屬性包含DEFAULT_ROUTE
。如有任何替代路線,
routeLabels
屬性會包含DEFAULT_ROUTE_ALTERNATE
。
在此範例中,回應包含預設路徑和兩個替代路徑。請注意,每條路線的 duration
和 distanceMeters
屬性值都不同:
{ "routes": [ { "distanceMeters": 150322, "duration": "5309s", "routeLabels": [ "DEFAULT_ROUTE" ] }, { "distanceMeters": 157614, "duration": "6879s", "routeLabels": [ "DEFAULT_ROUTE_ALTERNATE" ] }, { "distanceMeters": 189311, "duration": "7376s", "routeLabels": [ "DEFAULT_ROUTE_ALTERNATE" ] } ] }
在回應中加入折線
為方便使用者選取路線,請在回應中加入每條路線的折線。這樣就能在地圖上顯示每條折線。
如要加入折線,請在欄位遮罩中加入 routes.polyline
:
-H 'X-Goog-FieldMask: routes.duration,routes.distanceMeters,routes.routeLabels,routes.polyline'
回應接著會包含每條路線的折線:
{ "routes": [ { "distanceMeters": 150322, "duration": "5309s", "polyline": { "encodedPolyline": "mrlaGtavpLPLBTm…PgA^qC" }, "routeLabels": [ "DEFAULT_ROUTE" ] }, { "distanceMeters": 157614, "duration": "6879s", "polyline": { "encodedPolyline": "DmEd`@e@pCo@pCs@z…PgA^qC" }, "routeLabels": [ "DEFAULT_ROUTE_ALTERNATE" ] }, { "distanceMeters": 189311, "duration": "7376s", "polyline": { "encodedPolyline": "FVLL|Af@HPAV…PgA^qC" }, "routeLabels": [ "DEFAULT_ROUTE_ALTERNATE" ] } ] }