Чтобы переводить контент на ваш предпочитаемый язык, Google использует технологии на основе искусственного интеллекта. Переводы от ИИ могут содержать ошибки.

Примечания к выпуску Consumer SDK для Android

В этом разделе приведены примечания к выпуску Consumer SDK для Android.

Объявление: прекращение поддержки уровня API 23, 24 и 25

В соответствии с правилами поддержки версий мобильной ОС мы прекращаем поддержку Android 6 и 7 (уровни API 23, 24 и 25) в будущих основных версиях Consumer SDK для Android.

Версии Consumer SDK для Android, выпущенные начиная с четвертого квартала 2025 года, будут поддерживать Android 8 (уровень API 26) и более поздние версии. Более ранние версии SDK будут по-прежнему поддерживать Android 6 и 7.

Если в зависимостях не указан номер версии, IDE загрузит последнюю версию SDK, и новые сборки вашего приложения не будут поддерживать Android 6 и 7.

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

4.1.0 (26 мая 2026 г.)

Внутренние улучшения: перенос внутреннего хранилища данных в Jetpack DataStore.

Изменения зависимостей и конфигурации

Версия зависимости Kotlin обновлена до 2.3.0.
Обновлен плагин Android Gradle до версии 8.13.2.
Gradle обновлен до версии 8.13.
Обновлена библиотека Desugar до версии 2.1.5.
Версия Maps SDK повышена до 20.0.0, а также обновлены следующие зависимости GMS Core:
- play-services-location: 21.3.0
- play-services-tasks: 18.4.1
- play-services-common: 18.1.0
- play-services-basement: 18.1.0
Добавлены зависимости Jetpack Datastore (androidx.datastore:datastore-core:1.2.0, androidx.datastore:datastore-guava:1.2.0).

4.0.0 (3 октября 2025 г.)

Внутренние улучшения.

3.2.0 (26 июня 2025 г.)

Улучшено ведение внутренних журналов.

Изменения зависимостей и конфигурации

Начиная с версии 3.2.0 Consumer SDK для Android, приложения должны быть обновлены до Kotlin 2.1.

Исправлены ошибки.

Используйте длину ломаной линии вместо расстояния по воздуху для принятия решений о внутренней анимации.

3.1.0 (10 марта 2025 г.)

Улучшено ведение внутренних журналов.

3.0.0 (6 декабря 2024 г.)

Изменения зависимостей и конфигурации

Начиная с версии 3.0.0 Consumer SDK для Android, приложения должны быть обновлены до Kotlin 2.0. Ознакомьтесь с руководством по переходу на Consumer SDK 3.0 для Android.
Теперь целевой SDK для Consumer SDK – Android 14 (уровень API 34). Это требование применяется ко всем приложениям, которые будут опубликованы в Google Play в августе 2024 года и позже. Подробнее о требованиях Google Play к целевому уровню API…

2.99.0 (25 ноября 2024 г.)

Исправлены ошибки.

Исправлена ошибка ANR, которая возникала, когда выполнение ConsumerApi.cleanUp() занимало слишком много времени. После интеграции выпуска будет постепенно увеличиваться доля пользователей, которым будет доступна эта функция (начиная с 0%).
Исправлена проблема, из-за которой водители получали ошибки gRPC с кодом INTERNAL и сообщением Panic! Это ошибка!". После интеграции выпуска будет постепенно увеличиваться доля пользователей, которым будет доступна эта функция (начиная с 0%).

2.3.0 (2 августа 2024 г.)

Изменения в API

Добавлена поддержка облачных стилей карт, позволяющих настраивать вид карты, не изменяя код приложения. Подробнее об облачных стилях карт…
Добавьте метод getServerTimeMillis() в VehicleLocation, чтобы определить время, когда Fleet Engine получил обновление местоположения.

2.2.0 (7 мая 2024 г.)

Изменения в API

Добавлена поддержка API для интеграции Jetpack Compose. Это экспериментальная функция. Чтобы узнать, как интегрировать с Jetpack Compose, обратитесь к своему представителю.

2.1.0 (17 января 2024 г.)

Исправлены ошибки.

Исправлена ошибка, которая приводила к сбою при инициализации SDK более одного раза в течение жизненного цикла приложения.

Изменения в API

