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: настройка
- Аутентификация: веб-токен JSON (JWT), ключ API.
- Также включите: Fleet Engine Service, Maps SDK для Android.
- Начало работы: настройка Consumer SDK для Android
- Справочник: справочник по Consumer SDK для Android
- Правила: правила Consumer SDK для Android.
- Примечания к выпуску: Примечания к выпуску Consumer SDK для Android
Официальные пакеты Consumer SDK для Android:
- maven:
com.google.android.libraries.mapsplatform.transportation:transportation-consumer
Consumer SDK для Android: сопутствующие товары
- Часто используется с: Fleet Engine Service, Driver SDK для Android, Maps SDK для Android.
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
Ниже приведены ссылки на руководства по каждой задаче. Вы также можете сравнить возможности продуктов в Обзоре возможностей.
- Добавьте настраиваемую интерактивную карту, которая отслеживает ход поездки от Fleet Engine до мобильного приложения.
- Добавьте ломаную линию маршрута, которая отслеживает поездку из Fleet Engine на карту на веб-странице или в мобильном приложении.
- Обновление хода поездки по маршруту на карте на веб-странице или в мобильном приложении для поездки Fleet Engine.
- Измените стиль дорог, ломаных линий и многоугольников на карте, которая отслеживает ход поездки из Fleet Engine.
- Показывать или скрывать объекты на карте, которая отслеживает ход поездки из Fleet Engine.
- Измените стиль значков и текстовых меток на карте, которая отслеживает ход поездки из Fleet Engine.
- Применяйте разные стили карты к разным уровням масштабирования на карте, которая отслеживает ход поездки из Fleet Engine.
- Измените плотность мест на карте, которая отслеживает ход поездки из Fleet Engine. Экспериментальная функция. Примечание. Поддержка облачных стилей карт в Consumer SDK является общедоступной, а управление плотностью объектов инфраструктуры – экспериментальная функция облачных стилей карт (поддерживается только для светлых стилей карт).
- Как изменить стиль зданий на карте, которая отслеживает ход поездки из Fleet Engine. Экспериментальная функция. Примечание. Поддержка облачных стилей карт в Consumer SDK является общедоступной, а настройка стилей 3D-зданий и их контуров – экспериментальной функцией облачных стилей карт (поддерживается только для светлых стилей карт).
- Как изменить стиль ориентиров на карте, которая отслеживает ход поездки из Fleet Engine. Экспериментальная функция. Примечание. Поддержка облачных стилей карт в Consumer SDK – это общедоступная функция, а настройка значков ориентиров – экспериментальная функция облачных стилей карт (поддерживается только для светлых стилей карт).
- Настройте маркер на карте, который отслеживает ход поездки из Fleet Engine.
- Настройте ломаную линию маршрута на карте, которая отслеживает ход поездки из Fleet Engine.