Установить остановку на маршруте

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

Вы можете назначить остановку на маршруте, например, для посадки или высадки пассажиров, двумя способами:

  • Добавить промежуточную точку маршрута : это вариант по умолчанию. Добавьте промежуточную точку маршрута между начальной и конечной точками в массиве intermediates . Механизм построения маршрута привязывает эту точку к ближайшей проходимой дороге и делит маршрут на сегменты RouteLeg , соединенные этой остановкой.
  • Укажите vehicleStopover : Если вы хотите, чтобы механизм построения маршрута выполнял дополнительный анализ для избегания участков дороги, непригодных для остановки, таких как автомагистрали, туннели или эстакады, установите vehicleStopover: true для путевой точки.

Добавить промежуточную точку маршрута

Чтобы установить остановку на маршруте, добавьте промежуточную точку в массив intermediates в вашем запросе.

Добавление промежуточной точки маршрута приводит к следующим последствиям:

  • Маршрут делится на сегменты RouteLeg : каждый сегмент соединяет одну остановку со следующей.
  • Координаты привязываются к дороге : система построения маршрута привязывает ваши координаты широты и долготы, которые могут находиться на крыше или во дворе, к ближайшему проходимому участку дороги.

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

Пример: Добавить промежуточную точку маршрута

В следующем примере показано, как установить остановку на маршруте, добавив промежуточную точку в POST-запрос computeRoutes :

curl -X POST -d '{
  "origin":{
    "location":{
      "latLng":{
        "latitude": 37.419734,
        "longitude": -122.0827784
      }
    }
  },
  "destination":{
    "location":{
      "latLng":{
        "latitude": 37.417670,
        "longitude": -122.079595
      }
    }
  },
  "intermediates": [
    {
      "location":{
        "latLng":{
          "latitude": 37.419734,
          "longitude": -122.0807784
        }
      }
    }
  ],
  "travelMode": "DRIVE"
}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: YOUR_API_KEY' \
-H 'X-Goog-FieldMask: routes.duration,routes.distanceMeters,routes.legs' \
'https://routes.googleapis.com/directions/v2:computeRoutes'

Для получения дополнительной информации о промежуточных точках маршрута и его участках см. раздел «Установка промежуточных точек маршрута» .

Укажите место остановки транспортного средства для выбора подходящего места посадки и высадки.

Хотя стандартная промежуточная точка маршрута привязывается к ближайшей дороге, эта дорога не всегда подходит для остановки транспортного средства. Если вы хотите, чтобы механизм построения маршрута выполнил дополнительный анализ для оценки пригодности дороги для посадки или высадки, установите для промежуточной точки параметр vehicleStopover: true .

Если установить vehicleStopover: true , механизм построения маршрута оценивает потенциальные участки дорог и пытается избегать дорог, непригодных для остановки, таких как автомагистрали, туннели и эстакады.

Например, рассмотрим место, где наземная дорога проходит непосредственно над автомагистралью внутри туннеля: * Стандартная промежуточная точка маршрута : привязывается к автомагистрали или туннелю под ней, если она геометрически ближе к вашим координатам. * Остановка транспортного средства : выполняет дополнительный анализ для объезда автомагистрали и туннеля, привязывая точку остановки к наземной дороге, подходящей для остановки.

Пример: Укажите точку остановки транспортного средства (vehicleStopover) на путевой точке.

В следующем примере показано, как установить vehicleStopover: true для промежуточной точки маршрута в полном POST-запросе:

curl -X POST -d '{
  "origin":{
    "location":{
      "latLng":{
        "latitude": 37.419734,
        "longitude": -122.0827784
      }
    }
  },
  "destination":{
    "location":{
      "latLng":{
        "latitude": 37.417670,
        "longitude": -122.079595
      }
    }
  },
  "intermediates": [
    {
      "location":{
        "latLng":{
          "latitude": 37.419734,
          "longitude": -122.0807784
        }
      },
      "vehicleStopover": true
    }
  ],
  "travelMode": "DRIVE"
}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: YOUR_API_KEY' \
-H 'X-Goog-FieldMask: routes.duration,routes.distanceMeters,routes.legs' \
'https://routes.googleapis.com/directions/v2:computeRoutes'

Для получения дополнительной информации о типах и параметрах путевых точек см. раздел «Типы и параметры путевых точек» .