Добавлен метод для получения экземпляра GoogleMap, созданного SDK (ConsumerGoogleMap.getGoogleMap()).
Добавлен API для получения экземпляров Marker, созданных SDK для представления транспортного средства (ConsumerController.getConsumerMarker()).
Добавлен API для получения прогнозируемых клиентом обновлений времени и расстояния во время совместного использования маршрута (ProjectedRouteEta).

1.99.2 (3 ноября 2023 г.)

Исправлена ошибка, которая возникала, когда SDK инициализировался из удаленного процесса, отдельного от приложения.
Исправлен сбой, который происходил при выполнении анимации камеры, если для отступов не хватало места по вертикали или горизонтали. Это происходит только в последней версии средства отрисовки карт.
Исправлена ошибка, из-за которой первый участок поездки "туда и обратно" удалялся, если второй участок проходил по той же дороге.

Проблемы

Функция ConsumerApi.initialize() вызывает исключение, если вызывается при уже существующем экземпляре API. Чтобы обойти эту проблему, сначала вызовите ConsumerApi.getInstance() и оцените возвращенное значение Task, чтобы определить, существует ли уже экземпляр API.

2.0.0 (15 сентября 2023 г.)

Объявление о критических изменениях

Минимальный уровень API был изменен с 21 на 23.
Требования к версии Maps SDK обновлены с 17.0.0 до 18.1.0.
Минимальная требуемая версия стандартной библиотеки Kotlin обновлена с 1.6.10 до 1.9.0.
Как обновить версии зависимостей сервисов Google Play
- Минимальная требуемая версия библиотеки play-services-base изменена с 18.0.1 на 18.2.0.
- Минимальная поддерживаемая версия библиотеки play-services-basement изменена с 18.0.0 на 18.2.0.
- Минимальная версия библиотеки play-services-location изменена с 17.0.0 на 21.0.1.
- Минимальная поддерживаемая версия библиотеки play-services-tasks изменена с 18.0.1 на 18.0.2.
Добавляет библиотеку androidx.room:room-runtime с минимальной версией 2.5.2.
Обновите версии следующих зависимостей
- Минимальная требуемая версия библиотеки android-maps-utils обновлена с 0.4.2 до 3.5.2.
- Минимальная версия com.google.android.datatransport:transport-backend-cct теперь 3.1.9, а не 3.0.0.
- Минимальная версия com.google.android.datatransport:transport-runtime изменена с 3.0.1 на 3.1.9.
- Минимальная требуемая версия androidx.lifecycle:lifecycle-extensions обновлена с 2.0.0 до 2.2.0.
- Минимальная требуемая версия androidx.lifecycle:lifecycle-common-java8 обновлена с 2.0.0 до 2.6.1.
- Минимальная требуемая версия androidx.appcompat:appcompat обновлена с v1.0.0 до v1.6.1.
- Минимальная версия androidx.fragment:fragment изменена с 1.0.0 на 1.6.1.
Удалены следующие устаревшие API: ConsumerTrip, ConsumerTripCallback, ConsumerTripManager, ConsumerTripOptions. Они были заменены на TripModel, TripModelCallback, TripModelManager и TripModelOptions.
Приложения, в которых используется Consumer SDK, должны иметь targetSdkVersion API 31 или более поздней версии, а compileSdkVersion – API 33 или более поздней версии.
В приложениях, использующих Consumer SDK, теперь необходимо включить поддержку библиотеки Java 8. Инструкции по обновлению приведены на странице https://developer.android.com/studio/write/java8-support.
Если в приложении используется Proguard или Dexguard, необходимо перейти на R8. Подробнее: https://developer.android.com/build/shrink-code.
В приложениях, использующих Consumer SDK, необходимо включить десахаризацию. Инструкции можно найти на странице https://developer.android.com/studio/write/java8-support#library-desugaring.
Метод ConsumerApi.initialize() теперь вызывает исключение, если он вызывается при уже созданном экземпляре API. Значение Task, возвращаемое ConsumerApi.getInstance(), необходимо использовать, чтобы определить, был ли ранее создан экземпляр API.

Объявление об устаревших API

