Миграция с предыдущих мажорных версий SDK

С версий 13.x на 14.x

Для версий Full и Map

• Повторно выгрузите стили: добавлены и обновлены стили для слоя Работа, лёгкого метро, адаптивных светофоров, GPX-треков и пользовательских курсоров.
• Удалён MapOptions. Параметры создания карты перенесены в MapControllerOptions, параметры отображения Flutter-виджета — в MapWidgetOptions.
• Изменено создание MapWidgetController: используйте конструктор от sdk.Context с controllerOptions или MapWidgetController.fromMapController(...); вместо getMapAsync() используйте mapAsync, isReady и обнуляемое свойство map.
• Flutter-классы темизации MapTheme, MapAppearance, DefaultAppearance, UniversalAppearance, AutomaticAppearance и MapThemeColorMode заменены типами MapTheme, MapAppearance, BySystem и Fixed.
• Удалены одиночные методы поиска SearchManager.searchById(), SearchManager.searchByDirectoryObjectId(), SearchManager.searchByIdWithLocale() и SearchManager.searchByDirectoryObjectIdWithLocale(). Используйте SearchManager.searchByIds() и SearchManager.searchByDirectoryObjectIds().
• Удалены статические методы SearchQueryBuilder.fromQueryText(), SearchQueryBuilder.fromRubricIds(), SearchQueryBuilder.fromQueryTextAndRubricIds(), SearchQueryBuilder.fromOrgId(), SearchQueryBuilder.fromBuildingId() и SearchQueryBuilder.fromGeoPoint(). Используйте конструктор SearchQueryBuilder, SearchQueryBuilder.setQueryText(), SearchQueryBuilder.setRubricIds(), SearchQueryBuilder.setOrgId() и SearchQueryBuilder.setBuildingIds().
• SearchQueryBuilder.setOrgId() теперь принимает обязательный параметр OrgId, а SearchQueryBuilder.setBuildingId() заменён на SearchQueryBuilder.setBuildingIds().
• Удалены SearchQueryBuilder.setSpatialRestriction() и SearchQueryBuilder.setGeoPoint(). Используйте SearchQueryBuilder.setRestrictionGeometry() и SearchQueryBuilder.setTerritoryOfInterest().
• В SuggestQueryBuilder удалены статический метод fromQueryText() и метод setSpatialRestriction(). Используйте конструктор SuggestQueryBuilder(String queryText), SuggestQueryBuilder.setRestrictionGeometry() и SuggestQueryBuilder.setTerritoryOfInterest().
• В PackedSearchQuery поля orgId, buildingId, spatialRestriction и geoPoint заменены на orgIds, buildingIds, geometryRestriction, areaOfInterest и territoryOfInterest.
• Из WorkStatus удалены isOpen и description. Используйте openStatus, openStatusHint, scheduleHint и breakHint.
• В GestureManager multitouchShiftSettings переименован в multiTouchShiftSettings, а в MultiTouchRecognizeSettings multitouchShiftThresholdMm переименован в multiTouchShiftThresholdMm.
• Из RoadEventSource удалены getter и setter visibleEvents. Используйте RoadEventSource.roadEventFilter.

Дополнительно для версии Full

• Из SoundCategory удалено значение humps.

С версий 12.x на 13.x

Для версий Full и Map

• Повторно выгрузите стили: исправлены ошибки отображения пользовательских и иммерсивных объектов.

• Обновлены все слои групп Roads для отображения иммерсивных дорог в основном режиме карты.

• Добавлена группа Traffic v13.0.0 для отображения новых цветов тайлов с пробками.

• Добавлена группа Car route line v13.0.0 для отображения автомобильных маршрутов на иммерсивных дорогах.

• Теперь для отслеживания изменений состояний камеры используется единый канал BaseCamera.changed вместо отдельных каналов для каждого свойства. Заменены подписки и добавлена дополнительная фильтрация причин изменений.

