Mapbox Maps Android Changelog File — Mapbox

Changelog for Mapbox Maps SDK for Android

Mapbox welcomes participation and contributions from everyone.

16 KB Page Size Support: Starting with version 11.7.0 and 10.19.0, NDK 27 is supported with dedicated artifacts that include support for 16 KB page sizes. If your app does not require 16 KB page size support, you can keep using our default artifacts without -ndk27 suffix. For more information about our NDK support, see https://docs.mapbox.com/android/maps/guides/#ndk-support

main

Features ✨ and improvements 🏁

[compose] Add coordinate conversion APIs to MapState: coordinateForPixel, pixelsForCoordinates, coordinatesForPixels, coordinateInfoForPixel, and coordinatesInfoForPixels. Add experimental tileCover to MapViewportState.
Clarify the documentation of RasterLayer.rasterColor, rasterColorMix, and rasterColorRange.
[compose] Add companion object MapState.clearData() suspend function to clear temporary map data shared across maps using the same data pat.
[compose] Add experimental GesturesState with per-gesture listeners via GestureInput composable. Provides detectMoveGestures, detectScaleGestures, detectRotateGestures, detectShoveGestures, and detectFlingGesture suspend functions. GesturesState can be created standalone via rememberGesturesState() and assigned to MapState.gesturesState. Exposes isGestureInProgress() and isUserAnimationInProgress() methods. Gesture settings are now accessed through MapState.gesturesState.gesturesSettings; the old MapState.gesturesSettings property is deprecated.
Promote SymbolLayer.symbolZOffset to stable.
Accept an object as config option value.
Accept an expression as distance expression argument.

Bug fixes 🐞

Fix a NullPointerException crash in location puck animators when AnimationThreadController.useBackgroundThread() is enabled.
Fix logcat spam from repeated EGL surface create failures when an Android Auto BufferQueue is abandoned. GLMapboxRenderThread now throttles the retry warning log.
Fix a permanently black map after an eglSwapBuffers error. EGLCore no longer skips eglMakeCurrent when a different EGL surface is requested while the context is already current.

Dependencies

Update Mapbox GeoJSON library to v7.10.1.

11.28.0 August 06, 2026

Features ✨ and improvements 🏁

Introduce LineLayer.lineBorderGradient API to color the border of a line feature with a gradient along its length. Takes precedence over lineBorderColor and requires lineBorderWidth to be greater than zero.
Expose line-border-width and line-border-color as public paint properties. They were previously hidden from the style specification.
Expand the valid field-of-view range from [11, 90] to [1, 90] degrees, allowing much narrower camera FOVs.

Bug fixes 🐞

Fix view annotations rendering incorrectly or not appearing when the host app's layout direction is RTL.
Validate URL scheme in AttributionParser to reject non-http(s) attribution URLs at parse time, preventing malicious style/tile-source attributions from reaching custom attribution consumers via the public API.
Fix 3D models with a zero vertex alpha channel being rendered fully black.
Fix double rotation of the FF5C (fullwidth vertical line) character in vertical text.
Fix tile pack patch application failing when disk space runs out mid-write; the disk quota is now checked and eviction triggered before the patch is applied.
Internal fixes and performance improvements.

Dependencies

Update gl-native to v11.28.0, common to v24.28.0.

11.28.0-rc.1 July 27, 2026

Features ✨ and improvements 🏁

Introduce LineLayer.lineBorderGradient API to color the border of a line feature with a gradient along its length. Takes precedence over lineBorderColor and requires lineBorderWidth to be greater than zero.
Expose line-border-width and line-border-color as public paint properties. They were previously hidden from the style specification.
Expand the valid field-of-view range from [11, 90] to [1, 90] degrees, allowing much narrower camera FOVs.

Bug fixes 🐞

Fix 3D models with a zero vertex alpha channel being rendered fully black.
Fix double rotation of the FF5C (fullwidth vertical line) character in vertical text.
Fix tile pack patch application failing when disk space runs out mid-write; the disk quota is now checked and eviction triggered before the patch is applied.
Internal fixes and performance improvements.

