Skip to main content

Release notes

14.1.0 (2026-09-25)​

🌟 Features and improvements​

🛠 Bug fixes​

  • Fixed the operation of the relief source: the layer is enabled only in regions where relief data from 2GIS is supported.
  • Improved map thread safety: clustering is updated when adding and removing objects.
  • Fixed the behavior of suggestions in DirectorySearchView: the query text is completed by words, and object suggestions open the object through a separate callback function.

14.0.0 (2026-08-11)​

🌟 Features and improvements​

❗ Breaking changes and backward compatibility​

🛠 Bug fixes​

  • Improved navigator operation with unstable geolocation: added incoming coordinate filtering, GNSS quality tracking, protection against unnecessary route rebuilds, and correct handling of a manually set starting point.
  • Fixed route display scenarios: lane bubbles, the camera direction ray, the orientation line in the navigator, road events, the finish screen, and hiding the route line after completion.
  • Improved hints and voice announcements in the navigator: added repeat speed limit warning settings, support for new camera types, and correct priorities for sound notifications.
  • Fixed route building and selection scenarios: error handling in RouteEditorRoutesInfo, batch route requests, public transport quick filters, scheduled toll roads, and formatting the cost of toll road sections.
  • Fixed public transport scenarios: metro maps in transport search results, display of metro, metrotrams, and suburban trains, quick filters, and automatic re-search when they change.
  • Fixed issues in DirectorySearchView: content sizing, manual pagination, and the display of categories, filters, and dynamic filter labels.
  • Fixed errors in organization work statuses in the directory, including organizations operating nearly around the clock, night shifts, breaks, and schedules for nearly closed venues.
  • Fixed map and rendering issues: reopening the map, visibility of markers with visible = false, disappearing traffic jam tiles when changing the zoom level, delays when changing the size of the geolocation marker, and the flow of destroying dynamic objects.
  • Increased the maximum map zoom level to 21.
  • Improved SwiftUI and UIKit elements of the map and navigator: updated traffic jam and parking lot controls, the indoor control, the navigator dashboard, the mini-map, and dashboard expansion gestures.

🗺 Map style updates​

  • Styles must be exported again: added and updated styles for the Work layer, light metro, adaptive traffic lights, GPX tracks, and custom cursors.
  • Fixed the display of the all-tiers underlay after immersive roads are loaded.
  • Added the UnderpassEntranceOrExit style for displaying entrances and exits of underground crossings.

13.6.0 (2026-06-22)​

🌟 Features and improvements​

Added the MapController class:

🛠 Bug fixes​

  • Changed the default value for CameraZoomRestrictions.minZoom from 0 to 2.
  • Now, the camera auto-tilt recovery works independently of other camera flights.
  • Fixed an error in WorkStatus for schedules of organizations operating nearly around the clock.
  • Fixed an error that prevented repeated additions and removals of road events via RoadEventManager.

13.5.0 (2026-05-19)​

🌟 Features and improvements​

13.4.0 (2026-04-22)​

🌟 Features and improvements​

🛠 Bug fixes​

13.3.1 (2026-03-20)​

🌟 Features and improvements​

  • You can now create and download an access key file in Platform Manager: see Get access keys.
  • In the key manifest passed to Container, filling in restrictions/app_id is now optional if you do not plan to use offline data (offlineRouting, offlineMap, offlineDirectory). Otherwise, restrictions/app_id is required.
  • If you pass an empty floor identifier to IndoorControlModel.activeLevelIndex, the building floor plan will be hidden.
  • Closed - structure representing the Closed status of a directory object with details about the reason and time until opening.
  • ClosedReason - reasons for setting the Closed status for a directory object.
  • ClosingHours - structure containing information about non-working time intervals and the closing reason for a directory object.
  • ClosingSoon - structure representing the Closing soon status of a directory object with details about the reason and the time until closing.
  • OpenStatus - enumeration describing the detailed current working status of a directory object (Open, Opening soon, Closing soon, Closed).
  • Opened - structure representing the Open status of a directory object with details about the time until closing.
  • OpeningSoon - structure representing the Opening soon status of a directory object with details about the time until opening.
  • OpeningHours.weekClosingHours - property for storing non-working time intervals of a directory object for each day of the week.
  • OpeningHours.isOpen24x7 - property indicating that a directory object is open 24/7.
  • WorkStatus.openStatus - property containing the detailed Open status of a directory object.
  • WorkStatus.openStatusHint - property containing a text hint for the Open status of a directory object.
  • WorkStatus.scheduleHint - property containing a text hint for a directory object work schedule.
  • WorkStatus.breakHint - property containing a text hint for the current or upcoming break in a directory object work schedule.
  • Reviews.countWithStars - property for the total number of ratings for a directory object, including reviews without text.

