v2.20.0

New Features ✨

• Add experimental shadowDrawBeforeLayer property to directional light to allow specifying the position in the layer stack for drawing shadows on the ground.
• Introduce new LineLayer.lineElevationGroundScale property to scale elevated lines with terrain exaggeration.
• Promote elevated lines properties to stable: LineLayer.lineZOffset and LineLayer.lineElevationReference.
• Add experimental ModelLayer.modelAllowDensityReduction property to disable density reduction in model layers.
• Add FollowPuckViewportState.padding to control camera padding when following the user's location puck, allowing the puck to be offset from the viewport center (e.g. for navigation UIs where the puck should appear near the bottom of the screen).

Bug fixes 🐞

• Map ornaments positioning
  Fix incorrect positioning of map ornaments when multiple ornaments are placed in the same corner.

Dependency Updates

• Update Mapbox Maps SDK to v11.20.0
  • For platform-specific updates see: iOS & Android

v2.20.0-rc.1

New Features ✨

• Add experimental shadowDrawBeforeLayer property to directional light to allow specifying the position in the layer stack for drawing shadows on the ground.
• Introduce new LineLayer.lineElevationGroundScale property to scale elevated lines with terrain exaggeration.
• Promote elevated lines properties to stable: LineLayer.lineZOffset and LineLayer.lineElevationReference.
• Add experimental ModelLayer.modelAllowDensityReduction property to disable density reduction in model layers.
• Add FollowPuckViewportState.padding to control camera padding when following the user's location puck, allowing the puck to be offset from the viewport center (e.g. for navigation UIs where the puck should appear near the bottom of the screen).

Dependency Updates

• Update Mapbox Maps SDK to v11.20.0-rc.1
  • For platform-specific updates see: iOS & Android

v2.19.1

Bug fixes 🐞

• [Android] Fix Gradle build failure when SDK_REGISTRY_TOKEN is not set in the environment or gradle.properties.
• [Android] Fix customData not being applied when updating Circle, Point, Polygon, and Polyline annotations.

v2.19.0

Note

Android builds may fail with a SDK_REGISTRY_TOKEN property error. Please upgrade to 2.19.1.

Dependency Updates

• Update Mapbox Maps SDK to v11.19.0
  • For platform-specific updates see: iOS & Android

v2.19.0-rc.1

Dependency Updates

• Update Mapbox Maps SDK to v11.19.0-rc.1
  • For platform-specific updates see: iOS & Android

v2.19.0-beta.1

Dependency Updates

• Update Mapbox Maps SDK to v11.19.0-beta.1
  • For platform-specific updates see: iOS & Android

v2.18.0

New Features ✨

• Add deleteMulti() method to all annotation managers to enable batch deletion of annotations.
• Add experimental MapRecorder API to record and replay map interactions for debugging and performance testing.
  • Thanks for the contribution, @protheeuz!

Dependency Updates

• Update Mapbox Maps SDK to v11.18.0
  • For platform-specific updates see: iOS & Android

v2.18.0-beta.1

Important

Known Issue - Android Memory Usage: This beta release contains a memory usage issue on Android that may cause increased memory consumption during map usage sessions. This issue will be addressed in the upcoming stable release.

New Features ✨

• deleteMulti() method: All annotation managers now support efficient batch deletion of multiple annotations, improving performance when removing large numbers of annotations at once.
• Record and replay map interactions: New experimental API for capturing map interactions, animations, and user gestures for debugging and performance testing purposes.

Dependency Updates

• Update Mapbox Maps SDK to v11.18.0-beta.1
  • For platform-specific updates see: iOS & Android

v2.17.0

Note

Version numbering has been updated to align with Mapbox's cross-platform SDK versioning scheme. We skipped from 2.12.0 to 2.17.0 to synchronize with other Mapbox SDKs, ensuring consistent version numbers across all platforms.

New Features ✨

• Promote ModelLayer to stable.
• Add SymbolLayer.iconColorBrightnessMax, SymbolLayer.iconColorBrightnessMin, SymbolLayer.iconColorContrast, SymbolLayer.occlusionOpacityMode, FillExtrusionLayer.fillExtrusionCastShadows, RasterArraySource.volatile, and PolylineAnnotation.lineEmissiveStrength properties.
• Update default value for experimental LineLayer.lineCutoutOpacity from 0 to 1.0.
• Add the ability to get all annotations from an annotation manager.
• Add customData field to annotations to be able to pass user data.
• Add nautical miles scale bar distance unit.
• Update property type for experimental LineLayer.lineCutoutOpacity, and LineLayer.lineCutoutFadeWidth from layout to paint.

Bug fixes 🐞

• [iOS] Fix annotation interaction handlers (tap, drag etc.) not working after annotation update.
• [Android] Fix memory leaks on Android.

Dependency Updates

• Bump Flutter SDK minimum required version to 3.27.0 and compileSdk to 35 on Android.
• Update Mapbox Maps SDK to v11.17.0
  • For platform-specific updates see: iOS & Android

v2.17.0-rc.1

Note

Version numbering has been updated to align with Mapbox's cross-platform SDK versioning scheme. We skipped from 2.12.0 to 2.17.0-beta.1 to synchronize with other Mapbox SDKs, ensuring consistent version numbers across all platforms.

New Features ✨

• Add the ability to get all annotations from an annotation manager.
• Add customData field to annotations to be able to pass user data.
• Add nautical miles scale bar distance unit.
• Update property type for experimental LineLayer.lineCutoutOpacity, LineLayer.lineCutoutWidth, and LineLayer.lineCutoutFadeWidth from layout to paint.

Bug fixes 🐞

• [iOS] Fix annotation interaction handlers (tap, drag etc.) not working after annotation update.

Dependency Updates

• Update Mapbox Maps SDK to v11.17.0-rc.1
  • For platform-specific updates see: iOS & Android