Dependencies

Update gl-native to v11.28.0-rc.1, common to v24.28.0-rc.1.

11.27.0 July 24, 2026

Features ✨ and improvements 🏁

Add cross-source HD road elevation for symbols, so road symbols can align to HD elevation data provided by a separate source.
Add support for animating the map's vertical field of view.
Improve CPU performance when frequently updating layer properties, such as animating paint and layout values.
Improve character rotation for some CJK characters in vertical text mode.

Bug fixes 🐞

[gestures] Fix map snapping back after a pinch-to-zoom-in gesture.
Fix incorrect placement of Dynamic View Annotations during fast zooming and near tile boundaries when avoid-layers are configured.
Fix skipped draws (missing geometry on some frames) that could occur while zooming or with shadow-casting layers.
Fix character rotation for some CJK characters in vertical text rendering mode.
Fix fling animation moving the camera in the opposite direction of the swipe at low zoom levels.
Fix flickering single-pixel gaps appearing along route lines at elevation feature boundaries as the camera moves.
Fix line-aligned labels (such as angled sea names) drifting while panning during the globe-to-mercator zoom transition.
Fix radial gradients rendering incorrectly when the focal radius is larger than the outer radius.
Fix view annotations not being considered in collision checks against avoid layers, which could result in incorrect placement.
Internal fixes and performance improvements.

Dependencies

Update gl-native to v11.27.0, common to v24.27.0.
Expand the minimum camera field of view from 11 to 1 degrees.
[compose] Fix root style properties (RainState, SnowState, AtmosphereState, TerrainState) not reverting to the loaded style's own value when disabled or removed. Previously the property was either nulled out entirely or left with a stale value; it now resets to what the style shipped, matching iOS behavior.

11.27.0-rc.1 July 13, 2026

Features ✨ and improvements 🏁

Add cross-source HD road elevation for symbols, so road symbols can align to HD elevation data provided by a separate source.
Add support for animating the map's vertical field of view.
Improve CPU performance when frequently updating layer properties, such as animating paint and layout values.
Improve character rotation for some CJK characters in vertical text mode.

Bug fixes 🐞

Fix flickering single-pixel gaps appearing along route lines at elevation feature boundaries as the camera moves.
Fix line-aligned labels (such as angled sea names) drifting while panning during the globe-to-mercator zoom transition.
Fix radial gradients rendering incorrectly when the focal radius is larger than the outer radius.
Fix view annotations not being considered in collision checks against avoid layers, which could result in incorrect placement.
Internal fixes and performance improvements.

Dependencies

Update gl-native to v11.27.0-rc.1, common to v24.27.0-rc.1.

11.26.0 July 09, 2026

Breaking changes ⚠️

Add CameraAnimatorType.VERTICAL_FOV enum constant. This is a source-breaking change for code that uses an exhaustive when over CameraAnimatorType without an else branch, which will no longer compile until the new case is handled.

Features ✨ and improvements 🏁

Animate verticalFov along with other camera parameters.
Introduce new experimental ViewAnnotationManager.viewAnnotationAvoidRegions which allows to specify rectangular screen regions that view annotations should avoid. View annotations opt in to this behaviour via the new experimental ViewAnnotationOptions.enableAvoidRegions option.
Improve landmark route cutout rendering to use uniform opacity fade instead of per-fragment dithering, improving visual quality and performance in navigation scenes with 3D landmarks.

Bug fixes 🐞

Fix a crash that could occur when querying rendered features while map layers were being removed.
Fix a one-frame flash where layers could briefly disappear while a new shader variant compiled asynchronously.
Fix continuous tile reparsing for HD road sources using cross-source elevation on a static map, causing sustained CPU usage.
Fix elevated lines with line-elevation-reference: "ground" disappearing from view due to incorrect frustum culling over terrain.
Fix gaps appearing in elevated route line geometry at elevation feature boundaries.
Internal fixes and performance improvements.

