Migration from previous major SDK versions

From versions 13.x to 14.x

For Full and Map versions

• Styles must be exported again: added and updated styles for the Work layer, light metro, adaptive traffic lights, GPX tracks, and custom cursors.
• Removed MapOptions. Map creation parameters are now in MapControllerOptions, and Flutter widget display parameters are in MapWidgetOptions.
• Changed the creation of MapWidgetController: use the constructor from sdk.Context with controllerOptions, or MapWidgetController.fromMapController(...). Instead of getMapAsync(), use mapAsync, isReady, and the nullable map property.
• The Flutter theming classes MapTheme, MapAppearance, DefaultAppearance, UniversalAppearance, AutomaticAppearance, and MapThemeColorMode are replaced with the MapTheme, MapAppearance, BySystem, and Fixed types.
• Removed the single-object search methods SearchManager.searchById(), SearchManager.searchByDirectoryObjectId(), SearchManager.searchByIdWithLocale(), and SearchManager.searchByDirectoryObjectIdWithLocale(). Use SearchManager.searchByIds() and SearchManager.searchByDirectoryObjectIds().
• Removed the static methods SearchQueryBuilder.fromQueryText(), SearchQueryBuilder.fromRubricIds(), SearchQueryBuilder.fromQueryTextAndRubricIds(), SearchQueryBuilder.fromOrgId(), SearchQueryBuilder.fromBuildingId(), and SearchQueryBuilder.fromGeoPoint(). Use the SearchQueryBuilder constructor, SearchQueryBuilder.setQueryText(), SearchQueryBuilder.setRubricIds(), SearchQueryBuilder.setOrgId(), and SearchQueryBuilder.setBuildingIds().
• SearchQueryBuilder.setOrgId() now accepts a required OrgId parameter, and SearchQueryBuilder.setBuildingId() is replaced with SearchQueryBuilder.setBuildingIds().
• Removed SearchQueryBuilder.setSpatialRestriction() and SearchQueryBuilder.setGeoPoint(). Use SearchQueryBuilder.setRestrictionGeometry() and SearchQueryBuilder.setTerritoryOfInterest().
• In SuggestQueryBuilder, removed the static method fromQueryText() and the setSpatialRestriction() method. Use the SuggestQueryBuilder(String queryText) constructor, SuggestQueryBuilder.setRestrictionGeometry(), and SuggestQueryBuilder.setTerritoryOfInterest().
• In PackedSearchQuery, the orgId, buildingId, spatialRestriction, and geoPoint fields are replaced with orgIds, buildingIds, geometryRestriction, areaOfInterest, and territoryOfInterest.
• Removed isOpen and description from WorkStatus. Use openStatus, openStatusHint, scheduleHint, and breakHint.
• In GestureManager, multitouchShiftSettings is renamed to multiTouchShiftSettings, and in MultiTouchRecognizeSettings, multitouchShiftThresholdMm is renamed to multiTouchShiftThresholdMm.
• Removed the visibleEvents getter and setter from RoadEventSource. Use RoadEventSource.roadEventFilter.

Additionally for Full version

• Removed the humps value from SoundCategory.

From versions 12.x to 13.x

For Full and Map versions

• Styles must be exported again: fixed issues with displaying custom and immersive objects.

• Updated all layers in the Roads group for displaying immersive roads in the main map mode.

• Added the Traffic v13.0.0 group for displaying new colors of tiles with traffic jams.

• Added the Car route line v13.0.0 group for displaying car routes on immersive roads.

• Now, a single channel BaseCamera.changed is used to track camera state changes instead of separate channels for each property. Subscriptions are replaced, and additional filtering of change reasons is added.

• Changed the method of creating some classes:

  • Removed the getSystemMemoryManager function. To obtain an object for managing system memory, use the SystemMemoryManager.instance() method.
  • Removed the SearchHistory constructor. To obtain a search history object, use the SearchHistory.instance() method.
  • Removed the RoadEventManager constructor. To obtain an object for working with road events, use the RoadEventManager.instance() method.
  • Removed the getHttpCacheManager function. To obtain an object for managing the HTTP cache, use the HttpCacheManager.get() method.
  • Removed the getLocaleManager function. To obtain an object for managing application locales, use the LocaleManager.instance() method.
  • Removed the TrafficCollector constructor. To obtain an object for managing the service for traffic information collection, use the TrafficCollector.instance() method.
  • Removed the getAudioSettings function. To obtain an object for managing application sound, use the AudioSettings.get() method.
  • Removed the getPackageManager function. To obtain an object for managing packages, use the PackageManager.instance() method.
  • Removed the getTerritoryManager function. To obtain an object for managing territories, use the TerritoryManager.instance() method.
  • Removed the getTerritoriesAlongRouteProvider function. To obtain an object for extracting a list of territories along a route, use the TerritoriesAlongRouteProvider constructor.
  • Removed the getVoiceManager function. To obtain an object for managing voice packages, use the VoiceManager.instance() method.

• Removed the EventsProcessingSettings class.

• Renamed the Gesture object to TransformGesture.

• Renamed the ScalingSettings object to ScalingRecognizeSettings.

• Renamed the RotationSettings object to RotationRecognizeSettings.

• Renamed the MultiTouchShiftSettings object to MultiTouchRecognizeSettings.

• Renamed the TiltSettings object to TiltRecognizeSettings.

• GestureManager.scalingSettings, GestureManager.rotationSettings, GestureManager.multitouchShiftSettings, and GestureManager.tiltSettings now return objects with ScalingGestureSettings, RotationGestureSettings, MultiTouchGestureSettings, and TiltGestureSettings types, respectively.

• Moved the Color class for representing colors from the ru.dgis.sdk.map package.

• Moved the ScreenDistance class from the ru.dgis.sdk.map package.

• Moved the ScreenPoint class from the ru.dgis.sdk.map package.

• Moved the ScreenShift class from the ru.dgis.sdk.map package.

• Removed the buildingLevels property for obtaining floor plans from the DirectoryObject.

• The DirectoryObject.buildingInfo property is now optional.

• The BuildingInfo.buildingId property is now mandatory and cannot be empty.

• The LevelInfo.id property is now optional.

• Changed the type of the PublicTransportDirectoryRouteInfo.color property from Int? to Color?.

• The SearchQueryBuilder.setGeoPoint() method now accepts an optional value type.

• The SearchQueryBuilder.setRadius() method now accepts an optional value type.

Additionally for Full version

• Removed the getRoadMacroGraph function and the RoadMacroGraph class. Now, to build offline routes between neighboring regions, download the required region packages.
• Removed the class for configuring the position of the bubble with lanes on the route (LanesCalloutMapPosition and RouteMapObject.lanesCalloutPositions) and the property from the RouteMapObject.
• Renamed the UIntRouteLongAttribute class to DoubleRouteLongAttribute.
• Changed the type of the Route.trafficLights property from VoidRouteAttribute to StringRouteAttribute.
• Added a new transport type motorcycle to TransportType.
• Added parameters for configuring the style zoom level to the SpeedRangeToStyleZoom constructor.
• Added the rampDown, rampUp, smoothRampDown, and smoothRampUp values for ramps to RoadSubtype.
• Added new values of positions and landmarks to CarInstructionCrossroadLandmark.
• Added the deepGreen and orange color values to TrafficSpeedColor.
• Added the crossing flag for displaying the start and end of a crossing on a route to RouteMapObjectDisplayFlag.
• Added the crossing new type of a route point (the start and end of a crossing) to RoutePointKind.
• Added values for event notifications betterRoute ("better route") and humps (speed bumps) to SoundCategory.