Обзор API Navigation Connect

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

API Navigation Connect — это сервис, который связывает использование водителями навигационных систем Google Maps и Waze с вашими корпоративными системами. Он использует токены авторизации поездки вместе с прямой ссылкой в ​​вашем приложении, позволяя водителю нажать на ссылку или кнопку, чтобы начать навигацию в выбранном им приложении. Во время поездки вы можете получать данные о местоположении в режиме реального времени, такие как текущие координаты, высокоточные расчетные сроки прибытия и статусы жизненного цикла поездки.

API Navigation Connect предлагает облегченную альтернативу SDK для навигации, используя автономные приложения Google Maps и Waze для построения маршрутов, вместо того чтобы требовать от вас создания и встраивания пользовательского интерфейса навигации в ваше приложение. Он безопасно связывает сессию водителя с вашим бэкэндом. Когда водитель начинает поездку, он видит свой привычный интерфейс навигации с двумя дополнениями: запросом согласия на обмен данными о поездке (требуется каждые 12 месяцев) и фирменной кнопкой «Назад» для возврата в ваше приложение.

Почему стоит использовать 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 автоматически обрезает активную полилинию маршрута, чтобы вы получали только оставшуюся часть поездки.
    • Частота обновления: Маршрут и дорожная обстановка обновляются автоматически при перерасчете маршрута, упреждающем перенаправлении маршрута на стороне клиента или изменении дорожной обстановки.
  • Гибкий способ получения данных: обрабатывайте данные о поездках в режиме реального времени с помощью прямых вызовов REST API или эффективно передавайте обновления, используя подписки Google Cloud Pub/Sub.

Как работает API Navigation Connect

API Navigation Connect принимает запрос CreateTrip содержащий идентификаторы вашего мобильного приложения и конфигурацию сессии. Сервис генерирует уникальный экземпляр поездки и возвращает токен поездки. Затем этот токен добавляется к прямой ссылке Google Maps или Waze. После того, как водитель запускает навигацию и дает согласие, сервис обрабатывает данные навигации в режиме реального времени и возвращает обновления телеметрии, включая местоположение, расчетное время прибытия и оставшееся расстояние.

Ресурсы

В таблице ниже приведено краткое описание ресурсов, доступных через API Navigation Connect, а также возвращаемых им данных. Более подробную информацию см. в справочнике по API Navigation Connect .

Ресурсы данных Возвращенные данные

Идентификаторы аутентификации и мобильных приложений в формате JSON.

См. раздел «Создать поездку» .

Уникальный токен поездки, используемый для инициализации соединения в Google Maps или Waze.

См. раздел «Запуск Google Maps или Waze» .

Уникальный идентификатор поездки и метод получения или отправки данных в формате JSON.

См. раздел «Получение данных о поездке» .

Телеметрия поездок в режиме реального времени, включая:

  • Статус поездки и метаданные
  • Текущее местоположение (широта/долгота)
  • Расчетное время прибытия (ETA)
  • Оставшееся расстояние и время

См. раздел «Обработка данных о поездке» .

Как использовать 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 Обработка данных о поездке Разберитесь, как обрабатывать статус поездки и другие данные о поездке .