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

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

Navigation point tokens allow you to send key contextual information about a destination to the Navigation SDK for Android , Navigation SDK for iOS , or the Routes API for improved routing and driver experience. This is useful in cases like food delivery or rideshare, where the pickup or dropoff point may be ambiguous without user input.

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

You can then pass the navigation point token, which contains both the destination coordinates as well as contextual information, to the Navigation SDK for Android or the Navigation SDK for iOS , or the Routes API , where a waypoint is created for precise routing. The destination will be highlighted for the driver by the Navigation SDK based on the Place the token is associated with.

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

Обзор

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

These are the steps at a high level:

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

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

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

Схема вариантов использования сервисов совместных поездок или доставки.
Схема сценария использования сервиса совместных поездок или доставки.

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

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

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

Examples of consumer and driver apps

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

Consumer choosing a drop off point

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

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

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

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

Дополнительная информация