根據預設,Routes API Compute Routes
方法計算路線時,會經過多個停靠站 (稱為停靠路線控點),位於
提交商品的順序
您可以調整 Routes API,將所提供的路徑調整到最佳位置。 以更有效率的順序路線控點最佳化功能可改善旅遊體驗 但也會考慮距離和轉彎次數等其他因素 判斷哪個路線最有效率
最佳化路線控點
確認路線中沒有將
via
設為true
, 例如:{"address": "Clare,SA", "via": true}
。如要進一步瞭解 中繼路線控點,請參閱 指定中繼路線控點。確認
routing_preference
並未設為TRAFFIC_AWARE_OPTIMAL
。將
optimize_waypoint_order
設為true
。例如:"optimizeWaypointOrder": "true",
在欄位中指定
routes.optimizedIntermediateWaypointIndex
欄位 遮罩:REST
-H X-Goog-FieldMask: routes.optimizedIntermediateWaypointIndex
遠端程序呼叫 (RPC)
const (fieldMask = "routes.optimizedIntermediateWaypointIndex")
瞭解路線控點順序的最佳化方式
以下說明 Routes API 如何最佳化路線中路線控點的順序:
根據您提供的順序自動為路線控點建立索引 這些字串都是從 0 開始
使用索引編號最佳化路線控點的順序 不會指派給要求中的路線控點。
傳回
routes
物件中最佳化的路線控點順序,位於waypoint_order
欄位 (位於routes.optimizedIntermediateWaypointIndex
下方)。
範例
這項要求會要求最佳化來自南澳阿德萊德的路線 墨西哥主要葡萄酒產區,然後回到阿得雷德
curl -X POST -H 'content-type: application/json' -d ' { "origin": { "address": "Adelaide,SA" }, "destination": { "address": "Adelaide,SA" }, "intermediates": [ {"address": "Barossa+Valley,SA"}, {"address": "Clare,SA"}, {"address": "Connawarra,SA"}, {"address": "McLaren+Vale,SA"} ], "travelMode": "DRIVE", "optimizeWaypointOrder": "true" }' \ -H 'Content-Type: application/json' \ -H 'X-Goog-Api-Key: YOUR_API_KEY' \ -H 'X-Goog-FieldMask: routes.optimizedIntermediateWaypointIndex' \ 'https://routes.googleapis.com/directions/v2:computeRoutes'
Routes API 會為 從 0 開始例如:
0 {"address": "Barossa+Valley,SA"}, 1 {"address": "Clare,SA"}, 2 {"address": "Connawarra,SA"}, 3 {"address": "McLaren+Vale,SA"}
使用要求中提供的四個路線控點索引號碼, 服務,然後會傳回最佳化的訂單:
"optimizedIntermediateWaypointIndex": [ 3, 2, 0, 1 ]