Dependencies

Update gl-native to v11.26.0, common to v24.26.0.

Bug fixes 🐞

[plugin-indoorselector] Fix scroll position not scrolling to the selected floor when switching to a different building.

11.26.0-rc.1 June 29, 2026

Features ✨ and improvements 🏁

[compose] Introduce experimental IndoorSelector composable function available inside MapboxMap, displaying a scrollable floor-selection widget that appears automatically when an indoor building is in view. Exposes IndoorSelectorState for programmatic access to the current floor list and selected floor, and an onFloorClicked callback for reacting to user selections.
[compose] Add IndoorSelectorControl headless composable inside MapIndoorSelectorScope: attaches the indoor plugin to an IndoorSelectorState without rendering any UI, enabling custom floor-selector implementations.
[compose] Add rotateBy, moveBy, pitchBy, and scaleBy methods to MapViewportState for incremental camera animations.
[compose] Add rememberStyleImage(imageId, image9Patch: NinePatchImage) and remember9PatchStyleImage(imageId, bitmap: Bitmap) overloads for nine-patch images.
Introduce new experimental ViewAnnotationOptions.enableSymbolLayerCollision option which allows view annotations to hide underlying map symbols to avoid visual clutter. By default, the full bounding box of the view annotation is used for collision detection. If your annotation has a non-rectangular shape, it is highly recommended to mark the specific subviews that should participate via the new experimental View.mbxViewAnnotationCollisionBox flag.
Support drawing view annotation collision boxes when MapView.debugOptions is set to COLLISION.
Add TileStore option to configure the ambient cache quota, allowing control over how much disk space is used for ambient cached tile data.
Animate verticalFov along with other camera parameters.

Bug fixes 🐞

[compose] Pass the identifier as an input to rememberSaveable in remember*SourceState, remember*LightState, and rememberTerrainState functions so that changing the identifier correctly recreates the saved state.
Fix labels missing on some road segments due to multilinestring geometry parts being dropped during label merging.
Fix View Annotations sometimes failing to appear on short line segments due to collision detection over-rejection.
Fix worldview filter not applying correctly after being changed at runtime.
Fix zoom interpolation expressions not working correctly when symbol layer appearances define different zoom stops for the same property.
Fix icon cross-fade animation not rendering correctly for icons redefined across appearances.
Fix symbols with elevation or z-offset not displaying when the map is both rotated and pitched.
Fix inaccurate coordinate conversion when querying geographic coordinates over terrain.
Fix SecurityException crash on Android 12 (API 31–32) when the Maps SDK registers location broadcast receivers.
Fix a potential crash caused by a use-after-free when evicting decompressed tile data from memory.
Internal fixes and performance improvements.

Dependencies

Update gl-native to v11.26.0-rc.1, common to v24.26.0-rc.1.

11.21.8 June 25, 2026

Features ✨ and improvements 🏁

Reduce per-frame rendering overhead when style properties are updated frequently.

Bug fixes 🐞

Fix a crash caused by dereferencing a null index buffer when drawing symbols.
Internal fixes and performance improvements.

Dependencies

Update gl-native to v11.21.8, common to v24.21.8.

11.25.2 July 13, 2026

Bug fixes 🐞

Fix a crash that could occur due to filesystem exceptions during persistent storage initialization.

Dependencies

Update gl-native to v11.25.2, common to v24.25.2.

11.25.1 July 03, 2026

Bug fixes 🐞

Fix View Annotations sometimes failing to appear on short line segments due to collision detection over-rejection.
Fix a SecurityException crash on Android 12 (API 31–32) when the Maps SDK registers location broadcast receivers.

Dependencies

Update gl-native to v11.25.1, common to v24.25.1.

11.25.0 June 11, 2026

Breaking changes ⚠️

MapView.setMaximumFps and MapSurface.setMaximumFps are now annotated @MainThread. Callers must invoke them from the main thread; off-main callers will see a lint warning.

