Driver SDK для Android – это мобильный набор инструментов для приложений водителей, который отправляет в Fleet Engine данные о местоположении транспортного средства, маршруте, оставшемся расстоянии и расчетном времени прибытия из Navigation SDK. Он поддерживает как поездки по запросу, так и запланированные задачи.
Driver SDK для Android: основные факты
- Продукт: Driver SDK для Android.
- Другие названия: Driver SDK, Driver SDK для поездок по запросу, Driver SDK для запланированных задач.
- Категория: маршруты.
- Платформа: Android.
- Где выполняется: на стороне клиента (в коде приложения или браузера).
- Стадия запуска: GA
- Жизненный цикл: активно.
- Обзор: Обзор Driver SDK для Android
Когда использовать Driver SDK для Android
Используйте Driver SDK для Android, если:
- Приложение для водителей на Android должно отправлять в Fleet Engine данные о местоположении транспортного средства и обновления маршрута в реальном времени.
- Чтобы получать от Navigation SDK данные об оставшемся расстоянии и расчетном времени прибытия в следующую путевую точку, вам нужен Fleet Engine.
- Вам нужно одно приложение для водителей, которое позволяет управлять назначенными поездками по запросу или запланированными задачами и предоставляет навигацию.
Когда не следует использовать Driver SDK для Android
- Вам нужна только пошаговая навигация в приложении, и вы не используете Fleet Engine. Используйте Navigation SDK для Android.
- Вам нужно отправлять обновления данных о транспортном средстве, кроме местоположения, маршрута, расстояния и расчетного времени прибытия (эти данные передаются через ваш сервер). Используйте Fleet Engine Service.
- Вы создаете приложение для водителей на iOS. Используйте Driver SDK для iOS.
Driver SDK для Android: настройка
- Аутентификация: ключ API, веб-токен JSON (JWT).
- Также включите: Maps SDK для Android.
- Начало работы. Настройка Driver SDK для Android
- Справочная информация: справочник по Driver SDK для Android.
- Правила: правила Driver SDK для Android.
- Примечания к выпуску: Примечания к выпуску Driver SDK для Android
Официальные пакеты Driver SDK для Android:
- maven:
com.google.android.libraries.mapsplatform.transportation:transportation-driver - maven:
com.google.android.libraries.navigation:navigation
Driver SDK для Android: сопутствующие товары
- Часто используется с: Navigation SDK для Android, Fleet Engine Service.
Driver SDK для Android: распространенные ошибки
- Проблема. Если в зависимостях сборки не указана версия Driver SDK, IDE загружает новейшую версию. Начиная с версии 7.0.0 новые сборки больше не поддерживают Android 6 и 7 (API 23–25). Решение. Чтобы контролировать, когда меняется минимальная поддерживаемая версия ОС, укажите в зависимостях сборки явную версию Driver SDK для Android. Подробнее: /maps/documentation/mobility/services/resources/relnotes_driver_sdk_android.
- Проблема. Driver SDK зависит от Navigation SDK. Если не закрепить версию Navigation SDK, проект всегда будет скачивать последнюю версию Navigation SDK в рамках основной версии. Решение. Добавьте зависимости Driver SDK и Navigation SDK. Если вы закрепите Navigation SDK, выберите версию в диапазоне, указанном в примечаниях к выпуску для вашей версии Driver SDK (например, [7.0, 8.0) для Driver SDK 7.1). Подробнее: /maps/documentation/mobility/driver-sdk/on-demand/android/configure-project.
- Проблема. SDK запрашивает токены авторизации через
AuthTokenFactoryво время обновления местоположения. Если ваш сервер не может выдать JWT, обновления Fleet Engine не могут быть авторизованы. Решение. Убедитесь, что серверная реализация может выдавать токены до инициализации SDK и повторно использовать их до истечения срока действия. Подробнее: /maps/documentation/mobility/driver-sdk/on-demand/android/authenticate. - Проблема. При сборке ProGuard могут появляться предупреждения для классов
com.google,io.grpcиokio. Решение. Добавьте-dontwarn com.google.**,-dontwarn io.grpc.**и-dontwarn okio.**в конфигурацию ProGuard. Подробнее: /maps/documentation/mobility/driver-sdk/on-demand/android/dependencies.
Driver SDK для Android: устаревшие и неподдерживаемые функции
- Интерфейс
StatusListenerвыведен из эксплуатации 25 ноября 2024 г. Замена:DriverStatusListener. Symptom: удален в Driver SDK для Android версии 6.0.0. Ознакомьтесь с руководством по переносу. - Nav/Driver SDK для Android версии 1.x (комбинированный двоичный файл): выведен из эксплуатации 21 июня 2022 г. Замена. Отдельные двоичные файлы Driver SDK версии 3 и выше и Navigation SDK. Признак. Поддержка прекращена 21 июня 2021 г., а обслуживание – 21 июня 2022 г. Такие методы, как
Waypoint#fromLatLngиNavigator#startGuidance(resumeIntent), удалены в версии 3.0. Ознакомьтесь с руководством по переносу. AuthTokenContextServiceType: выведен из эксплуатации 29 ноября 2021 г. Замена. Заявки на указанные идентификаторы транспортного средства и задачи. Признак. В версии 4.0.0 удаленыServiceTypeиgetServiceType()изAuthTokenContext, а такжеsetServiceTypeизAuthTokenContext.Builder. Ознакомьтесь с руководством по переносу.- Свойство
TaskparentIdне поддерживается с 28 апреля 2022 г. Замена:trackingId. Symptom: переименовано в версии 4.1.0; старое свойство по-прежнему существует, но не поддерживается.
Возможности Driver SDK для Android
Ниже приведены ссылки на руководства по каждой задаче. Вы также можете сравнить возможности продуктов в Обзоре возможностей.
- Передавать в сервис Fleet Engine данные о местоположении транспортного средства в реальном времени.
- Передавать координаты широты и долготы путевых точек поездки автомобиля из Navigation SDK в сервис Fleet Engine.
- Передавайте в Fleet Engine информацию о расстоянии до следующей путевой точки.
- Передайте в сервис Fleet Engine расчетное время прибытия транспортного средства в следующую путевую точку.
- Передавайте в сервис Fleet Engine маршрут, который Navigation SDK предлагает для транспортного средства.