v11.19.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.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.

Features ✨ and improvements 🏁

• Raster Value Query API (Experimental) Added queryRenderedRasterValues API that allows querying the rendered value(s) of any raster array layer at a given screen coordinate. Returns pixel data for all bands, enabling use cases such as displaying weather data values, elevation readouts, or other raster-based information directly from the rendered map. (@Nelarius, @maios)
• Offline Tile TTL Header Support Added support for the x-mapbox-offline-ttl HTTP header. When present, this header controls how long a cached tile remains valid for offline use, behaving as if expiry = now() + x-mapbox-offline-ttl with must-revalidate = true. This provides server-side control over offline tile freshness. (@Nelarius)
• Text Scale Factor for Inline Images (Experimental) Images embedded within text-field using the image expression now properly scale according to the text scale factor setting, ensuring consistent sizing between text and inline images. (@woodroof)
• Mixed Slot Order Support Improved handling of slot ordering in style imports. Slots can now be interleaved in any order, allowing more flexible layer arrangements when composing styles from multiple imports. Note: duplicate slot names within a style are no longer supported and will trigger a warning. (@woodroof)
• Elevated Line Ground Scale Introduced new lineElevationGroundScale property to scale elevated lines with terrain exaggeration. (@lasselammi)
• Elevated Line Stable APIs Promoted elevated line properties to stable: lineZOffset and lineElevationReference. (@lasselammi)
• Symbol Scale Behavior (Experimental) Introduced experimental SymbolScaleBehavior API to automatically scale map symbols (icons and text) based on system accessibility text size settings. Set symbolScaleBehavior to configure: .system (automatic scaling), .system(mapping:) (custom mapping function), or .fixed(scaleFactor:) (fixed scale, default is 1.0). Valid scale factor range is [0.8, 2.0]. Automatic scaling is opt-in; symbols default to fixed 1.0x scale. (@dserebriakov, @pjleonard37)
• Interactive 3D Model Support Added ModelSource support with Model, ModelMaterialOverride, and ModelNodeOverride to enable interactive 3D models. Material overrides allow customization of color, emissive strength, opacity, and color mix intensity. Node overrides enable control of model part transformations such as rotating doors, landing gear, or propellers. Models can be updated via source-driven approach (modifying models directly) or feature-state driven approach (using expressions with feature state for dynamic control). For implementation examples, see Interactive3DModelFeatureStateExample (SwiftUI), Interactive3DModelSourceExample (UIKit), and Animated3DModelSourceExample (SwiftUI). (@stephanheigl, @evil159)

Bug fixes 🐞

• View Annotation Stability Fixed multiple issues causing point View Annotations to flicker or disappear when their anchor point moves near or outside the viewport edge. View Annotations now remain partially visible at boundaries and no longer hide unexpectedly when the anchor moves off-screen. Also fixed an issue where the avoid-symbol-layers collision detection was incorrectly active even with an empty layer list. (@dserebriakov, @OdNairy)
• Location Indicator Layer Ordering Fixed an issue where the location indicator (puck) was rendered behind symbol layers with occlusion enabled. The puck now correctly renders above occluded layers on 3D maps. (@alexey-romanov)
• Building Layer Crash Fixed a crash that could occur when rendering building layers with terrain exaggeration set to zero. (@aleksigron)
• Stretchable Icon Sizing Fixed stretchable icons rendering at incorrect sizes when icon-text-fit was not used. Previously, stretch areas were calculated with invalid default values, causing oversized or mispositioned icons. (@ibesora)
• Style Import Loading Style import updates now only take effect after the imported style data has fully loaded, preventing visual inconsistencies during style transitions. (@zmiao)
• Remote TileStore Creation Fixed an issue where TileStore creation could fail when using remote tile storage configurations due to path canonicalization occurring before service initialization. (@tatiana-yan)
• Tile LOD Rendering Fixed bearing compensation for parent tile nodes that could cause lower-resolution ancestor tiles to appear incorrectly during map rotation. (@pozdnyakov)
• Elevated Line Join Artifacts: Fixed elevated line bevel join artifacts at sharp corners. (@lasselammi)
• Icon Visibility After Memory Reduction: Fixed disappearing icons after reducing memory use. (@Nelarius)
• View Annotation Placement: Fixed View Annotations placement on interpolated geometry points. (@dserebriakov)
• Feature-Dependent Appearance Crash: Fixed a crash when using feature-dependent appearances with images and the default appearance image is empty. (@woodroof)
• View annotation gestures: Fix map panning gesture not working on ViewAnnotations. (@pjleonard37)

Deprecations ⚠️

• TileStore.create(path:) is now deprecated. Use TileStore.setRootPath(_:) instead to configure the tile store location. (@tatiana-yan)
• ResourceOptions tile store APIs are now deprecated. Use the dedicated TileStore configuration methods instead of passing tile store settings through ResourceOptions. (@pozdnyakov)

Dependencies

• Update MapboxCommon to 24.19.0.
• Update MapboxCoreMaps to 11.19.0.

Dependency requirements:

• Compatible version of Xcode: 16.4