Features ✨ and improvements 🏁

[compose] Add Standard IndoorLabels featureset and indoor configuration options (showIndoor, showIndoorLabels, colorIndoorLabelHighlight, colorIndoorLabelSelect) for the Mapbox Standard style.
Add useNativeFlingDeceleration option to GesturesPlugin that uses OverScroller for physics-based fling deceleration instead of the legacy easeTo animation, providing a more natural fling experience.
Throttle MapboxMap post destroyed warning logs.
Expose verticalFov in CameraOptions, allowing a custom vertical field of view to be set in setCamera, easeTo, and flyTo.
Allow using color string literals in interpolate expressions, including when set on style config at runtime.
Support using line-progress in line-emissive-strength.
Add support for zoom-and-feature-dependent appearance conditions.
Add client-side SD/HD road and traffic conflation, hiding redundant roads based on functional road class coverage with stencil-masked transitions and configurable opacity fade.
Add animated cross-fade transitions for boolean style config options (e.g. switching HD roads on/off).
Add an option to disallow expensive network requests in loadStylePack.

Bug fixes 🐞

Fix a ConcurrentModificationException crash that could occur when a plugin was added or removed during MapView.onDestroy.
Fix frame pacing breaking when the panel switches refresh-rate modes mid-session (VRR or per-UID frameRateOverride). FpsManager now updates its screenRefreshRate via a DisplayManager.DisplayListener instead of only sampling once at onStart.
[maps-sdk] Fix Vulkan rendering being permanently disabled when the Android surface arrived before the native map was set. The renderer now defers setup and retries via onMapSet() once the map is available.
Fix a crash that could occur while iterating map interactions when a callback modifies interaction state.
Fix a use-after-free crash in the map caused by asynchronous tasks accessing a partially destroyed map instance.
Fix a crash caused by dereferencing a null index buffer when drawing symbols.
Fix a crash when an overriding terrain source was merged with another source from the same root style.
Fix missing letters in the middle of text labels placed along lines elevated by terrain.
Fix aliasing artifacts on lines with borders.
Fix step expression evaluation when using uniform buffer objects.
Improve symbol appearances performance for Vulkan backend.
Fix rare process crashes during HTTP downloads (failure to create a temporary file, and an uncaught error while writing the response).
Fix a crash sometimes occurring when using a custom raster source.
Internal fixes and performance improvements.

Dependencies

Update gl-native to v11.25.0, common to v24.25.0.

11.25.0-rc.2 June 04, 2026

Bug fixes 🐞

Internal fixes and performance improvements.

Dependencies

Update gl-native to v11.25.0-rc.2, common to v24.25.0-rc.2.

11.25.0-rc.1 June 02, 2026

Breaking changes ⚠️

MapView.setMaximumFps and MapSurface.setMaximumFps are now annotated @MainThread. Callers must invoke them from the main thread; off-main callers will see a lint warning.

Features ✨ and improvements 🏁

[compose] Add Standard IndoorLabels featureset and indoor configuration options (showIndoor, showIndoorLabels, colorIndoorLabelHighlight, colorIndoorLabelSelect) for the Mapbox Standard style.
Add useNativeFlingDeceleration option to GesturesPlugin that uses OverScroller for physics-based fling deceleration instead of the legacy easeTo animation, providing a more natural fling experience.
Throttle MapboxMap post destroyed warning logs.
Expose verticalFov in CameraOptions, allowing a custom vertical field of view to be set in setCamera, easeTo, and flyTo.
Allow using color string literals in interpolate expressions, including when set on style config at runtime.
Support using line-progress in line-emissive-strength.
Add support for zoom-and-feature-dependent appearance conditions.
Add client-side SD/HD road and traffic conflation, hiding redundant roads based on functional road class coverage with stencil-masked transitions and configurable opacity fade.
Add animated cross-fade transitions for boolean style config options (e.g. switching HD roads on/off).
Add an option to disallow expensive network requests in loadStylePack.

