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

Navigation point tokens allow you to send key contextual information about a destination to the Navigation SDK for Android or the Navigation SDK for iOS 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.

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

To create and pass a navigation point token, use the Destinations method of the Geocoding API to allow your users to select a preferred location from a list of navigation points . The user's selection becomes a navigation point returned by the Destinations method of the Geocoding 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 , 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.

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

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

Пользователь выбирает предпочтительную точку, которая находится в массиве 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, чтобы создать путевую точку и проложить маршрут к правильному месту посадки/высадки.

• См. документацию по точкам навигации в Navigation SDK для Android .
• See the Navigation SDK for iOS navigation point documentation .