最佳化路線上的停靠站順序

根據預設，Routes API Compute Routes 方法會按照您提供的順序計算行經多個停靠站 (稱為行經停靠點的路線控點) 的路線。

您可以讓 Routes API 以更有效率的順序重新安排停靠站，最佳化提供的路線。路線控點最佳化功能除了會最佳化交通時間，也會在決定哪條路線時也會考量距離和轉彎次數等其他因素。

最佳化路線控點

  1. 請確認路線中的所有路線控點都並未將 via 設為 true，例如：{"address": "Clare,SA", "via": true}。如要進一步瞭解中繼路線控點，請參閱「指定中繼路線控點」。

  2. 確認 routing_preference 並未設為 TRAFFIC_AWARE_OPTIMAL。

  3. 將 optimize_waypoint_order 設為 true。例如：

    "optimizeWaypointOrder": "true",

  4. 在欄位遮罩中指定 routes.optimizedIntermediateWaypointIndex 欄位：

    REST

    -H X-Goog-FieldMask: routes.optimizedIntermediateWaypointIndex

    遠端程序呼叫 (RPC)

    const (fieldMask = "routes.optimizedIntermediateWaypointIndex")

瞭解路線控點順序的最佳化方式

以下是 Routes API 如何最佳化路線中路線控點的順序：

  1. 根據您在要求中提供的路線順序 (從 0 開始)，自動為路線控點建立索引。

  2. 使用指派給要求中的路線控點的索引編號，將路線控點的順序最佳化。

  3. 傳回 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
            ]