Краткий справочник по Consumer SDK для Android

Consumer SDK для Android входит в состав Fleet Engine для поездок по запросу. Он предоставляет интерфейсы, которые моделируют данные о поездках и отслеживают поездки в Fleet Engine, а также классы для создания карты, на которой отображается ход поездки (местоположение транспортного средства, маршрут, расчетное время прибытия, оставшееся расстояние, трафик) для клиентов в приложении Android.

Consumer SDK для Android: основные факты

  • Продукт: Consumer SDK для Android.
  • Другие названия: Android Consumer SDK, Consumer SDK, Mobility Services On-demand Trips Android Consumer SDK.
  • Категория: маршруты.
  • Платформа: Android.
  • Где выполняется: на стороне клиента (в коде приложения или браузера).
  • Стадия запуска: GA
  • Жизненный цикл: активно.
  • Обзор: Обзор Consumer SDK для Android

Consumer SDK для Android: когда использовать

Когда использовать Consumer SDK для Android

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

Когда не следует использовать Consumer SDK для Android

  • Вам нужно предоставить доступ к поездке по запросу в приложении для iOS. Используйте Consumer SDK для iOS.
  • Вам нужно показывать маршрут на веб-странице или отслеживать запланированные задачи, например доставку. Используйте Consumer SDK для JavaScript.
  • Вам нужно передавать данные о местоположении водителя и ходе поездки из приложения Android для водителя. Используйте Driver SDK для Android.

Consumer SDK для Android: настройка

Официальные пакеты Consumer SDK для Android:

  • maven: com.google.android.libraries.mapsplatform.transportation:transportation-consumer

Consumer SDK для Android: распространенные ошибки

  • Проблема. Если зависимость Maps SDK не задана для явной версии, Consumer SDK использует минимально необходимую версию Maps SDK, что может привести к сбою в работе приложений, использующих функции более поздних версий Maps SDK. Решение. Явно укажите версию play-services-maps вместе с transportation-consumer в Gradle или Maven. Подробнее: /maps/documentation/mobility/journey-sharing/on-demand/android/configure-project.
  • Проблема. Если не прекратить передачу данных о поездке после ее завершения, это приведет к ненужным сетевым запросам к Fleet Engine и утечкам памяти. Решение. Вызывайте JourneySharingSession.stop(), когда поездка больше не нужна, например в onDestroy() или когда поездка COMPLETE. Подробнее: /maps/documentation/mobility/journey-sharing/on-demand/android/share-journey.
  • Проблема. ConsumerApi.initialize() выдает исключение, если экземпляр API уже существует (версия 2.0.0 и более поздние). Решение. Сначала вызовите ConsumerApi.getInstance() и проверьте возвращенный Task, чтобы определить, существует ли уже экземпляр. См. /maps/documentation/mobility/services/resources/relnotes_consumer_sdk_android.
  • Проблема. Consumer SDK версии 3 и ниже не поддерживает полный режим R8. В приложениях, предназначенных для AGP 8.0 и более поздних версий, могут возникать проблемы со сборкой или выполнением. Решение. Установите android.enableR8.fullMode=false при таргетинге на AGP 8.0 или более поздней версии и используйте AGP 7.3 или более поздней версии с Kotlin 2.0 для Consumer SDK 3.0 или более поздней версии. Подробнее: /maps/documentation/mobility/journey-sharing/on-demand/android/migration-guide-v3.

Consumer SDK для Android: устаревшие и не поддерживаемые функции

  • ConsumerTrip, ConsumerTripCallback, ConsumerTripManager, ConsumerTripOptions: выведены из эксплуатации 15 сентября 2023 г. Замена: TripModel, TripModelCallback, TripModelManager, TripModelOptions. Ознакомьтесь с руководством по переносу.
  • Класс Trip и аннотации Trip.TripStatus/Trip.TripType (а также TripInfo#getTripStatus(), TripInfo#getTripType(), TripModelCallback#onTripStatusUpdated). Поддержка прекращена 15 сентября 2023 г. Замена: TripInfo.TripStatus / TripInfo.TripType, TripInfo#getCurrentTripStatus(), TripInfo#getCurrentTripType(), TripModelCallback#onTripStatusUpdate. Ознакомьтесь с руководством по переносу.
  • MarkerStyleOptions и PolylineStyleOptions. Выведены из эксплуатации 30 ноября 2021 г. Замена: MarkerOptions и PolylineOptions (общие с Maps SDK). Признак. Consumer SDK применяет собственный стиль по умолчанию для каждого типа маркера или ломаной линии, а не стиль по умолчанию MarkerOptions. Ознакомьтесь с руководством по переносу.
  • Канал распространения частного хранилища: поддержка прекращена. Замена: репозиторий Google Maven (версии 2.1.0 и более поздние). Ознакомьтесь с руководством по переносу.

Возможности Consumer SDK для Android

Ниже приведены ссылки на руководства по каждой задаче. Вы также можете сравнить возможности продуктов в Обзоре возможностей.