v11.22.1

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.

v11.21.3

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.

v11.23.0-rc.1

11.23.0-rc.1 April 20, 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.

Dependencies

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

v11.22.0

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.

v11.21.2

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.

v11.20.3

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.

v11.21.1

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.

Dependencies

• Update gl-native to v11.21.1, common to v24.21.1.

v11.19.6

Bug fixes 🐞

• Internal fixes and performance improvements.

Dependencies

• Update gl-native to v11.19.6, common to v24.19.6.

v11.22.0-rc.1

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.

Dependencies

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

v11.19.5

Bug fixes 🐞

• Internal fixes and performance improvements.

Dependencies

• Update gl-native to v11.19.5, common to v24.19.5.