❗ Breaking changes and backward compatibility​

  • Updated the offline package format to support new directory data.

🛠 Bug fixes​

  • Traffic tile requests via TrafficSource are now combined to reduce the number of requests.
  • Optimized map tile rendering to avoid using all available CPU cores.
  • Increased the maximum zoom level to 16 for raster tiles added via RasterTileSource.
  • Fixed an issue when adding an animated ModelMapObject where animations were not restarted and models were not rotated towards the camera.
  • Fixed the map readiness channel Map.dataLoadingStateChannel in immersive mode when Map.graphicsPreset is set to GraphicsPreset.immersive.
  • Fixed the TextStyle.textPlacement behavior in Marker.textStyle: the text position relative to the marker is now updated correctly when the value changes.
  • The SearchResultItemView minicard now uses the correct value for the number of reviews (Reviews.countWithStars) instead of the total number of reviews.
  • Fixed unsteady movements and missing synchronization between the user location marker and the route line when navigating long routes across regions.
  • Fixed kilometer display in route bubbles in the Arabic locale.
  • Updated the default ZoomFollowSettings in the navigator to display the visible map area correctly.
  • Fixed UX issues in RouteEditorView, such as improved gesture and scrolling handling in landscape mode.
  • To request public transport routes via PublicTransportRouteSearchOptions, Routing API is now used by default.

13.2.0 (2026-01-22)​

🌟 Features and improvements​

🛠 Bug fixes​

  • Fixed an issue with building offline routes between regions.
  • Fixed an issue where the active lane bubble was not displayed on the map when showing the active route.
  • Fixed an issue when setting the online map source.

🗺 Map style updates​

  • Styles must be exported again: fixed the display of lane bubbles in the Arabic locale.
  • Fixed maximum zoom level values for all buildings and trees.

13.1.0 (2025-12-17)​

🌟 Features and improvements​

🛠 Bug fixes​

  • Fixed a memory leak when displaying traffic jams on the map.
  • Fixed padding, sizes, and colors for the SwiftUI RoadEventCreatorView and UIKit IRoadEventCreatorUIView elements for creating road events.
  • Removed the CallKit library from the build, which was used to track phone calls when playing voice instructions in the navigator.

🗺 Map style updates​

  • Styles must be exported again: fixed the display of building entrance arrows.
  • Added a Route camera direction layer to display the camera direction ray along the route.

12.10.0 (2025-12-19)​

🌟 Features and improvements​

🛠 Bug fixes​

  • Fixed an issue with building offline routes between regions.
  • Removed the CallKit library from the build, which was used to track phone calls when playing voice instructions in the navigator.

13.0.0 (2025-10-13)​

Upgrading from version 12.x

Before upgrading, see the migration instruction.

🌟 Features and improvements​

❗ Breaking changes and backward compatibility​