Удалены классы аннотаций Trip.TripStatus и Trip.TripType. Вместо них добавлены классы аннотаций TripInfo.TripStatus и TripInfo.TripType.
- В связи с этим изменением TripModelCallback#onTripStatusUpdated(TripInfo tripInfo, @Trip.TripStatus int status) устарело, а вместо него добавлено TripModelCallback#onTripStatusUpdate(TripInfo tripInfo, @TripInfo.TripStatus int status).
- В связи с этим TripInfo#getTripStatus() устарел, а на его место добавлен TripInfo#getCurrentTripStatus().
- В связи с этим TripInfo#getTripType() устарел, а на его место добавлен TripInfo#getCurrentTripType().
Класс Trip объявлен устаревшим.

Другие изменения и исправления ошибок

Поддерживает запрос последней версии средства отрисовки Maps SDK. Подробнее об обновленном средстве отрисовки карт…
Поддерживает версии Maps SDK от 18.1.0(включительно) до 19.0.0(не включительно).
Исправлена ошибка "Срок истек" при внутреннем обмене данными между SDK и сервером Google.
Исправлена проблема с отрисовкой на маленьких экранах и в режиме "Картинка в картинке".

Руководство по переходу

Переход на Consumer SDK для Android версии 2.0.0

1.99.1 (31 августа 2023 г.)

Исправлены ошибки.

Исправлена ошибка, которая приводила к сбою при удалении фрагмента или объекта activity, в котором размещен SDK.
Исправлена ошибка, из-за которой происходил сбой, когда размеры MapView были равны нулю (высота или ширина).
Исправлен сбой, который происходил при проецировании местоположения транспортного средства на ломаную линию маршрута.

Описание

Предотвращает сбои SDK, когда размещаемое приложение загружается из неизвестного источника и в нем отсутствуют визуальные ресурсы по умолчанию.

1.99.0 (22 июня 2023 г.)

Исправлены ошибки.

Исправлена проблема с отрисовкой на экранах небольшого размера и в режиме "Картинка в картинке".
Исправлено мерцание транспортного средства во время передачи поездки.

1.2.1 (7 июня 2023 г.)

Исправлены ошибки.

Исправлена ошибка, из-за которой во время совместного использования маршрута мерцал автомобиль.

1.2.0 (21 ноября 2022 г.)

Исправлены ошибки.

Исправлена ошибка, из-за которой в обратном вызове onTripActiveRouteTrafficUpdated сообщалось о пустом трафике.

Новые функции

Теперь функция "Полилинии с учетом трафика" доступна всем.

1.1.2 (27 октября 2022 г.)

Исправлены ошибки.

Исправлена ошибка, из-за которой полилиния маршрута исчезала после того, как JourneySharingSession запускался более одного раза для TripModel.

Объявление: прекращение поддержки Android 5 (25 июля 2022 г.)

Для нашей версии SDK 1.1.1 мы предоставляем дополнительный год поддержки для приложений, работающих на Android 5, для уровней API 21 и 22.

Это означает следующее:

Потребительский SDK, работающий в ваших приложениях для Android, будет поддерживать Android 5 (уровень API 21) до 30 июня 2023 г.
После 30 июня 2023 г. мы будем поддерживать только уровни API Android 23 и выше. Другими словами, после этой даты мы прекратим поддержку Android с уровнями API 21 и 22 во всех версиях SDK. Это означает, что ошибки, связанные с Android 21 или 22, в любой версии SDK (включая 4.x) не будут исправлены, и мы не гарантируем, что SDK будут работать правильно.

Версия 1.1.1 (25 июля 2022 г.)

Изменение зависимости

Минимальный поддерживаемый уровень Android API понижен до 21.

v1.1.0 (28 апреля 2022 г.)

Внутренние улучшения.

v1.0.19 (17 марта 2022 г.)

Исправлены ошибки.

Устранена утечка памяти в классе ConsumerApi.

Версия 1.0.14 (30 ноября 2021 г.)

Минимальный поддерживаемый уровень Android API теперь 23.

Изменения в API

Изменения в классах ConsumerTrip и ConsumerTripManager.
- Некоторые названия методов были изменены, чтобы сделать их более понятными и привести в соответствие с платформой iOS.
Изменения в ConsumerTripCallback, ConsumerTrip и TripInfo.
- Изменены названия некоторых классов, чтобы они соответствовали iOS. Добавлены TripModel, TirpModelManager и TripModelOptions, чтобы заменить ConsumerTrip, ConsumerTripManager и ConsumerTripOptions.
- Упорядочены названия некоторых методов. Добавлены или изменены комментарии JavaDoc к методам, чтобы сделать их более понятными.
- Улучшена обработка ошибок.