Bug fixes 🐞

Fix a ConcurrentModificationException crash that could occur when a plugin was added or removed during MapView.onDestroy.
Fix frame pacing breaking when the panel switches refresh-rate modes mid-session (VRR or per-UID frameRateOverride). FpsManager now updates its screenRefreshRate via a DisplayManager.DisplayListener instead of only sampling once at onStart.
[maps-sdk] Fix Vulkan rendering being permanently disabled when the Android surface arrived before the native map was set. The renderer now defers setup and retries via onMapSet() once the map is available.
Fix a crash that could occur while iterating map interactions when a callback modifies interaction state.
Fix a use-after-free crash in the map caused by asynchronous tasks accessing a partially destroyed map instance.
Fix a crash caused by dereferencing a null index buffer when drawing symbols.
Fix a crash when an overriding terrain source was merged with another source from the same root style.
Fix missing letters in the middle of text labels placed along lines elevated by terrain.
Fix aliasing artifacts on lines with borders.
Fix step expression evaluation when using uniform buffer objects.
Improve symbol appearances performance for Vulkan backend.
Fix rare process crashes during HTTP downloads (failure to create a temporary file, and an uncaught error while writing the response).

Dependencies

Update gl-native to v11.25.0-rc.1, common to v24.25.0-rc.1.

11.21.6 May 25, 2026

Features ✨ and improvements 🏁

Improve anti-aliasing for line layers with line-border-width set.

Bug fixes 🐞

Fix a crash that could occur when the map is destroyed while asynchronous operations are in progress.

Dependencies

Update gl-native to v11.21.6, common to v24.21.6.

11.24.3 May 27, 2026

Dependencies

Update gl-native to v11.24.3, common to v24.24.3.

11.24.2 May 20, 2026

Dependencies

Update gl-native to v11.24.2, common to v24.24.2.

11.24.1 May 19, 2026

Features ✨ and improvements 🏁

Expose FeaturesetFeature.originalFeature property.
Add Vulkan rendering backend support (Public Preview). The Vulkan backend is published as a separate artifact (android-core-vulkan / android-core-vulkan-ndk27) that replaces the default OpenGL-based android-core. To use it, replace the default core dependency with the Vulkan variant. In your build.gradle.kts add:
```
configurations.all {
    resolutionStrategy.dependencySubstitution {
        all {
            val requested = requested as? ModuleComponentSelector
            if (requested?.group == "com.mapbox.maps" &&
                (requested.module == "android-core" || requested.module == "android-core-ndk27")
            ) {
                val vulkanModule = requested.module.replace("android-core", "android-core-vulkan")
                useTarget("com.mapbox.maps:$vulkanModule:${requested.version}")
            }
        }
    }
}
```
Known limitations:
- Android 12 (API 31) or later is recommended. Earlier Android versions may exhibit GPU driver bugs, particularly on devices with Adreno GPUs.
- Only arm64-v8a is supported.
- No automatic fallback to OpenGL.
- MapWidget (Android Auto) is not yet supported.
- Custom layer API is not yet supported.
- MapView.snapshot() is not yet supported.
- Rain precipitation effect is not rendered (snow works).
Add support for rendering landmark models with level-of-detail (LOD), improving performance and memory use for distant 3D landmarks.
Improve additive blend mode rendering on line layers with high data density, and add the line-blend-additive-clamp style property for opting out of dynamic density mapping with a fixed value.
Set a default ambient cache quota of 1 GB and over-evict when the quota is exceeded to reduce eviction churn.
TileStore.create(path) is no longer supported (deprecated since v11.19). Only one TileStore instance per process is now supported.

Bug fixes 🐞

