优化路线上的经停点的顺序

默认情况下，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.optimizedIntermediateWaypointIndex 下的 waypoint_order 字段中，返回 routes 对象中的优化航点顺序。

示例

此请求要求优化从南澳大利亚州阿德莱德到南澳大利亚州每个主要葡萄酒产区的路线，然后返回阿德莱德。

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": "Coonawarra,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,geocodingResults.intermediates.intermediateWaypointRequestIndex' \
'https://routes.googleapis.com/directions/v2:computeRoutes'

Routes API 会对请求中提供的中间途经点进行索引，从 0 开始。例如：

0    {"address": "Barossa+Valley,SA"},
1    {"address": "Clare,SA"},
2    {"address": "Coonawarrav,SA"},
3    {"address": "McLaren+Vale,SA"}

使用请求中提供的四个途经点的索引号，服务随后会返回优化后的顺序：

"optimizedIntermediateWaypointIndex": [
                3,
                2,
                0,
                1
            ]