v11.19.0-beta.1

Features ✨ and improvements 🏁

• Introduce experimental queryRenderedRasterValues API for querying the rendered raster array value at a point on the map.
• Introduce new AnnotationConfig#slotName property to allow to specify a slot to position annotation layer.
• Introduce experimental queryRenderedRasterValues API for querying the rendered raster values on the map at a specific screen coordinate.
• Deprecate Tilestore.create(path: String) instead use TileStore.setRootPath().

Bug fixes 🐞

• Fix rare scenario where map render surface size was wrong.
• Respect animationDurationMs when custom OverviewViewportStateOptions.animationDurationMs is set.
• Fix point View Annotation flickering and hiding on moving anchor out of screen.

Dependencies

• Update gl-native to v11.19.0-beta.1, common to v24.19.0-beta.1.

v11.18.0

Important

A bug in the SDK's offline data management causes untracked data to accumulate instead of being removed under specific conditions. This leads to uncontrolled storage growth, potentially degrading system performance or causing complete unusability if disk space is exhausted.
The required version for upgrade is 11.18.3, 11.19.2, 11.20.2 or any version from 11.21.0 onward.
This specific bug is only relevant to users who use tilestore offline regions.

Breaking changes ⚠️

• Remove line-cutout-width and change line-cutout-opacity default to 1.0

Features ✨ and improvements 🏁

• Add ModelLayer.modelAllowDensityReduction property to disable density reduction in model layers.
• Add Standard Style color and 3D configuration options: colorBuildings, colorCommercial, colorEducation, colorIndustrial, colorLand, colorMedical, show3dBuildings, show3dFacades, show3dLandmarks, and show3dTrees.
• Introduce experimental AttributionControl composable function that exposes AttributionState programmatically, enabling developers to build custom Attribution UI outside of the map while maintaining compliance with Mapbox ToS requirements.
• Introduce experimental indoor floor selector plugin. The plugin is not included in the default plugin list and must be explicitly added to MapInitOptions.plugins. It requires a style with indoor data and special access to indoor mapping features. To request more information, please use this form.
• Add experimental shadowDrawBeforeLayer property to directional light to allow specifying the position in the layer stack for drawing shadows on the ground.
• [tile_store] Add TileStore.setRootPath() method to set tilestore path to be used by default.
• Faster polygon triangulation for complex polygons.
• Improved handling of occluded symbols with text-occlusion-opacity and icon-occlusion-opacity properties.
• General fixes and performance improvements.

Bug fixes 🐞

• Fix userData payload for onSourceDataLoaded event during GeoJSON partial update.
• Fix guard rail placement.
• Fix changes in brightness not always getting applied.
• Fix leaking Vertex Array Objects.
• Reset style fog, snow and rain impl when switching to a new style.
• Fix rendering artefacts when persistent buffer mapping is enabled.
• Fix Coercion expression possibleOutputs result for Array type.
• Fix a crash when jumping between different projections.
• Fixes for placements with icon-optional, text-optional, and missing parts.

Dependencies

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

v11.18.0-beta.1

11.18.0-beta.1 December 17, 2025

Breaking changes ⚠️

• Remove line-cutout-width and change line-cutout-opacity default to 1.0

Features ✨ and improvements 🏁

• Add ModelLayer.modelAllowDensityReduction property to disable density reduction in model layers.
• Add Standard Style color and 3D configuration options: colorBuildings, colorCommercial, colorEducation, colorIndustrial, colorLand, colorMedical, show3dBuildings, show3dFacades, show3dLandmarks, and show3dTrees.
• Introduce experimental AttributionControl composable function that exposes AttributionState programmatically, enabling developers to build custom Attribution UI outside of the map while maintaining compliance with Mapbox ToS requirements.
• Introduce experimental indoor floor selector plugin. The plugin is disabled by default and requires a style with indoor data and special access to indoor mapping features.
• Add experimental shadowDrawBeforeLayer property to directional light to allow specifying the position in the layer stack for drawing shadows on the ground.
• [tile_store] Add method to set tilestore path to be used by default.
• Faster polygon triangulation for complex polygons.
• General fixes and performance improvements.

Bug fixes 🐞

• Fix userData payload for onSourceDataLoaded event during GeoJSON partial update.
• Fix guard rail placement.
• Fix changes in brightness not always getting applied.
• Fix leaking Vertex Array Objects.
• Reset style fog, snow and rain impl when switching to a new style.
• Fix rendering artefacts when persistent buffer mapping is enabled.
• Fix Coercion expression possibleOutputs result for Array type.
• Fix a crash when jumping between different projections.

Dependencies

• Update gl-native to v11.18.0-beta.1, common to v24.18.0-beta.1.

v11.17.1

11.17.1 December 11, 2025

Bug fixes 🐞

• Reset style fog, snow and rain impl when switching to a new style.
• Fix changes in brightness not always getting applied.
• Fix occlusion of location indicator in tunnels.
• Fix leaking Vertex Array Objects.

Dependencies

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

v11.17.0

Breaking changes ⚠️

