Маршрут с использованием токенов точек навигации

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

Токены точек навигации позволяют отправлять ключевую контекстную информацию о пункте назначения в Navigation SDK для Android, Navigation SDK для iOS или Routes API, чтобы улучшить маршрутизацию и работу водителя. Это полезно, например, для доставки еды или совместных поездок, когда без ввода пользователя точка получения или высадки может быть неоднозначной.

Чтобы создать и передать токен точки навигации, используйте метод Destinations в Geocoding API. Это позволит пользователям выбирать предпочтительное местоположение из списка точек навигации. Выбранный пользователем вариант становится точкой навигации, возвращаемой методом Destinations в Geocoding API.

Затем вы можете передать токен точки навигации, который содержит как координаты пункта назначения, так и контекстную информацию, в Navigation SDK для Android, Navigation SDK для iOS или Routes API, где создается путевая точка для точной маршрутизации. Пункт назначения будет выделен для водителя с помощью Navigation SDK на основе места, с которым связан токен.

Пример: совместные поездки

Обзор

В этом примере показано, как объединить Geocoding API, Routes API и Navigation SDK для iOS или Android, чтобы создать приложение для совместных поездок, которое рассчитывает стоимость маршрута и направляет водителей к правильной точке посадки.

Вот что нужно сделать:

  1. Получите токен точки навигации с помощью Geocoding API.
  2. Используйте Routes API, чтобы рассчитать маршрут и закодировать его в токен маршрута.
  3. Передайте в Navigation SDK токен точки навигации и токен маршрута.
  4. Используйте Navigation SDK, чтобы проложить маршрут до нужной точки посадки.

Ссылки на документацию по Routes API, Navigation SDK для iOS и Navigation SDK для Android приведены в разделе Дополнительная информация.

На этой схеме показано, как приложение для совместных поездок или доставки использует Geocoding API, Routes API и Navigation SDK для iOS или Android, чтобы проложить маршрут для водителя с помощью токена маршрута и токена точки навигации.

Диаграмма использования для райдшеринга или доставки
Диаграмма варианта использования для совместных поездок или доставки

Пример для совместных поездок

Представьте себе сервис совместных поездок, в котором есть приложение для пассажиров, позволяющее заказать поездку, и приложение для водителей, позволяющее получать уведомления о заказах и информацию о маршруте.

На этом изображении показаны примеры приложения для совместных поездок, в котором выбрана точка навигации, и приложения для водителей, использующего Navigation SDK для Android, чтобы точно проложить маршрут.

Примеры приложений для клиентов и водителей

Когда клиент открывает приложение, оно вызывает метод Destinations в Geocoding API и предлагает клиенту выбрать одну из возможных точек навигации:

Потребитель выбирает пункт выдачи

Пользователь выбирает нужную точку из массива navigationPoints в теле ответа на запрос SearchDestinations:

"navigationPoints": [
    {
      "navigationPointToken": <encoded navigation point token>,
      "displayName": "South Entrance",
      "travelModes": ["DRIVE"],
      "usages": ["PICKUP","DROPOFF"],
      "location": {
        "lat": 37.3940894,
        "lng": -122.0788389
      }
    }
]

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

Наконец, токен точки навигации и токен маршрута передаются в мобильное приложение водителя, которое использует Navigation SDK для iOS или Android, чтобы создать путевую точку и направить водителя к правильному месту посадки.

Дополнительные сведения