🛠 Bug fixes​

  • Fixed an issue that caused the application crash when running SearchManager.createSmartManager() if there were no downloaded territories.

  • Added support for iPhone 17, iPhone 17 Pro, iPhone 17 Pro Max, and iPhone Air models, considering their PPI when calculating DPI.

  • Fixed an issue in the search history where repeatedly adding the same item caused errors.

  • Fixed an issue where new search queries were not saved in the history when the set limit was reached.

  • Added a filter to hide building floors on the map if their area on the screen is below a certain threshold.

  • Fixed sound notifications in the navigator:

    • Fixed an issue where the "camera behind" warning was not voiced.
    • Fixed an issue where promo phrases were not voiced despite having a valid voice package.
    • Added sound notifications for stairs on the route.
    • Fixed an issue where intersection control cameras were voiced as speed control cameras.
    • Added sound notifications for route rebuilding for bicycles and scooters.

  • Fixed the navigator operation issues in case of problems with the GPS signal:

    • Fixed an issue where the current location marker changed its position when the weak GPS signal detector was active.
    • Fixed issues that occurred when the user approached the end point of the route with an unstable GPS signal.
    • Added a feature to disable route deviation detection when GPS signal accuracy is low.
    • Now, when GPS signal accuracy drops sharply during navigation, the user location is not moved to another place on the map.

  • Fixed the navigator operation issues:

    • Fixed an issue where the bubble with information about the route time and length was not displayed on the route search screen if one of the routes lacked unique segments.
    • Fixed an issue where the time difference in the alternative route bubble was not updated if the user did not move while using the navigator.
    • Removed exit names in bubbles if no direction is specified or the exit leads to an object of the "airport" type.
    • Fixed an issue where road event icons did not respond to taps.
    • Added support for displaying and coloring traffic jams on unpaved roads.
    • Fixed duplication of icons for Moscow MCC, MCD, Aeroexpress, and suburban trains in the bubble of a route with transfers.
    • Fixed incorrect display of the route line at intersections.
    • Removed the display of an additional icon with lanes for cameras that record failure to give priority to pedestrians.
    • Fixed an issue where the user geolocation was incorrectly snapped to the route when returning to it.
    • Fixed an issue that caused the application crash when rebuilding a pedestrian route in turn-by-turn mode.
    • Fixed behavior where additional icons were displayed on the route after the expiration of a road event.
    • Updated the logic for displaying additional icons with lanes for confirmed road events.
    • Added a restriction where toll roads are excluded from the route when it is rebuilt if the user selected free roads only.
    • Added displaying of notifications about stairs on the route estimated time panel.
    • The navigator now continues to guide the user along the route and rebuilds it if necessary, even if the finish pane (with the Finish route button) is closed.
    • Updated the logic of lane filtering: lanes that allow straight movement are not excluded from the route lane bubbles.
    • Added visualization of blinking of traffic jams on the route at speeds of 80-90 km/h.

  • Fixed the layout of all SwiftUI elements in NavigationView.

  • Fixed the return to position tracking and zoom level in NavigationView. The camera and tracking mode now restore correctly when exiting the route overview.

🗺 Map style updates​

  • 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.

12.8.0 (2025-08-14)​

🌟 Features and improvements​

🛠 Bug fixes​

  • Traffic data via TrafficSource is no longer requested or updated while the application is in the background.
  • Improved dashboard layout for trip management in NavigatorView: updated paddings, button sizes, component order and structure, and fixed element height values.
  • Adjusted maneuver block paddings in NavigatorView so that messages about GPS signal loss and route recalculation are displayed lower on the screen.

12.7.2 (2025-06-20)​

🌟 Features and improvements​

🛠 Bug fixes​

12.7.0 (2025-06-03)​

🌟 Features and improvements​

🗺 Map style updates​

  • Styles must be exported again: in the navigator, fixed displaying immersive roads and fog.

12.6.3 (2025-05-13)​

🛠 Bug fixes​

  • Optimized TrafficSource:

    • Traffic tiles are requested when changing the map scale and by timer.
    • Traffic jam score is updated when changing the region and by timer.

  • Improved map performance when adding polygons with a large number of vertices via MapObjectManager.

12.6.0 (2025-04-17)​

🌟 Features and improvements​