Fix a crash that could occur when the map is destroyed while asynchronous operations are still in progress.
Fix the NetworkRestriction.DISALLOW_EXPENSIVE network option not being respected, which could cause map requests to proceed over metered connections when configured otherwise.
Fix isMetricUnits/distanceUnits sync in ScaleBar settings DSL generated by KSP codegen.
Fix style import config property updates being lost when applied while a concurrent import URL change was loading.
Fix incorrect color output when applying a color LUT to premultiplied colors.
Fix incorrect symbol elevation rendering on Mali GPUs (e.g. Google Pixel 9 Pro XL) caused by insufficient shader precision for large z-offset values.
Fix a crash in the vector tile layer cache when a sibling tile was destroyed during cache reuse.
Internal fixes and performance improvements.

Dependencies

Update gl-native to v11.24.1, common to v24.24.1.

11.24.0 May 18, 2026

This release has documentation issues and should not be used. Please use 11.24.1 instead.

Dependencies

Update gl-native to v11.24.0, common to v24.24.0.

11.21.8 June 25, 2026

Dependencies

Update gl-native to v11.21.8, common to v24.21.8.

11.21.7 June 01, 2026

Dependencies

Update gl-native to v11.21.7, common to v24.21.7.

11.21.6 May 25, 2026

Dependencies

Update gl-native to v11.21.6, common to v24.21.6.

11.21.5 May 15, 2026

Features ✨ and improvements 🏁

Add animated transitions when toggling HD roads.

Bug fixes 🐞

Fix a situation where updated import config properties were ignored after an import URL change.

Dependencies

Update gl-native to v11.21.5, common to v24.21.5.

11.23.1 May 11, 2026

Bug fixes 🐞

Fix the disallow_expensive HTTP setting not being respected on Android; the SDK now binds requests to a non-metered network (e.g., Wi-Fi) when this flag is set, with Cronet on API 23+ and an OkHttp fallback on older API levels.
Fix a memory leak where HttpClient instances could not be garbage collected because callbacks held strong references back to the client.
Internal fixes and performance improvements.

Dependencies

Update gl-native to v11.23.1, common to v24.23.1.

11.22.4 July 03, 2026

Bug fixes 🐞

Fix style import config properties being silently discarded when set during an import URL change.
Fix elevated lines with lineElevationReference set to LineElevationReference.GROUND disappearing near the viewport at high pitch.
Fix a crash that could occur when an HTTP request was aborted while a response chunk was being processed.

Dependencies

Update gl-native to v11.22.4, common to v24.22.4.

11.22.3 May 07, 2026

Features ✨ and improvements 🏁

Internal fixes and performance improvements.

Dependencies

Update gl-native to v11.22.3, common to v24.22.3.

11.24.0-rc.1 May 05, 2026

Features ✨ and improvements 🏁

Expose FeaturesetFeature.originalFeature property.
Add Vulkan rendering backend support (Public Preview). The Vulkan backend is published as a separate artifact (android-core-vulkan / android-core-vulkan-ndk27) that replaces the default OpenGL-based android-core. To use it, replace the default core dependency with the Vulkan variant. In your build.gradle.kts add:
```
configurations.all {
    resolutionStrategy.dependencySubstitution {
        all {
            val requested = requested as? ModuleComponentSelector
            if (requested?.group == "com.mapbox.maps" &&
                (requested.module == "android-core" || requested.module == "android-core-ndk27")
            ) {
                val vulkanModule = requested.module.replace("android-core", "android-core-vulkan")
                useTarget("com.mapbox.maps:$vulkanModule:${requested.version}")
            }
        }
    }
}
```
Known limitations:
- Android 12 (API 31) or later is recommended. Earlier Android versions may exhibit GPU driver bugs, particularly on devices with Adreno GPUs.
- Only arm64-v8a is supported.
- No automatic fallback to OpenGL.
- MapWidget (Android Auto) is not yet supported.
- Custom layer API is not yet supported.
- MapView.snapshot() is not yet supported.
- Rain precipitation effect is not rendered (snow works).
Add support for rendering landmark models with level-of-detail (LOD), improving performance and memory use for distant 3D landmarks.
Improve additive blend mode rendering on line layers with high data density, and add the line-blend-additive-clamp style property for opting out of dynamic density mapping with a fixed value.
Set a default ambient cache quota of 1 GB and over-evict when the quota is exceeded to reduce eviction churn.
TileStore.create(path) is no longer supported (deprecated since v11.19). Only one TileStore instance per process is now supported.