Настройка стиля

Устаревшие контейнеры
- MarkerStyleOptions и PolylineStyleOptions были объявлены устаревшими и заменены на MarkerOptions и PolylineOptions, которые также используются в Maps SDK.

Отслеживание сбоев

Добавлено обнаружение сбоев и ведение журнала.
- Мы добавили возможность отказаться от этой функции. Это было сделано в рамках более масштабной работы по мониторингу сбоев в сервисах Geo.

Изменения в аутентификации

Удалите ненужные методы из интерфейсов аутентификации.
- Удален параметр ServiceType.

Версия 0.9.28 (18 мая 2021 г.)

Изменения в API

Во всех методах ConsumerTripCallback в качестве параметра теперь используется TripInfo.
Добавлен параметр ConsumerTrip.isRefreshing(), который указывает, обновляет ли ConsumerTrip информацию о поездках из Fleet Engine.
Добавлена функция ConsumerTripCallback.onTripRemainingRouteDistanceUpdated().
Добавлена функция ConsumerTripCallback.onTripRemainingRouteUpdated().
Замените типы возвращаемых значений Guava (ImmutableSet, ImmutableList) эквивалентными классами java.util.
Изменения в названиях пакетов:
- com.google.android.libraries.ridesharing.common.AuthTokenContext -> com.google.android.libraries.ridesharing.consumer.auth.AuthTokenContext
- com.google.android.libraries.ridesharing.common.AuthTokenFactory -> com.google.android.libraries.ridesharing.consumer.auth.AuthTokenFactory
- com.google.android.libraries.ridesharing.common.FleetEngineServiceType -> com.google.android.libraries.ridesharing.consumer.auth.FleetEngineServiceType - com.google.android.libraries.ridesharing.common.model.Trip
```
                            ->
                                                            com.google.android.libraries.ridesharing.consumer.model.Trip

                            -   com.google.android.libraries.ridesharing.common.model.Vehicle

                                                    ->
                                com.google.android.libraries.ridesharing.consumer.model.Vehicle
```

Изменения в реализации

Устранено состояние гонки, при котором SDK мог аварийно завершить работу из-за взаимодействия с картой до того, как она будет готова.
В SDK больше нет необфусцированной копии io.grpc.
Исправлена ошибка, из-за которой на некоторых устройствах мерцали ломаные линии, обозначающие дорожное движение. Сегменты трафика теперь будут иметь закругленные концы.

v0.9.15 (7 октября 2020 г.)

Изменения в API

В этом выпуске представлены полилинии с учетом трафика. – Добавлены TripInfo.getActiveRouteTraffic() и TripInfo.getRemainingRouteTraffic().
- Добавлены поля ConsumerTripCallback.onTripActiveRouteTrafficUpdated() и ConsumerTripCallback.onTripRemainingRouteTrafficUpdated(), чтобы указывать, когда изменился трафик.
- Добавлен параметр PolylineStyleOptions для настройки трафика (setTrafficEnabled(), setTrafficColorNoData(), setTrafficColorNormal(), setTrafficColorSlow(), setTrafficColorTrafficJam()).
- Показано: PolylineStyleOptions.TRAFFIC_Z_INDEX_ADDITION.
- Добавлена функция TripWaypoint.getTrafficData().
- Добавлен тип данных TrafficData.
- Добавлена функция ConsumerController.hideAllSessions(). Функция ConsumerController.showSession() больше не принимает значение NULL в качестве аргумента.

Версия 0.9.9 (15 июля 2020 г.)

Изменения в API