• Require passing required argument to the constructor of experimental GeofencingState.Builder, GeofencingError.Builder, GeofencingEvent.Builder and GeofencingOptions.Builder APIs.

Features ✨ and improvements 🏁

• Promote Geofencing APIs to stable, remove MapboxExperimental annotations from Geofencing APIs.
• Add TileStore improvements and optimizations.
• Promote ModelLayer to stable.
• Add SymbolLayer.occlusionOpacityMode, SymbolLayer.iconColorBrightnessMax, SymbolLayer.iconColorBrightnessMin, SymbolLayer.iconColorContrast properties.
• Add FillExtrusionLayer.castShadows property.
• Add GeoJsonSource.minZoom property.
• Add RasterArraySource.volatile experimental property.
• Make line-emissive-strength property data-driven.
• Add experimental MapboxMap.setFeatureStateExpression(), removeFeatureStateExpression(), and resetFeatureStateExpressions() APIs to efficiently update feature state for multiple features at once using expressions.
• Improved error reporting for offline tile region downloads on Android.
• Enhanced reliability of network connections by improving how Cronet timeouts are handled.
• Added experimental MapOptions.Builder.scaleFactor() for scaling icons and texts.
• Add click gesture support to Marker composable with onClick parameter
• Introduced ScaleBarSettings.distanceUnits property supporting metric, imperial, and nautical units, replacing the boolean isMetricUnits property.
• Added fuelingStationModePointOfInterestLabels configuration option to Mapbox Standard and Standard Satellite styles. Control the visibility of fuel station and electric charging station POI labels with options: "default" (shows both), "fuel" (fuel stations only), "electric" (charging stations only), or "none" (hides both).
• Introduce experimental support for Appearances. The Appearances layer property defines sets of appearance objects used to quickly change the visual styling of a layer based on a condition using feature-state. See AppearancesActivity in example application for further details.
• Memory allocation improvements

Bug fixes 🐞

• Fix config expression evaluation to properly check dependencies in nested value expressions.
• Fix issue with shadows showing up on top of tunnel roads.
• Fix view-aligned symbols with road elevation being cutout.
• Fix camera listener not unsubscribed when disabling ScaleBar via updateSettings { enabled = false }
• Fixed a crash when switching map styles quickly.
• Fixed a threading bug to eliminate 3D rendering issues and instability.
• Internal fixes and performance improvements.
• Fix multiple crashes during style switches related to terrain rendering, texture management, and image cleanup.
• Fix line patterns not elevating properly on HD roads.
• Fix rendering of TileStore tiles when TileStore is used as disk cache and user is offline.
• Fix performance regression for distance and within expressions when processing large GeoJSON datasets.
• Fix GeoJSON tiled model disappearance during fast zoom interactions.
• Fix rendering issues when switching between globe and mercator projections.
• Logging improvements to reduce noise and duplication.

v11.17.0-rc.3

Features ✨ and improvements 🏁

• Promote Geofencing APIs to stable, remove MapboxExperimental annotations from Geofencing APIs.

Dependencies

• Update gl-native to v11.17.0-rc.3, common to v24.17.0-rc.3.

v11.17.0-rc.2

Bug fixes 🐞

• Internal fixes and performance improvements.

Dependencies

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

v11.16.6

Bug fixes 🐞

• Internal fixes and performance improvements.

Dependencies

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

v11.17.0-rc.1

Features ✨ and improvements 🏁

• Promote ModelLayer to stable.
• Add SymbolLayer.occlusionOpacityMode, SymbolLayer.iconColorBrightnessMax, SymbolLayer.iconColorBrightnessMin, SymbolLayer.iconColorContrast properties.
• Add FillExtrusionLayer.castShadows property.
• Add GeoJsonSource.minZoom property.
• Add RasterArraySource.volatile experimental property.
• line-emissive-strength property is now data-driven, allowing different road types to be rendered in a single layer for improved performance
• Add experimental MapboxMap.setFeatureStateExpression(), removeFeatureStateExpression(), and resetFeatureStateExpressions() APIs to efficiently update feature state for multiple features at once using expressions.

Bug fixes 🐞

• Fix camera listener not unsubscribed when disabling ScaleBar via updateSettings { enabled = false }
• Fixed config expression evaluation to properly check dependencies in nested value expressions
• Reset style lights when switching to a new style
• Optimized shadow rendering by limiting extra tile requests to zoom levels 16 and above, improving performance at zoom 15
• Optimized fill-extrusion rendering at zoom 17-22 by preventing bucket overscaling, significantly reducing tile cache evictions and CPU overhead

Dependencies

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

v11.17.0-beta.2

Features ✨ and improvements 🏁

• Improved error reporting for offline tile region downloads on Android.
• Enhanced reliability of network connections by improving how Cronet timeouts are handled.

Bug fixes 🐞

• Fixed a crash when switching map styles quickly.
• Fixed a threading bug to eliminate 3D rendering issues and instability.
• Internal fixes and performance improvements.

Dependencies

• Update gl-native to v11.17.0-beta.2, common to v24.17.0-beta.2.