Оптимизируйте порядок остановок на маршруте

Разработчики Европейской экономической зоны (ЕЭЗ)

По умолчанию метод Compute Routes Routes API вычисляет маршрут через несколько остановок, называемых промежуточными точками остановки, в том порядке, в котором вы их указываете.

Вы можете заставить API Routes оптимизировать предоставленный маршрут, переставляя остановки в более эффективном порядке. Оптимизация путевых точек оптимизирует время в пути, но также учитывает другие факторы, такие как расстояние и количество поворотов, при выборе наиболее эффективного маршрута.

Для оптимизации точек маршрута

  1. Убедитесь, что ни одна из точек маршрута не имеет via установленного на true , например: {"address": "Clare,SA", "via": true} . Для получения дополнительной информации о промежуточных точках маршрута см. Укажите промежуточные точки маршрута .

  2. Убедитесь, что routing_preference не установлен на TRAFFIC_AWARE_OPTIMAL .

  3. Установите optimize_waypoint_order на true . Например:

    "optimizeWaypointOrder": "true",

  4. Укажите поле routes.optimizedIntermediateWaypointIndex в маске поля:

    ОТДЫХ

    -H X-Goog-FieldMask: routes.optimizedIntermediateWaypointIndex

    РПК

    const (fieldMask = "routes.optimizedIntermediateWaypointIndex")

Понять, как оптимизируется порядок точек маршрута

Вот как 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": "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'

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
            ]