🛠 Bug fixes​

  • Fixed the update of generalization when changing attributes of objects added via the MapObjectManager.withGeneralization() method.
  • Fixed an issue where the application would crash when logging network requests.
  • Fixed an issue where the application would crash when handling the map tilt gesture.

12.5.0 (2025-03-25)​

🌟 Features and improvements​

🛠 Bug fixes​

  • Fixed an issue that caused a geolocation marker added via MyLocationMapObjectSourcedisappear during the first camera flight.
  • Fixed the recovery of displaying the geolocation marker when an application returns from being in the minimized state for a long time.
  • Fixed the display of route information on the map when the text is written right-to-left for the RouteEditorSource data source.
  • Changed the settings of caching source data on a route. Now the data is cached at a distance of 4000 meters forward from the current position on the route instead of 20000 meters.

🗺 Map style updates​

  • Styles must be exported again to apply the fix of displaying route information on the map when the text is written right-to-left.

12.4.3 (2025-02-19)​

🌟 Features and improvements​

  • Projection.distanceOnMap() - method for calculating the distance between points on the map that correspond to the specified points on the screen.
  • Projection.distanceOnScreen() - method for calculating the distance between points on the screen that correspond to the specified points on the map.

🛠 Bug fixes​

12.4.0 (2025-01-30)​

🌟 Features and improvements​

🛠 Bug fixes​

  • Now the position of the 3D model coincides with the camera direction if the bearing value is not specified in ModelMapObject.mapDirection.
  • Fixed incorrect configuring attributes for generalizing objects added to the map via MapObjectManager.withClustering. Now changing object attributes at a certain zoom level is applied to all levels.
  • Fixed the operation of the attribute for controlling the visibility of an object on the map SimpleMapObject.isVisible when generalizing and clustering objects.

🗺 Map style updates​

  • Fixed the priority of processing clicks between the geolocation marker and buildings on the map.

12.3.0 (2024-12-18)​

🌟 Features and improvements​

🛠 Bug fixes​

  • Fixed duplicating branch numbers for organization categories in Suggest.subtitle.
  • Fixed an issue of getting coordinates of an object when processing of click in the Marker that is added to the map before the initial map loading.
  • Fixed the display of the 3D model of navigator geolocation marker for all route types except pedestrian. For a pedestrian route, a regular model of geolocation marker is displayed.
  • Updated navigator configuration to improve performance in poor GPS signal conditions.
  • Fixed the display of a next maneuver for left-hand traffic when passing roundabouts in INavigationView.

🗺 Map style updates​

  • Added a layer for displaying dynamic 3D models.

12.2.1 (2024-12-03)​

🛠 Bug fixes​

  • Fixed the issues that caused performance degradation when displaying a large number of objects on the map.

12.2.0 (2024-11-15)​

🌟 Features and improvements​

🛠 Bug fixes​

  • Improved the mechanism of getting marker object title ItemMarkerInfo.title. Now it is considered that a marker may have no title.
  • Fixed a potential issue during map initialization when a style could be installed before the initialization process was completed.
  • Fixed a potential freeze of MapObjectManager when objects are frequently added and removed using the MapObjectManager.removeAndAddObjects method.
  • Added additional verification of the correctness of handling the map tilt gesture so that it does not lead to an application crash.
  • Fixed an application crash when logging network requests.
  • Fixed an issue that caused MapViewOverlay to operate with interruptions when interacting with the map.
  • Fixed operation of SwiftUI elements for the map, which previously were recreated during each update of the interface.
  • Fixed road events display, which previously worked not for all regions.
  • Fixed the display of route arrows in relation to immersive roads of actual width in the navigation mode.
  • Fixes a potential issue that prevented the display of lane bubbles on the route in the navigation mode.

🗺 Map style updates​

  • Fixed style issues when displaying a geolocation marker in the navigation mode with immersive roads of actual width.
  • Fixed style issues when displaying building floor plans.

12.1.0 (2024-09-24)​

🌟 Features and improvements​

