Обзор Navigation Connect API

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

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

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

Преимущества Navigation Connect API

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

Примеры использования:

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

Что можно делать с помощью Navigation Connect API

Navigation Connect API позволяет получать данные о текущем местоположении и расчетное время прибытия из Google Карт или Waze непосредственно в ваш бэкенд.

  • Отслеживание поездок без вмешательства. Отслеживайте поездки, не меняя выбор водителя в пользу Google Карт или Waze и не влияя на его удобство.
  • Доступ к данным о местоположении в реальном времени. Получайте информацию о местоположении водителя, оставшемся расстоянии и времени в пути в течение всей поездки.
  • Отслеживайте жизненные циклы поездок. Настройте частоту обновления данных о поездках, чтобы отслеживать точный статус поездки и сразу узнавать, когда водитель находится в пути, прибыл или приостановил поездку.
  • Получайте и делитесь расчетным временем прибытия. Получайте точные данные о расчетном времени прибытия, которые рассчитываются с помощью алгоритмов Google для построения маршрутов в реальном времени.
  • Отслеживание оставшегося маршрута и загруженности дорог. Получайте оставшийся маршрут в виде ломаной линии и данные о загруженности дорог в реальном времени от текущего местоположения водителя до конечного пункта назначения, как они отображаются в Google Картах или Waze. Эта функция активирует SKU Navigation Connect Enterprise.
    • Динамическая обрезка. По мере движения автомобиля Navigation Connect автоматически обрезает ломаную линию активного маршрута водителя (полный маршрут, по которому он следует в приложении), чтобы вы получали только оставшийся маршрут (сегмент от текущего местоположения водителя до пункта назначения).
    • Частота обновления. Маршрут и данные о дорожной обстановке обновляются автоматически при перерасчете маршрута, упреждающей перепрокладке маршрута на стороне клиента или изменении дорожной обстановки.
  • Отслеживание отклонений от маршрута (только в Waze). Определяйте, когда водитель отклоняется от маршрута, точно указывайте место и время отклонения и выясняйте, было ли оно инициировано водителем (например, из-за неправильного поворота) или системой (например, из-за перестроения маршрута из-за пробок). Эта функция активирует SKU Navigation Connect Enterprise.
  • Гибкий сбор данных. Получайте данные о поездках в реальном времени с помощью прямых вызовов REST API или эффективно передавайте обновления с помощью подписок Google Cloud Pub/Sub.

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

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

Ресурсы

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

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

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

Подробнее о том, как создать поездку…

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

Подробнее о том, как запустить Google Карты или Waze…

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

Подробнее о том, как получить данные о поездке…

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

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

Подробнее о том, как обрабатывать данные о поездках…

Как использовать Navigation Connect API

1 Настройка Начните с настройки проекта Google Cloud и выполните инструкции, приведенные ниже.
2 Как создать поездку Отправьте вызов Navigation Connect API, чтобы создать поездку с уникальным идентификатором, и сохраните токен.
3 Запуск Google Карт или Waze Передайте токен поездки и запустите Google Карты или Waze, чтобы включить передачу данных о поездке.
4 Как получить данные о поездках Отправьте вызов Navigation Connect API, чтобы получить данные о поездке. При необходимости подпишитесь на обновления с помощью Google Cloud Pub/Sub.
5 Обработка данных о поездке Узнайте, как обрабатывать статус поездки и другие данные о ней.