Release notes
14.3.0 (2026-11-10)
🌟 Features and improvements
-
MapObjectManager.setPreRenderProcessor() - method for connecting a handler for frame-by-frame object movement. To disable the processing and return objects to the positions specified by their geometry, pass
nullto the method. -
Updates to Android Compose components:
-
RouteEditorActionButtonsPanelComposable and RouteEditorActionButtonsPanelColors - UI elements for configuring the action panel in the route editor. The panel supports floating and embedded placement, light and dark themes.
-
Updated detailed public transport route cards: added the direction of travel, schedules, and alternative transport options for a segment.
-
TransportInfo.directionName - property for obtaining the transport direction of travel.
-
Updated the voice package screen VoicesLayout:
- VoiceUiModel.description - property for displaying the voice package description.
- VoiceLanguagesLayout - screen for selecting the voice package language. To navigate to it, use the
onNavigateToLanguagesparameter in VoicesLayout.
-
onStopClickedin SettingsProgressIndicator() - parameter for handling taps on the loading indicator.
-
🛠 Bug fixes
- Fixed updating object clustering when objects are added and removed simultaneously and their attributes and visibility change. Now, cluster recalculation and object loading completion take into account all pending operations, including when the source is connected to another map.
- Fixed the size and expansion animations of the bottom panel in the route editor in Android Compose: transitions between collapsed, intermediate, and expanded states, switching card lists, and placement of the route parameters button.
- Fixed the display of walking and transport segments in public transport route cards: padding, connecting lines, long labels, and styling in the dark theme.
14.2.0 (2026-10-08)
🛠 Bug fixes
- Improved SDK operation stability and fixed internal issues.
- Fixed an issue in
RouteOverviewin Android Compose that caused an empty geometry to be passed to thecalcPosition()method when displaying the remaining part of the route. The route overview no longer causes the application to crash in navigation edge cases. - Improved logging and error reporting from the native layer: log messages are now passed as standalone strings and do not depend on the lifetime of the source buffers.
- Removed deprecated
LegacyMapViewwrappers from the SDK test application: examples now use the common layerDemoMapActivityorMapController.
13.7.0 (2026-09-29)
Improved SDK operation stability and fixed internal issues.
14.1.0 (2026-09-25)
🌟 Features and improvements
-
DgisSource.createReliefDgisSource() - method for creating a 3D relief source from 2GIS data. The relief is automatically enabled when the source is added to the map.
The source works only in regions where relief data from 2GIS is supported. See the list of regions in the 3D relief data source section.
-
MapView can now be declared in XML markup: added a constructor with
AttributeSet, enabled support of the attributesdgis_renderModeanddgis_copyrightInsetsSides. -
MapControl and SnapToMapLayout included in MapView are now automatically bound to the map and update the binding when the MapController changes.
-
TimePoint.toUiString() - method for formatting a specific point in time as a string for display in UI elements. The parameters specify the locale and time zone.
-
PackageInfo.description - localized detailed description of the data package, including voice packages and territory packages.
-
Updates to Android Compose components:
- New elements for displaying a public transport route card: PublicTransportRouteComposable, PublicTransportRouteViewModel, PublicTransportRouteContent, and DefaultPublicTransportRouteContent. The elements contain customizable blocks for the header, departure and arrival points, segments, and the start route button.
- Updated public transport route components: added data on the distance of walking segments, names of boarding and alighting stops, intermediate stops, and separate UI components for the route line, badges, walking and transport segments.
🛠 Bug fixes
- Improved map thread safety: updating clustering when adding and removing objects.
- Fixed scenarios in RouteEditorComposable: synchronization of horizontal and vertical route lists, selected card indicator, recalculation of transport row height, and card width constraints.
14.0.0 (2026-09-03)
🌟 Features and improvements
- MapTheme and MapAppearance - API for choosing a light, dark, or standard map theme. The created map provides Map.appearance, Map.themeChannel, and Map.universeDrawingMode.
- MapControllerOptions.positionPoint, MapControllerOptions.zoomRestrictions, MapControllerOptions.style, MapControllerOptions.styleFile, and MapControllerOptions.mapAppearance - parameters for creating a map.
- MapRenderOptions, MapRenderMode, MapCopyrightOptions, and CopyrightMargins - display settings for MapView and Android Compose: rendering mode, DPI, screen density, and copyright.
- MapControllerViewModel, MapControllerState, DefaultMapControllerViewModel, LazyMapControllerViewModel, and MapControllerFactory - API for owning MapController and passing the map to an Android View or Android Compose.
- MapView.setMapControllerViewModel(), MapView.renderOptions, and MapView.copyrightOptions - a way to connect the map to
MapViewand change its view-layer parameters. - MapComposable, MinimapComposable, DefaultMinimapControllerViewModel, NavigationMinimapControllerViewModel, and MinimapRenderOptions - updated map and minimap API based on MapControllerViewModel.
- The updated design of map UI elements for Android Compose is now the default: CompassComposable, IndoorComposable, MyLocationComposable, TrafficComposable, and ZoomComposable.
- RouteEditorComposable - route selection screen in Android Compose with built-in settings, customization via RouteEditorContent, and public transport route cards.
- PublicTransportBriefRouteComposable, PublicTransportBriefRouteViewModel, PublicTransportScheduleProvider, and TransportSchedule - UI and model for a brief public transport route card.
- Category, CategoriesPage, and SearchCategoriesResult - API for working with directory categories.
- CategorySearchQueryBuilder, CategoryListQueryBuilder, CategoryGetByIdsQueryBuilder, CategoryQuery, CategorySortType, CategoryType, and CategoryGeoContext - types for building category queries.
- SearchManager.searchCategories() - method for obtaining directory categories.
- SearchManager.searchByIds() and SearchManager.searchByDirectoryObjectIds() - methods for batch searching for directory objects by identifiers.
- IsOpenAllDay and the
OpenStatus.isOpenextension - filter and check for organizations open 24/7. - MapRenderedObjectObserver and MapController.renderedObjectObserver - API for observing interactions with rendered map objects.
- GestureManager.multiTouchShiftSettings - separate settings for the multi-finger map shift gesture.
- PublicTransportQuickFilter, PublicTransportRouteSearchOptions.quickFilter, and RouteEditorRoutesInfo.availablePublicTransportQuickFilters - quick filters for public transport routes.
- RouteSummaryProvider, RouteSummary, CarRouteSummary, MotorcycleRouteSummary, BicycleRouteSummary, PedestrianRouteSummary, and ScooterRouteSummary - summary information for routes of different types.
computeRouteAltitudes(), RouteAltitudeItem, AltitudeChange, Route.immersiveHeights, and Route.edgeObjectIds - route elevation and static object data.- BicycleRouteSearchOptions.avoidLockedRoads, PedestrianRouteSearchOptions.avoidLockedRoads, ScooterRouteSearchOptions.avoidLockedRoads, and new data in RouteTollPaymentPointInfo - additional route building settings and information about toll roads.
- TripHighlightsCollector, TripHighlights, and NavigationManager.tripHighlightsCollector - collection of statistics for a completed trip.
- SoundNotificationSettings.speedCameraNotification, SpeedCameraNotification, AlternativeRoutesProviderSettings.onAlternativeRoutesSuggestedRouteSearchDelay, and DynamicRouteInfoSettings.updatePeriod - navigation settings.
- PublicTransportSchedule, PublicTransportPlatformSchedule, PublicTransportIntervalSchedule, and PublicTransportPreciseSchedule - public transport schedules in directory objects.
❗ Breaking changes and backward compatibility
- Removed
MapOptions. Initial map parameters are now split between MapControllerOptions, MapRenderOptions, and MapCopyrightOptions. - Changed the creation of MapView: use
MapView(context, renderOptions, copyrightOptions)and MapView.setMapControllerViewModel(). Removed the constructors withMapOptions,Map, andAttributeSet, as well as creating the map via XML attributes. - Removed
getMapAsync(),setTouchEventsObserver(),addObjectTappedCallback(),addObjectLongTouchCallback(),setCopyrightMargins(),setCopyrightGravity(),showApiVersionInCopyrightView,maxFps,powerSavingMaxFps,fpsChannel,renderView,gestureManager,mapTheme,setTheme(),takeSnapshot(), anduseDefaultGestureRecognitionEngine()from MapView. Use MapControllerViewModel, MapController, MapRenderer, MapGestureRecognizer, MapRenderedObjectObserver, MapRenderOptions, and MapCopyrightOptions. - Removed MapComposableState. MapComposable and MinimapComposable now accept MapControllerViewModel.
- Removed the old map controls for Android Compose, and renamed the packages with the updated design: instead of
ru.dgis.sdk.compose.map.controls.modern.*, useru.dgis.sdk.compose.map.controls.*. - Removed the separate lambda parameters for
routeCard,noRoutesCard,routePointsDisplay, andtransportationModesRowfrom RouteEditorComposable. For customization, use RouteEditorContent. - In the search for Android Compose,
SearchReviewsComposableis replaced with SearchRatingsComposable. InSearchResultItemStateandDirectoryObjectViewModel, theratingandreviewsCountproperties are replaced withaverageRatingandratingCount. - Removed the single-object search methods
SearchManager.searchById(),SearchManager.searchByDirectoryObjectId(),SearchManager.searchByIdWithLocale(), andSearchManager.searchByDirectoryObjectIdWithLocale(). Use SearchManager.searchByIds() and SearchManager.searchByDirectoryObjectIds(). - Removed the static methods
SearchQueryBuilder.fromQueryText(),SearchQueryBuilder.fromRubricIds(),SearchQueryBuilder.fromQueryTextAndRubricIds(),SearchQueryBuilder.fromOrgId(),SearchQueryBuilder.fromBuildingId(), andSearchQueryBuilder.fromGeoPoint(). Use the SearchQueryBuilder() constructor, SearchQueryBuilder.fromQuery(), and theset*methods. - SearchQueryBuilder.setOrgId() now accepts a required
OrgIdparameter, andSearchQueryBuilder.setBuildingId()is replaced with SearchQueryBuilder.setBuildingIds(). - Removed
SearchQueryBuilder.setSpatialRestriction()andSearchQueryBuilder.setGeoPoint(). Use SearchQueryBuilder.setRestrictionGeometry() and SearchQueryBuilder.setTerritoryOfInterest(). - In PackedSearchQuery, the
orgId,buildingId,spatialRestriction, andgeoPointfields are replaced with orgIds, buildingIds, geometryRestriction, areaOfInterest, and territoryOfInterest. - In SuggestQueryBuilder, removed the
fromQueryText()andsetSpatialRestriction()methods. Use theSuggestQueryBuilder(queryText)constructor, SuggestQueryBuilder.fromQuery(), SuggestQueryBuilder.setRestrictionGeometry(), and SuggestQueryBuilder.setTerritoryOfInterest(). - Removed the
isOpenanddescriptionproperties from WorkStatus. Use WorkStatus.openStatus, WorkStatus.openStatusHint, WorkStatus.scheduleHint, WorkStatus.breakHint, and theOpenStatus.isOpenextension. - Moved GeoRect from the
ru.dgis.sdk.coordinatespackage toru.dgis.sdk.geometry. The new type is used inSearchQueryBuilder.setAreaOfInterest(),SuggestQueryBuilder.setAreaOfInterest(), andGeometry.bounds. - In GestureManager, the
multitouchShiftSettingsproperty is renamed to multiTouchShiftSettings, and in MultiTouchRecognizeSettings, themultitouchShiftThresholdMmproperty is renamed to multiTouchShiftThresholdMm. - Removed the
visibleEventsgetter and setter from RoadEventSource. Use RoadEventSource.roadEventFilter. - Removed the
HUMPSvalue from SoundCategory.
🛠 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.
- Improved map and navigation components in Android Compose: map controls, the minimap, the route editor, public transport cards, schedules, route settings, and landscape orientation.
- 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 object and search result cards in Android Compose: the number of ratings Reviews.countWithStars is now used, and the rating texts, addresses, contacts, work hours, and closing statuses are updated.
- 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, the flow of destroying dynamic objects, and releasingMapViewresources. - Increased the maximum map zoom level to 21.
🗺 Map style updates
- Styles must be exported again: added and updated styles for the
Worklayer, light metro, adaptive traffic lights, GPX tracks, and custom cursors. - Fixed the display of the
all-tiersunderlay after immersive roads are loaded. - Added the
UnderpassEntranceOrExitstyle for displaying entrances and exits of underground crossings.
13.6.0 (2026-06-22)
🌟 Features and improvements
Added the MapController class:
- MapController - class for managing the map, combining Map, MapRenderer, and MapGestureRecognizer.
- MapControllerOptions - class with parameters for creating a MapController.
- MapController.create() - static method for asynchronously creating a MapController based on Context and MapControllerOptions.
- MapController.map - property for obtaining a Map object from the MapController.
- MapController.renderer - property for obtaining a MapRenderer object from the MapController.
- MapController.gestureRecognizer - property for obtaining a MapGestureRecognizer object from the MapController.
🛠 Bug fixes
- Changed the default value for CameraZoomRestrictions.minZoom from
0to2. - 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 caused the application to crash when scaling the map on Samsung Galaxy Tab A8 with Android 14.
- Fixed an error that prevented repeated additions and removals of road events via RoadEventManager.
- Fixed the logic for calculating and filling the
ageMsandlastSeenMsfields for cell towers in theRadarmodule based on the current time and Android API version. Fixed the clearing of outdated values.
13.5.0 (2026-05-19)
🌟 Features and improvements
-
UI elements for the Android Compose framework:
- RouteEditorErrorComposable - UI element for displaying a route building error.
- ru.dgis.sdk.compose.navigation.settings - set of UI elements (layouts) for displaying navigation settings. To enable settings display in the navigation dashboard, pass NavigationSettingsRepository to the DefaultNavigationControlsState constructor.
-
SearchQueryBuilder() - default constructor that enables setting various search parameters: text, rubric IDs, building IDs, or organization IDs.
-
SearchQueryBuilder.setQueryText() - method for setting the search query text.
-
SearchQueryBuilder.setRubricIds() - method for setting rubric IDs in a search query.
-
SearchQueryBuilder.setOrgId() - method for setting a filter by organization ID.
-
SearchQueryBuilder.setBuildingId() - method for setting a filter by building ID.
-
SearchQueryBuilder.setRestrictionGeometry() - method for setting a strict search area restriction as a geometry.
-
SearchQueryBuilder.setTerritoryOfInterest() - method for setting a non-strict search area restriction: if an object is not within the area, it is not discarded, but its rank in search results is lowered.
-
SuggestQueryBuilder.setRestrictionGeometry() - method for setting a strict area restriction for search suggestions as a geometry.
-
SuggestQueryBuilder.setTerritoryOfInterest() - method for setting a non-strict area restriction for search suggestions: if an object is not within the area, it is not discarded, but its rank in search results is lowered.
-
PackedSearchQuery.geometryRestriction - property for obtaining the geometry that restricts the search area.
-
PackedSearchQuery.territoryOfInterest - property for a non-strict search area restriction: if an object is not within the area, it is not discarded, but its rank in search results is lowered.
-
PolygonGeometry.elevation - property for setting the polygon elevation above the surface.
-
PolylineGeometry.elevation - property for setting the polyline elevation above the surface.
-
Polyline.elevation - property for setting the polyline elevation above the surface.
-
PolylineOptions.elevation - property for setting the polyline elevation above the surface in polyline options.
-
Polygon.elevation - property for setting the polygon elevation above the surface.
-
PolygonOptions.elevation - property for setting the polygon elevation above the surface in polygon options.
-
DashedPolygonOptions - class for dashed polygon outline options.
-
Polygon.dashedPolygonOptions - property for dashed polygon outline options.
-
PolygonOptions.dashedPolygonOptions - property for configuring a dashed polygon outline in polygon options.
-
RouteEnclosingRectsOptions - class for options to obtain rectangles enclosing a simplified route geometry.
-
getRouteEnclosingRects() - method for obtaining a set of rectangles enclosing a simplified route geometry.
-
SharedRouteData - class containing information about a pre-built route and its search parameters.
-
TrafficRouter.fetchSharedRoute() - method for obtaining a pre-built route and its search parameters by ID. For details, see the Using a pre-built route example.
🛠 Bug fixes
- Fixed the display of lower floors in a floor plan via the IndoorComposable UI element.
13.4.0 (2026-04-22)
🌟 Features and improvements
-
UI elements for the Android Compose framework:
- CompassComposable - UI element with updated design for displaying the compass.
- IndoorComposable - UI element with updated design for switching floors in a building.
- MyLocationComposable - UI element with updated design for flying to the user current location and switching the tracking mode.
- TrafficComposable - UI element with updated design for displaying the current traffic level and switching traffic visibility on the map.
- ZoomComposable - UI element with updated design for zooming the map.
- DirectoryObjectComposable - UI element for displaying a full object card from the directory. To customize it, use SearchComposableColors.
-
Changed the default value of GlobalMapOptions.graphicsApi: now
GraphicsApi.VULKANis used instead ofGraphicsApi.OPEN_GL. -
GlobalMapOptions.vulkanEmulatorSupportEnabled - property for enabling Vulkan emulator support.
-
The IndoorControlModel.levelNames property now remains empty if no building with floor plans is displayed on the map, even if the building has one floor.
-
LocationQuality - quality of the current location detection.
-
MyLocationControlModel.locationQuality - property for obtaining the quality of the current location detection.
-
Increased the maximum camera tilt angle CameraPosition.tilt to 70.0.
🛠 Bug fixes
- Adjusted the values of WorkStatus.openStatusHint and WorkStatus.scheduleHint properties for organizations operating at night.
- Fixed the disappearance of traffic tiles obtained via TrafficSource when changing the map zoom level.
- Fixed crashes in IndoorManager.
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 DGis.initialize(), filling in the
restrictions/app_idis now optional if you do not plan to use offline data (offlineRouting,offlineMap,offlineDirectory). Otherwise,restrictions/app_idis required. - If you pass an empty floor identifier to IndoorControlModel.activeLevelIndex, the building floor plan will be hidden.
- Closed - class representing the
Closedstatus of a directory object with details about the reason and time it opens. - ClosedReason - reasons for setting the
Closedstatus for a directory object. - ClosingHours - class containing information about non-working time intervals and the closing reason for a directory object.
- ClosingSoon - class representing the
Closing soonstatus of a directory object with details about the reason and the time until closing. - OpenStatus - class describing the detailed current working status of a directory object (
Open,Opening soon,Closing soon,Closed). - Opened - class representing the
Openstatus of a directory object with details about the time until closing. - OpeningSoon - class representing the
Opening soonstatus 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
Openstatus of a directory object. - WorkStatus.openStatusHint - property containing a text hint for the
Openstatus 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.
- 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 RouteEditorComposable, such as flickering of the route type selector.
- To request public transport routes via PublicTransportRouteSearchOptions, Routing API is now used by default.
13.2.0 (2026-01-22)
🌟 Features and improvements
- SearchResultItemComposable - UI element for displaying an object minicard via Android Compose framework. To customize it, you can use SearchResultItemComposableColors and SearchResultItemComposableFonts.
- Marker.suppressOnOverlap and MarkerOptions.suppressOnOverlap - property for managing the visibility of the marker icon if objects on the map overlay.
- SimpleClusterObject.suppressOnOverlap and SimpleClusterOptions.suppressOnOverlap - property for managing the visibility of the cluster object icon if objects on the map overlay.
- RoadEventFilterData - class with road event data used for filtering.
- RoadEventFilter and RoadEventSource.roadEventFilter - interface of the filter of displayed road events.
- DefaultRoadEventFilter - class for creating standard time-based filters for road events.
🛠 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.
🗺 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
- DirectoryObject.nearestParkingIds - property for obtaining a list of the nearest parking lots.
- DirectoryObject.nearestStations - property for obtaining a list of the nearest public transport stops or stations.
- DirectoryObject.nearestPlatforms - property for obtaining a list of the nearest stop platforms.
- NearestPlatform - class with information about the nearest stop platform.
- NearestPlatformTransitionType - transition types between the nearest stop platforms.
- NearestStation - class with information about the nearest public transport stop or station.
- LabelingPriority - class for managing the priority of labeling (displaying a label or icon on the map).
- Marker.labelingPriority, MarkerOptions.labelingPriority, and SimpleClusterOptions.labelingPriority - properties for managing the priority of marker labeling.
- TextStyle.labelingPriority - property for managing the priority of marker text labeling.
- CommonGestureSettings and GestureManager.commonSettings - class and property for accessing general settings of map gestures.
- CommonRecognizeSettings - class with settings for recognizing map gestures.
- ScalingKinematicSettings and ScalingGestureSettings.kinematicSettings - class and property for configuring map scaling kinematics.
- RotationKinematicSettings and RotationGestureSettings.kinematicSettings - class and property for configuring map rotation kinematics.
- TiltKinematicSettings and TiltGestureSettings.kinematicSettings - class and property for configuring map tilt kinematics.
- RouteEditorComposable - UI element for displaying the route selection screen via Android Compose framework. To customize it, you can use RouteEditorComposableColors and RouteEditorTextStyles.
- MinimapComposable - UI element for displaying a minimap via Android Compose framework. By default, the element is embedded in NavigationControlsComposable, but you can display it separately on the map.
- MiniMapControlModel - class of the model for managing the minimap in the navigation UI element.
- RouteEditorRoutesInfo.error - property for obtaining detailed information about an error when searching for a route.
- RouterErrorInfo - class for describing an error when building a route.
- RouterErrorCode - categories of errors when building a route.
- RouterErrorSource - sources of errors when building a route.
- Added a Tajik voice package for the navigator.
🛠 Bug fixes
- Fixed a memory leak when displaying traffic jams on the map.
🗺 Map style updates
- Styles must be exported again: fixed the display of building entrance arrows.
- Added a
Route camera directionlayer to display the camera direction beam along the route.
13.0.0 (2025-10-13)
Before upgrading, see the migration instruction.
🌟 Features and improvements
- DgisSource.createImmersiveDgisSource - source of immersive data.
- BaseCamera.changed - channel for notifications about camera state changes.
- CameraChange - class containing information about camera state changes.
- CameraChangeReason - reasons for camera state changes.
- LevelInfo.linkedLevelIds - identifiers of linked floor plans.
- BriefRoadEvent.trustworthy - flag indicating the reliability of a road event.
- IndoorBuilding.mode and IndoorBuilding.modeChannel - mode of displaying buildings with floor plans.
- IndoorBuilding.linkedWith() - method for checking the link between buildings with floor plans.
- RoadEvent.elevation - elevation of a road event.
- BranchesInfo and DirectoryObject.branchesInfo - information about linked organizations.
- FloorsInfo and BuildingInfo.floorsInfo - information about the number of floors in a building.
- SearchManager.search() - method for searching directory objects using SuggestQuery and settings.
- SearchSettings - settings for searching directory objects.
- SearchHistoryKeyStrategy and SearchHistory.setKeyStrategy() - method for setting the strategy for creating keys for search history items.
- IncompleteTextHandler.searchQuery - property of the search query.
- StorageOptions - class for offline data storage parameters. It is passed to DGis to specify the path to the root directory of the main download storage.
- RouteCamera.mobility - flag indicating the mobility of a road camera.
- ObstacleInfo.objectId - identifier of an obstacle object on the route.
- BicycleRouteSearchOptions.avoidUnpavedRoads - flag to avoid unpaved roads on bicycle routes.
- PedestrianRouteSearchOptions.avoidUnpavedRoads - flag to avoid unpaved roads on pedestrian routes.
- ScooterRouteSearchOptions.avoidUnpavedRoads - flag to avoid unpaved roads on scooter routes.
- DataPrefetcher and NavigationManager.dataPrefetcher - class for prefetching map tiles along the route.
- FinishDetector and NavigationManager.finishDetector - class for managing the route completion controller.
- TrafficJamDetector and NavigationManager.trafficJamDetector - class for detecting traffic jams on the route.
- MapLocationController.userControlOverMap - flag for applying custom values of the map zoom level and tilt.
- CrossingType and Route.crossingTypes - types of crossings on the route.
- MotorcycleBriefRouteInfo - class with basic information about a motorcycle route.
- MotorcycleBriefRouteInfoTrafficSpeed - traffic speeds for motorcycle routes.
- MotorcycleRouteSearchOptions - class with parameters of motorcycle routes search.
- PublicTransportInfo.routeInfos - descriptions of public transport routes.
- PublicTransportRouteInfo - class with information about a public transport route.
- PublicTransportCostInfo - class containing information about the cost of travel on public transport.
- RouteTollPaymentPointInfo and Route.tollPaymentPointInfos - class containing information about payment points on a toll road.
- RouteTollPaymentPointType - type of payment on a toll road.
- TraversalType - direction of public transport circular line.
- Package.pause() - method for pausing the package installation or update.
- Package.install(InstallFallback) - method for installing or updating a package with an error handler.
- InstallFallback - interface for defining behavior in case of errors during package installation or update.
- DefaultInstallFallback - factory for creating strategies for handling errors during package installation or update.
- DefaultInstallFallback.noOperation() - method for creating an
InstallFallbackthat performs no operations. - DefaultInstallFallback.retryOnError() - method for creating an
InstallFallbackthat retries the installation in case of a package download error. - VoiceManager.defaultVoice - property for obtaining a voice package based on a list of locales.
❗ Breaking changes and backward compatibility
-
Updated the minimum supported Android version (API Level) from 21 to 23.
-
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
getSystemMemoryManagerfunction. 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
getHttpCacheManagerfunction. To obtain an object for managing the HTTP cache, use the HttpCacheManager.get() method. - Removed the
getLocaleManagerfunction. 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
getAudioSettingsfunction. To obtain an object for managing application sound, use the AudioSettings.get() method. - Removed the
getPackageManagerfunction. To obtain an object for managing packages, use the PackageManager.instance() method. - Removed the
getTerritoryManagerfunction. To obtain an object for managing territories, use the TerritoryManager.instance() method. - Removed the
getTerritoriesAlongRouteProviderfunction. To obtain an object for extracting a list of territories along a route, use the TerritoriesAlongRouteProvider constructor. - Removed the
getVoiceManagerfunction. To obtain an object for managing voice packages, use the VoiceManager.instance() method.
- Removed the
-
Removed the
EventsProcessingSettingsclass. -
Renamed the
Gestureobject to TransformGesture. -
Renamed the
ScalingSettingsobject to ScalingRecognizeSettings. -
Renamed the
RotationSettingsobject to RotationRecognizeSettings. -
Renamed the
MultiTouchShiftSettingsobject to MultiTouchRecognizeSettings. -
Renamed the
TiltSettingsobject 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.mappackage. -
Moved the ScreenDistance class from the
ru.dgis.sdk.mappackage. -
Moved the ScreenPoint class from the
ru.dgis.sdk.mappackage. -
Moved the ScreenShift class from the
ru.dgis.sdk.mappackage. -
Removed the
buildingLevelsproperty 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?toColor?. -
The SearchQueryBuilder.setGeoPoint() method now accepts an optional value type.
-
The SearchQueryBuilder.setRadius() method now accepts an optional value type.
-
Removed the
getRoadMacroGraphfunction and theRoadMacroGraphclass. 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 (
LanesCalloutMapPositionandRouteMapObject.lanesCalloutPositions) and the property from the RouteMapObject. -
Renamed the
UIntRouteLongAttributeclass to DoubleRouteLongAttribute. -
Changed the type of the Route.trafficLights property from VoidRouteAttribute to StringRouteAttribute.
-
Added a new transport type
MOTORCYCLEto TransportType. -
Added parameters for configuring the style zoom level to the SpeedRangeToStyleZoom constructor.
-
Added the
RAMP_DOWN,RAMP_UP,SMOOTH_RAMP_DOWN, andSMOOTH_RAMP_UPvalues for ramps to RoadSubtype. -
Added new values of positions and landmarks to CarInstructionCrossroadLandmark.
-
Added the
DEEP_GREENandORANGEcolor values to TrafficSpeedColor. -
Added the
CROSSINGflag for displaying the start and end of a crossing on a route to RouteMapObjectDisplayFlag. -
Added the
CROSSINGnew type of a route point (the start and end of a crossing) to RoutePointKind. -
Added values for event notifications
BETTER_ROUTE("better route") andHUMPS(speed bumps) to SoundCategory.
🛠 Bug fixes
-
Fixed an issue that caused the application crash when running SearchManager.createSmartManager() if there were no downloaded territories.
-
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.
🗺 Map style updates
- Styles must be exported again: fixed issues with displaying custom and immersive objects.
- Updated all layers in the
Roadsgroup for displaying immersive roads in the main map mode. - Added the
Traffic v13.0.0group for displaying new colors of tiles with traffic jams. - Added the
Car route line v13.0.0group for displaying car routes on immersive roads.