Это значительное изменение, которое вводит модульную архитектуру с более четкой связью между уровнем данных (например, ConsumerTripManager) и уровнем пользовательского интерфейса (например, JourneySharingSession). Информацию о переходе на новую архитектуру можно найти в руководстве по переходу на модульную архитектуру. - Объект ConsumerTrip теперь получается из ConsumerTripManager.getTrip().
- Вместо ConsumerTrip.unregisterCallback теперь используется ConsumerTrip.unregisterTripCallback.
- Параметр "ConsumerTrip.isCallbackRegistered" переименован в "ConsumerTrip.isTripCallbackRegistered".
- Добавлено: ConsumerTrip.setConsumerTripOptions() и ConsumerTrip.getConsumerTripOptions().
- Удалено: ConsumerTrip.setAutoRefreshInterval().
Удалены API, не связанные с маршрутами.
- Удалена карта плотности автомобилей.
- Удалено состояние предварительного просмотра поездки.
- Удалено состояние выбора самовывоза.
- Удалено состояние выбора места высадки.
- Удалены следующие типы маркеров: SELECTED_PICKUP_POINT, SUGGESTED_PICKUP_POINT, HIGHLIGHTED_PICKUP_POINT и SELECTED_DROPOFF_POINT.
Изменили OnConsumerMarkerClickCallback и ConsumerMapReadyCallback с интерфейсов на абстрактные классы.
Добавлены ConsumerController.getCameraUpdate(), ConsumerController.isAutoCameraEnabled() и ConsumerController.enableAutoCamera().
Удалена специальная плавающая кнопка действия и связанные с ней методы (ConsumerController.isMyLocationFabEnabled и ConsumerController.setMyLocationFabEnabled).

Изменения в реализации

ConsumerTripCallback, зарегистрированный с LifecycleOwner или без него, больше не отменяет регистрацию автоматически на TripStatus.COMPLETE или TripStatus.CANCELED.
Функция AutoCamera теперь включена по умолчанию и не может быть отключена или включена автоматически. Раньше функция AutoCamera автоматически включалась при вызове метода TripStatus.ARRIVED_AT_PICKUP и отключалась, когда пользователь взаимодействовал с картой во время предоставления доступа к маршруту.
В анимацию автомобиля при совместном использовании маршрута внесены следующие улучшения:
- Анимация передачи поездки теперь обрабатывает ситуацию, когда транспортное средство может законно вернуться по уже пройденному маршруту.
- Теперь транспортное средство будет анимироваться по прямой линии, а не по маршруту, интерполируемому между точками, когда это будет определено алгоритмически.
FINE_LOCATION больше не требуются.

Другие изменения

Обновлены версии следующих зависимостей:
- com.google.android.datatransport:transport-api:2.2.0
- com.google.android.datatransport:transport-backend-cct:2.2.0
- com.google.android.datatransport:transport-runtime:2.2.0

Версия 0.9.1 (23 марта 2020 г.)

Изменения в API

Добавлены TripInfo.getVehicleId(), TripInfo.getNumberOfPassengers(), TripInfo.getIntermediateDestinationIndex(), TripInfo.getTripActiveRoute() и TripInfo.getTripRemainingRoute().
Добавлен класс options, используемый при инициализации ConsumerApi, который позволяет динамически задавать адрес FleetEngine. Если API не вызывается со значением FleetEngine, он пытается получить его из манифеста Android или использует значение по умолчанию.

Описание

Ломаная линия маршрута не отображается, если статус поездки – ARRIVED_AT_PICKUP.
Улучшено отслеживание транспортных средств, отклонившихся от маршрута (требуется DriverSDK 1.15):
- Отслеживание автомобиля не привязывает его к маршруту, когда он проезжает мимо точки посадки.
- Отслеживание автомобиля позволяет показывать его местоположение вне дорог, например на парковках, не отмеченных на карте.
Теперь значок автомобиля обновляется, когда пункт назначения водителя не совпадает с пунктом назначения в Fleet Engine.

v0.8.6 (16 декабря 2019 г.)

Изменения в API

Добавлена функция TripInfo.getVehicleLocation().
ConsumerMapView больше не является окончательной версией.

Изменения в реализации

Оставшееся расстояние активного этапа теперь рассчитывается с использованием расстояния, полученного от сервера (сообщенного водителем и статического маршрута, если применимо), а не локальной привязки. Это изменение позволяет точнее определять оставшееся расстояние.

Другие изменения

Требуются новые зависимости. Подробная информация приведена в файле POM.
- com.google.android.datatransport:transport-api:2.0.0
- com.google.android.datatransport:transport-backend-cct:2.0.2
- com.google.android.datatransport:transport-runtime:2.0.0
Добавлены журналы для задержки запроса поездки.
Добавлены журналы для ошибок в ответах о рейсах.