• Изменён способ создания некоторых классов:

  • Удалена функция getSystemMemoryManager. Чтобы получить объект для управления системой памяти, используйте метод SystemMemoryManager.instance().
  • Удалён конструктор SearchHistory. Чтобы получить объект истории поиска, используйте метод SearchHistory.instance().
  • Удалён конструктор RoadEventManager. Чтобы получить объект для работы с дорожными событиями, используйте метод RoadEventManager.instance().
  • Удалена функция getHttpCacheManager. Чтобы получить объект для управления HTTP-кешем, используйте метод HttpCacheManager.get().
  • Удалена функция getLocaleManager. Чтобы получить объект для управления локалями приложения, используйте метод LocaleManager.instance().
  • Удалён конструктор TrafficCollector. Чтобы получить объект для управления сервисом сбора информации о дорожном движении, используйте метод TrafficCollector.instance().
  • Удалена функция getAudioSettings. Чтобы получить объект для управления звуком приложения, используйте метод AudioSettings.get().
  • Удалена функция getPackageManager. Чтобы получить объект для работы с пакетами, используйте метод PackageManager.instance().
  • Удалена функция getTerritoryManager. Чтобы получить объект для работы с территориями, используйте метод TerritoryManager.instance().
  • Удалена функция getTerritoriesAlongRouteProvider. Чтобы получить объект для извлечения списка территорий вдоль маршрута, используйте конструктор TerritoriesAlongRouteProvider.
  • Удалена функция getVoiceManager. Чтобы получить объект для управления голосовыми пакетами, используйте метод VoiceManager.instance().

• Удалён класс EventsProcessingSettings.

• Объект Gesture переименован в TransformGesture.

• Объект ScalingSettings переименован в ScalingRecognizeSettings.

• Объект RotationSettings переименован в RotationRecognizeSettings.

• Объект MultiTouchShiftSettings переименован в MultiTouchRecognizeSettings.

• Объект TiltSettings переименован в TiltRecognizeSettings.

• GestureManager.scalingSettings, GestureManager.rotationSettings, GestureManager.multitouchShiftSettings и GestureManager.tiltSettings теперь возвращают объекты с типами ScalingGestureSettings, RotationGestureSettings, MultiTouchGestureSettings и TiltGestureSettings соответственно.

• Класс Color для представления цвета перенесён из пакета ru.dgis.sdk.map.

• Класс ScreenDistance перенесён из пакета ru.dgis.sdk.map.

• Класс ScreenPoint перенесён из пакета ru.dgis.sdk.map.

• Класс ScreenShift перенесён из пакета ru.dgis.sdk.map.

• Свойство buildingLevels для получения этажных планов удалено из DirectoryObject.

• Свойство DirectoryObject.buildingInfo теперь опциональное.

• Свойство BuildingInfo.buildingId теперь обязательное и не может быть пустым.

• Свойство LevelInfo.id теперь опциональное.

• Изменён тип свойства PublicTransportDirectoryRouteInfo.color с int? на Color?.

• Метод SearchQueryBuilder.setGeoPoint() теперь принимает опциональный тип значения.

• Метод SearchQueryBuilder.setRadius() теперь принимает опциональный тип значения.

Дополнительно для версии Full

• Удалены функция getRoadMacroGraph и класс RoadMacroGraph. Теперь для построения офлайн-маршрутов между соседними регионами достаточно скачать пакеты нужных регионов.
• Удалены класс для настройки позиции бабла с полосами на маршруте (LanesCalloutMapPosition и RouteMapObject.lanesCalloutPositions) и свойство в RouteMapObject.
• Переименован класс UIntRouteLongAttribute в DoubleRouteLongAttribute.
• Изменён тип свойства Route.trafficLights с VoidRouteAttribute на StringRouteAttribute.
• Добавлен новый вид транспорта motorcycle (мотоцикл) в TransportType.
• Добавлены параметры для настройки уровня масштабирования для стиля в конструктор SpeedRangeToStyleZoom.
• Добавлены значения для пандусов rampDown, rampUp, smoothRampDown и smoothRampUp в RoadSubtype.
• Добавлены новые значения позиций и ориентиров в CarInstructionCrossroadLandmark.
• Добавлены значения цветов deepGreen и orange в TrafficSpeedColor.
• Добавлен флаг crossing для отображения начала и конца переправы на маршруте в RouteMapObjectDisplayFlag.
• Добавлен новый тип точки маршрута crossing (начало и конец переправы) в RoutePointKind.
• Добавлены значения для оповещений о событиях betterRoute («маршрут лучше») и humps (искусственные дорожные неровности) в SoundCategory.