Bug fixes 🐞

Fix isMetricUnits/distanceUnits sync in ScaleBar settings DSL generated by KSP codegen.
Fix style import config property updates being lost when applied while a concurrent import URL change was loading.
Fix incorrect color output when applying a color LUT to premultiplied colors.
Fix incorrect symbol elevation rendering on Mali GPUs (e.g. Google Pixel 9 Pro XL) caused by insufficient shader precision for large z-offset values.
Fix a crash in the vector tile layer cache when a sibling tile was destroyed during cache reuse.
Internal fixes and performance improvements.

Dependencies

Update gl-native to v11.24.0-rc.1, common to v24.24.0-rc.1.

11.21.4 May 05, 2026

Features ✨ and improvements 🏁

Internal fixes and performance improvements.

Dependencies

Update gl-native to v11.21.4, common to v24.21.4.

11.23.0 April 29, 2026

Features ✨ and improvements 🏁

Support symbol paint properties in appearances — symbol layers can now use feature-dependent appearances for paint properties (not only layout), enabling richer per-feature styling of text and icons.
Improve rendering performance of feature cutouts — optimized depth sampling in the cutout shader yields noticeably smoother rendering when feature cutouts are enabled (e.g. elevated route with cutouts).
TileStore can now store 3D landmark/navigation tile content types, unblocking their use in offline regions.
Add support for USB import radius in TileStore — new import parameter for seeding offline tile packs from USB media within a configurable radius.
Evict tiles based on LRU and optimize eviction — the default eviction policy now uses least-recently-used instead of expiration-based scoring, keeping frequently-viewed tiles around longer and making cleanup passes faster.
Settings can be set on startup — the SDK now loads persistent_settings.json and non_persistent_settings.json from the app's internal storage directory at startup, allowing configuration changes without an app rebuild.

Bug fixes 🐞

Fix attribution links accepting non-HTTP URI schemes.
Fix a potential file descriptor leak that could cause resource exhaustion.
Fix icons appearing at incorrect size when icon-size is data-driven and a non-default scale factor is applied.
Fix fog incorrectly obscuring the globe when using a custom field of view.
Fix tile data corruption causing integrity check failures for small tiles stored in the offline cache.
Fix a crash that could occur when the tile store is destroyed while downloads are still being processed.
Fix 3D models occasionally not rendering on first load on some devices, caused by background shader compilation not signaling the renderer when compilation completed.
Fix a crash in ConfigExpression where dereferencing an empty optional caused undefined behaviour.
[compose] Fixed Composition leak in ViewAnnotation when annotations are removed from the map.
[gestures] Fixed interaction leak in setGesturesManager causing native map interactions to accumulate.
[gestures] Added post-cleanup guard to prevent re-registering interactions or listeners after plugin cleanup.

Dependencies

Update gl-native to v11.23.0, common to v24.23.0.

11.22.1 April 28, 2026

Bug fixes 🐞

[gestures] Fixed interaction leak in setGesturesManager causing native map interactions to accumulate.
[gestures] Added post-cleanup guard to prevent re-registering interactions or listeners after plugin cleanup.

Dependencies

Update gl-native to v11.22.1, common to v24.22.1.

11.21.3 April 23, 2026

Bug fixes 🐞

Fix above-ground route line not rendering over tunnel geometry when cutout is active.
Fix rendering artifacts on feature cutout geometries caused by incorrect shader clipping.
Fix a potential crash in style configuration expression evaluation when a config value is unset.

Dependencies

Update gl-native to v11.21.3, common to v24.21.3.

11.23.0-rc.1 April 20, 2026

Bug fixes 🐞

