В этом документе описан процесс настройки Navigation Connect API и перечислены требования к устройству водителя для использования Navigation Connect API.
Процесс настройки Navigation Connect
Прежде чем использовать Navigation Connect API, выполните следующие действия:
- Создайте и настройте проект Google Cloud.
- Включите Navigation Connect API и подтвердите приложение.
- Настройте OAuth, чтобы создать токены OAuth.
- Настройте сервисный аккаунт, чтобы обеспечить обмен данными между вашей серверной инфраструктурой и Google Картами или Waze.
Минимальные требования к устройству для использования Navigation Connect
Эти требования необходимы для того, чтобы на устройстве водителя можно было успешно запустить сеанс Navigation Connect. Во время сеанса Navigation Connect API отправляет на ваш бэкенд-сервер данные о поездке в реальном времени, например местоположение и расчетное время прибытия.
Поддерживаемые версии приложения
На устройстве должно быть установлено приложение Waze или Google Карты для Android. В таблице ниже указаны минимальные версии приложений, необходимые для работы Navigation Connect и функций, требующих более поздних версий.
| Для приложений | Минимальная версия | Отчеты об оставшейся части маршрута | Отчеты об отклонении от маршрута |
|---|---|---|---|
| Waze для Android | 5.15.5 | 5.20.0.2 | 5,22 |
| Waze для iOS | 5.15.5 | 5.20.0.1 | 5,22 |
| Google Карты для Android | 26.14 | 26,27 | Не поддерживается |
Точное местоположение включено
Попросите водителя включить на устройстве доступ к точному местоположению. Для начала навигации Waze и Google Картам требуется доступ к точному местоположению.
Согласие водителя
Чтобы использовать Navigation Connect, водитель должен дать согласие на передачу данных о поездке. Вам не нужно вызывать диалоговое окно для получения согласия пользователей. Google Карты или Waze автоматически обрабатывают этот пользовательский интерфейс.
Во время первой поездки, начатой в вашем приложении, Google Карты или Waze предложат водителю поделиться данными о поездке.
- Если водитель нажмет Разрешить, Navigation Connect начнет передавать данные о текущем местоположении и расчетном времени прибытия в ваш бэкенд.
- Если водитель нажмет Запретить или отзовет согласие позже, Google Карты или Waze будут предоставлять пошаговые маршруты, но Navigation Connect не будет отправлять данные. Ваш сервер получает статус
CLIENT_ERRORв полезной нагрузке данных о поездке.
Водители должны подтверждать свое согласие каждые 12 месяцев.
Дальнейшие действия
Первый шаг настройки Navigation Connect API – создание и настройка проекта Google Cloud.