🛠 Bug fixes​

  • Updated DgisSource.createDgisSource to return the hybrid tiles source of the default map in Full SDK version.
  • Improvements to the immersive roads of actual width operation in the navigation mode.

🗺 Map style updates​

  • Fixed issues in styles when displaying immersive roads of actual width.
  • Fixed fog display at different map tilt angles.

12.0.0 (2024-08-19)​

Upgrading from version 10.x

Before upgrading, see the migration instruction.

🌟 Features and improvements​

❗ Breaking changes and backward compatibility​

  • Removed the Container.apiKeyOptions parameter. You can now explicitly pass the key file source using KeySource, KeyFromAsset, KeyFromFile,and KeyFromString.
  • Removed the Container.vendorConfigFile parameter. You can now explicitly pass the configuration file source using VendorConfig, VendorConfigFromAsset, VendorConfigFromFile, and VendorConfigFromString.
  • Removed Container.makeStyleFactory(), Container.makeSearchManagerFactory(), Container.makeSourceFactory(), Container.makeImageFactory(), and Container.makeLocaleManager() methods. Instead, use Container.styleFactory, Container.searchManagerFactory, Container.sourceFactory, Container.imageFactory, and Container.localeManager fields.
  • Removed IPositioningServicesFactory and the Container.positioningServices. When creating a Container, pass Container.locationProvider and Container.magneticHeadingProvider separately.
  • Removed ILocationService. Instead, use LocationService with similar functionality.
  • Removed MyLocationController and MapLocationController.myLocationIndicatorController. To configure the marker geolocation source, use MyLocationControllerSettings. In the INavigationView, geolocation source is now not substituted.
  • Changed the HttpOptions structure while keeping its functionality.
  • Renamed fields in LogOptions: osLogLevel and customLogLevel are now systemLevel and customLevel correspondingly.
  • Renamed values in LogLevel: disabled and fault are now off and fatal correspondingly.
  • Removed the CameraState.followPosition value. Instead, use the Camera.behaviour value.
  • Extended values for SuggestedType, SuggestorType, and ObjectType so that they now correspond to Places API results.
  • Aligned MyLocationMapObjectMarkerType values with standard naming.
  • Removed the createRasterTileDataSource() method. Added a new source RasterTileSource, which enables setting transparency for raster tiles.
  • Removed AudioVolume. You can now set instructions volume from 0 to 100 using AudioSettings.volume.
  • Removed AudioOptions and IAudioSettings. Use AudioSettings to configure sounds in the SDK.
  • RouteMapObjectDisplayFlag.immersiveRouteParts - flag to use immersive geometry on route parts.

🛠 Bug fixes​

  • Optimized caching of road events when displaying them on the map.
  • Fixed issues that prevented displaying route variants if an invalid variant was included into the list of public transport routes.
  • Fixed the record of the covered distance along an alternative route.
  • Improved the display of stops on public transport routes.
  • Improved erasing of the route when the route finish point is reached.
  • Fixed the active route display in poor GPS signal conditions.
  • Voice instructions are now not played during navigation in poor GPS signal conditions.
  • Distance to the next camera is not considered if it is less than 150 meters.
  • Voice instructions are not played when navigation starts.
  • Distance to intersection control cameras, public transport lanes, and road markings is not voiced.
  • Distance left on route is not voiced if other instructions are expected further on route.
  • Pedestrian obstacles and road subtypes for non-pedestrian routes are not voiced.

🗺 Map style updates​

  • Added layers with immersive roads of actual width.
  • Improved various layers so that they are displayed properly if immersive roads of actual width are present on the map.
  • Updated geolocation marker designs in normal and navigation modes. Made the marker display in light and dark themes consistent.
  • Added support for new Moscow Metro line MCD-4A.
  • Fixed styles of Moscow Metro lines MCD-3, MCD-4, MCD-4A, and MCD-5.
  • Added stop captions on public transport routes.
  • Enabled displaying stop captions when viewing the full route of a selected public transport.