Fix attribution links accepting non-HTTP URI schemes.
Fix a potential file descriptor leak that could cause resource exhaustion.
[compose] Fixed Composition leak in ViewAnnotation when annotations are removed from the map.
[compose] Fix Fragment lifecycle observer leak in ViewAnnotation on annotation removal.

Dependencies

Update gl-native to v11.23.0-rc.1, common to v24.23.0-rc.1.

11.22.0 April 16, 2026

Features ✨ and improvements 🏁

Expose height and minHeight properties on StandardBuildingsFeature.
Deprecate PointAnnotation.iconImage getter. Reading this property exposes an internally generated image ID managed by the annotation manager. If you need a stable, reusable image ID, register the image in the style yourself via the Style API and pass the ID explicitly via PointAnnotationOptions.withIconImage(String). In that case you are responsible for the image's lifecycle and must remove it from the style when no longer needed.
Internal fixes and performance improvements.

Bug fixes 🐞

Fix native memory leak in AnnotationManager where bitmap style images were not removed when annotations were deleted.
Fix feature ID format mismatch in JNI marshaling where whole-number double feature IDs (e.g. 12345.0) were incorrectly serialized as "12345.000000" instead of "12345", causing setFeatureState to fail when using IDs obtained from queryRenderedFeatures.
[compose] Fix MapboxMap crash (place is called on a deactivated node) when used inside a LazyColumn.
- [compose] Known limitation: on Compose Foundation 1.7+ a secondary crash (Apply is called on deactivated node) may still occur when MapboxMap is used inside a LazyColumn during fast scrolling/item reuse because of LazyColumn prefetch behavior. Workaround: pass a no-op LazyListPrefetchStrategy to rememberLazyListState(); see LazyColumnMapActivity for an example.
Fix location indicator cutout appearing in the wrong position on devices with high pixel density.
Fix lines with sub-pixel width being rendered thicker than intended.
Fix tile data decompression by properly tracking compression state in tile storage.
Fix potential ANR caused by a deadlock in lifecycle management.
Fix tile store cleanup task incorrectly deleting in-progress downloads.
Fix tiles failing to load on some Android devices when the server response is incomplete.
Fix tunnel roads being clipped or missing near the top of the screen at high pitch angles when crossing tile boundaries.
Fix stretchable icons used with icon-text-fit disappearing in some situations.
Fix dashed lines not rendering correctly when line-dasharray values are smaller than 1.

Dependencies

Update gl-native to v11.22.0, common to v24.22.0.

11.21.2 April 16, 2026

Features ✨ and improvements 🏁

Improve rendering performance of feature cutouts

Bug fixes 🐞

Fix tile cover issues for tunnels

Dependencies

Update gl-native to v11.21.2, common to v24.21.2.

11.20.3 April 14, 2026

Bug fixes 🐞

Fix tile data decompression by properly tracking compression state in tile storage.

Dependencies

Update gl-native to v11.20.3, common to v24.20.3.

11.21.1 April 10, 2026

Features ✨ and improvements 🏁

Deprecate PointAnnotation.iconImage getter. Reading this property exposes an internally generated image ID managed by the annotation manager. If you need a stable, reusable image ID, register the image in the style yourself via the Style API and pass the ID explicitly via PointAnnotationOptions.withIconImage(String). In that case you are responsible for the image's lifecycle and must remove it from the style when no longer needed.

Bug fixes 🐞

Fix native memory leak in AnnotationManager where bitmap style images were not removed when annotations were deleted.
Fix an issue where overscaled tiles from offline tile packs could delay fetching higher-resolution network tiles.

configurations.all { resolutionStrategy.dependencySubstitution { all { val requested = requested as? ModuleComponentSelector if (requested?.group == "com.mapbox.maps" && (requested.module == "android-core" || requested.module == "android-core-ndk27") ) { val vulkanModule = requested.module.replace("android-core", "android-core-vulkan") useTarget("com.mapbox.maps:$vulkanModule:${requested.version}") } } } }