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

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

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

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

Примеры потребительских и водительских приложений

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

How a navigation point token is created and sent to the Nav SDK for routing

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

Когда пользователь открывает приложение, приложение вызывает конечную точку 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
      }
    }
]

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