The Navigation Connect API offers a lightweight alternative to the Navigation SDK by using the standalone Google Maps and Waze apps for routing rather than requiring you to build and embed a custom navigation interface into your app. It securely links the driver's session back to your backend. When a driver starts a trip, they experience their familiar navigation interface with two additions: a trip data sharing consent prompt (required every 12 months) and a branded back button to return to your app.
Почему стоит использовать API Navigation Connect?
С помощью API Navigation Connect вы можете интегрировать обновления местоположения поездки в режиме реального времени и расчетного времени прибытия из Google Maps или Waze непосредственно в свои внутренние процессы. Это поможет вам принимать важные бизнес-решения и предоставлять точные обновления вашим клиентам, в то время как водители будут использовать свои любимые навигационные приложения — Google Maps или Waze.
Примеры вариантов использования включают следующее:
- Повышение прозрачности в сфере райдшеринга: предоставление клиентам и пассажирам точных обновлений в режиме реального времени о местонахождении водителя и предполагаемом времени прибытия.
- Улучшение отслеживания доставки: Информируйте клиентов о точном времени доставки отправлений или продуктов питания на основе данных о дорожной ситуации и маршрутах в режиме реального времени.
- Улучшите управление автопарком и диспетчеризацию: принимайте обоснованные решения по диспетчеризации для автопарков или мобильных бригад, предоставляющих услуги по запросу (например, помощь при поломках, техническое обслуживание или транспорт), отслеживая местоположение водителей в режиме реального времени.
Что можно сделать с помощью API Navigation Connect
API Navigation Connect позволяет получать обновления местоположения и расчетного времени прибытия в режиме реального времени из Google Maps или Waze непосредственно в вашу административную панель.
- Отслеживание поездок без вмешательства в личный кабинет: отслеживайте поездки, не меняя выбор водителя относительно использования Google Maps или Waze и не изменяя его пользовательский опыт.
- Получайте доступ к данным о местоположении в режиме реального времени: отслеживайте местоположение водителя, оставшееся расстояние и прошедшее время непрерывно на протяжении всей поездки.
- Отслеживайте жизненный цикл поездок: настройте частоту обновления данных о поездках, чтобы отслеживать точный статус поездки и немедленно узнавать, когда водитель находится в пути, прибыл или приостанавливает поездку.
- Получайте и делитесь прогнозируемым временем прибытия: получайте высокоточные обновления прогнозируемого времени прибытия, основанные на алгоритмах маршрутизации Google в реальном времени.
- Отслеживание оставшегося маршрута и дорожной ситуации (только в Waze): Получайте информацию об оставшемся участке маршрута и дорожной ситуации в режиме реального времени от текущего местоположения водителя до конечного пункта назначения, точно так, как это отображается в Waze.
- Динамическая обрезка: по мере движения автомобиля Navigation Connect автоматически обрезает активную полилинию маршрута водителя (полный маршрут, пройденный в приложении), чтобы вы получали только оставшийся маршрут (отрезок от текущего положения водителя до пункта назначения).
- Частота обновления: Маршрут и дорожная обстановка обновляются автоматически при перерасчете маршрута, упреждающем перенаправлении маршрута на стороне клиента или изменении дорожной обстановки.
- Отслеживание отклонений от маршрута (только в Waze): определение момента, когда водитель отклоняется от маршрута, точное указание места и времени отклонения, а также определение, было ли отклонение инициировано водителем (например, неправильный поворот) или системой (например, объезд пробки).
- Гибкий способ получения данных: обрабатывайте данные о поездках в режиме реального времени с помощью прямых вызовов REST API или эффективно передавайте обновления, используя подписки Google Cloud Pub/Sub.
Как работает API Navigation Connect
The Navigation Connect API accepts a CreateTrip request containing your mobile application identifiers and session configuration. The service generates a unique trip instance and returns a trip token. This token is then appended to a Google Maps or Waze deep link. Once the driver launches navigation and grants consent, the service processes real-time navigation data and returns telemetry updates, including location, ETA, and distance remaining.
Ресурсы
В таблице ниже приведено краткое описание ресурсов, доступных через API Navigation Connect, а также возвращаемых им данных. Более подробную информацию см. в справочнике по API Navigation Connect .
| Ресурсы данных | Возвращенные данные |
|---|---|
Идентификаторы аутентификации и мобильных приложений в формате JSON. См. раздел «Создать поездку» . | Уникальный токен поездки, используемый для инициализации соединения в Google Maps или Waze. См. раздел «Запуск Google Maps или Waze» . |
Уникальный идентификатор поездки и метод получения или отправки данных в формате JSON. См. раздел «Получение данных о поездке» . | Телеметрия поездок в режиме реального времени, включая:
См. раздел «Обработка данных о поездке» . |
Как использовать API Navigation Connect
| 1 | Настройте | Начните с настройки проекта Google Cloud и выполните следующие инструкции. |
| 2 | Создать поездку | Отправьте вызов API Navigation Connect для создания поездки с уникальным идентификатором и сохраните токен. |
| 3 | Запустите Google Maps или Waze. | Передайте токен поездки и запустите Google Maps или Waze, чтобы разрешить обмен данными о поездке. |
| 4 | Получить данные о поездке | Отправьте вызов API Navigation Connect для получения данных о поездке . При желании подпишитесь на обновления с помощью Google Cloud Pub/Sub. |
| 5 | Обработка данных о поездке | Разберитесь, как обрабатывать статус поездки и другие данные о поездке . |