Mapbox Maps iOS

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).
• [tile_store] 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.
• [tile_store] TileStore can now store 3D landmark/navigation tile content types, unblocking their use in offline regions.
• [tile_store] Add support for USB import radius — new import parameter for seeding offline tile packs from USB media within a configurable radius.
• Settings can be set on startup — MapboxCommon now loads persistent_settings.json and non_persistent_settings.json from the app data path at startup, allowing configuration changes without an app rebuild.

Bug fixes 🐞

• Fix build issue for Objective-C consumers using Xcode 26 / Swift 6.
• Fix scale-factor applied twice to icon with feature-dependent icon-size — icons using a data-driven icon-size no longer render over-sized under non-default scale factors.
• Fix fog range for custom FOVs in globe view — the globe no longer washes out in fog at small FOV changes; default globe fog range was retuned for more natural appearance.
• Fix for broken files in gl-native cache — the tile store worker now handles a code path that could leave corrupted entries in the gl-native disk cache, eliminating related load failures.
• Prevent tilestore crash on shutdown — fixed a use-after-free in the tile store worker that could crash the app when the tile store was torn down while work was still in flight.
• 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.

Dependencies

• Update MapboxCommon to 24.23.0.
• Update MapboxCoreMaps to 11.23.0.

Dependency requirements

• Compatible version of Xcode: 16.4

Bug fixes 🐞

• Fix build issue for Objective-C consumers using Xcode 26 / Swift 6.

Dependencies

• Update MapboxCommon to 24.22.1.
• Update MapboxCoreMaps to 11.22.1.

Dependency requirements:

• Compatible version of Xcode: 16.4

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 MapboxCommon to 24.21.3.
• Update MapboxCoreMaps to 11.21.3.

Dependency requirements:

• Compatible version of Xcode: 16.4

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).
• [tile_store] 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.
• [tile_store] TileStore can now store 3D landmark/navigation tile content types, unblocking their use in offline regions.
• [tile_store] Add support for USB import radius — new import parameter for seeding offline tile packs from USB media within a configurable radius.
• Settings can be set on startup — MapboxCommon now loads persistent_settings.json and non_persistent_settings.json from the app data path at startup, allowing configuration changes without an app rebuild.

Bug fixes 🐞

• Fix scale-factor applied twice to icon with feature-dependent icon-size — icons using a data-driven icon-size no longer render over-sized under non-default scale factors.
• Fix fog range for custom FOVs in globe view — the globe no longer washes out in fog at small FOV changes; default globe fog range was retuned for more natural appearance.
• Fix for broken files in gl-native cache — the tile store worker now handles a code path that could leave corrupted entries in the gl-native disk cache, eliminating related load failures.
• Prevent tilestore crash on shutdown — fixed a use-after-free in the tile store worker that could crash the app when the tile store was torn down while work was still in flight.

Dependencies

• Update MapboxCommon to 24.23.0-rc.1.
• Update MapboxCoreMaps to 11.23.0-rc.1.

Features ✨ and improvements 🏁

• Improve rendering performance of feature cutouts

Bug fixes 🐞

• Fix tile cover issues for tunnels

Dependencies

• Update MapboxCommon to 24.21.2.
• Update MapboxCoreMaps to 11.21.2.

Dependency requirements:

• Compatible version of Xcode: 16.4

Features ✨ and improvements 🏁

• Expose height and minHeight properties on StandardBuildingsFeature.
• Internal fixes and performance improvements.

Bug fixes 🐞

• Fix old 3D puck model remaining after updating the puck model.
• 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 tile store cleanup task incorrectly deleting in-progress downloads.
• 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 MapboxCommon to 24.22.0.
• Update MapboxCoreMaps to 11.22.0.

Dependency requirements:

• Compatible version of Xcode: 16.4

Bug fixes 🐞

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

Dependencies

• Update MapboxCommon to 24.20.3.
• Update MapboxCoreMaps to 11.20.3.

Dependency requirements:

• Compatible version of Xcode: 16.2

Bug fixes 🐞

• Internal fixes and performance improvements.

Dependencies

• Update MapboxCommon to 24.21.1.
• Update MapboxCoreMaps to 11.21.1.

Dependency requirements:

• Compatible version of Xcode: 16.2

Bug fixes 🐞

• Internal fixes and performance improvements.

Dependencies

• Update MapboxCommon to 24.19.6.
• Update MapboxCoreMaps to 11.19.6.

Dependency requirements:

• Compatible version of Xcode: 16.2

Features ✨ and improvements 🏁

• Expose height and minHeight properties on StandardBuildingsFeature.
• Internal fixes and performance improvements.

Bug fixes 🐞

• Fix old 3D puck model remaining after updating the puck model.
• 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 tile store cleanup task incorrectly deleting in-progress downloads.
• Resolve an issue where display link did not run for CarPlay Dashboard or Instrument Cluster scenes. The display link state is now correctly managed by caching the connected scene of the map view, supporting cases where the standard windowScene reference is unavailable (as in CarPlay dashboard configurations).

Dependencies

• Update MapboxCommon to 24.22.0-rc.1.
• Update MapboxCoreMaps to 11.22.0-rc.1.

Dependency requirements:

• Compatible version of Xcode: 16.4

Bug fixes 🐞

• Internal fixes and performance improvements.

Dependencies

• Update MapboxCommon to 24.19.5.
• Update MapboxCoreMaps to 11.19.5.

Dependency requirements:

• Compatible version of Xcode: 16.2

Changes

Features and Improvements

• Support paint properties in appearances
• Improve performance of View Annotations collisions test
• Share tile sources across style imports when URLs match
• Add UBO support for symbol paint properties
• Expose MapboxMap.onStyleAttributionsChanged

Bug fixes 🐞

• Fix tile store eviction failing to clean up files for decompressed tiles, causing gradual storage growth.
• Fix gaps in elevated route line rendering at ramp transitions and tile borders.
• Fix indicator cutout (location puck area) appearing in the wrong position on high-DPI displays.
• Fix incorrect shadow culling on fill-extrusion layers.
• Fix ambient occlusion not being clipped when fill-extrusion layers are clipped by clip layers.
• Fix clip layer updates not always refreshing clipped layers and shadows.
• Fix feature cutout rendering artifacts on some devices caused by insufficient shader precision.
• Fix rendering of stacked underground 3D roads.
• Fix a crash that could occur when the map is destroyed during style loading.
• Fix underground road geometry being clipped in orthographic projection with small viewports.
• Fix map flickering caused by stencil buffer conflicts between raster and hillshade layers.
• Fix potential ANRs when receiving location updates under heavy system load.
• Internal fixes and performance improvements.

Dependencies

• Update MapboxCommon to 24.21.0.
• Update MapboxCoreMaps to 11.21.0.

Dependency requirements:

• Compatible version of Xcode: 16.2

Bug fixes 🐞

• Fix overscaled offline tilepack tiles being showed after switching to online mode

Dependencies

• Update MapboxCommon to 24.19.4.
• Update MapboxCoreMaps to 11.19.4.

Dependency requirements:

• Compatible version of Xcode: 16.2

Changes

Improved stability.

Dependencies

• Update MapboxCommon to 24.19.3.
• Update MapboxCoreMaps to 11.19.3.

Dependency requirements:

• Compatible version of Xcode: 16.2

Changes

• TileStore: prevent stray files after decompression failures and cancellation
• Fix eviction query to handle empty BLOB content

Dependencies

• Update MapboxCommon to 24.19.2.
• Update MapboxCoreMaps to 11.19.2.

Dependency requirements:

• Compatible version of Xcode: 16.2

Changes

• Fix eviction query to handle empty BLOB content
• TileStore: prevent stray files after decompression failures and cancellation

Dependencies

• Update MapboxCommon to 24.20.2.
• Update MapboxCoreMaps to 11.20.2.

Dependency requirements:

• Compatible version of Xcode: 16.2

Changes

• TileStore: prevent stray files after decompression failures and cancellation
• TileStore: Fix eviction query to handle empty BLOB content

Dependencies

• Update MapboxCommon to 24.18.3.
• Update MapboxCoreMaps to 11.18.3.

Dependency requirements:

• Compatible version of Xcode: 16.2

Changes

New Features

• Expose MapboxMap.onStyleAttributionsChanged

Bug fixes 🐞

• Fix feature cutout shader precision issue
• Fix rendering of stacked underground 3d roads
• Fix crash in onSpriteLoaded callback
• Fix far-plane clipping of underground road geometry in orthographic projection

Improvements

• Support paint properties in appearances
• Improve performance of View Annotations collisions test
• Share tile sources across style imports when URLs match
• Add UBO support for symbol paint properties
• Fix map flickering due to manual clears of stencil after setupStencilForOverlap

Dependencies

• Update MapboxCommon to 24.21.0-rc.1.
• Update MapboxCoreMaps to 11.21.0-rc.1.

Dependency requirements:

• Compatible version of Xcode: 16.2

[!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.20.2 or any version from 11.21.0 onward. This specific bug is only relevant to users who use tilestore offline regions.

Changes

• Internal fixes and performance improvements

Dependencies

• Update MapboxCommon to 24.20.1.
• Update MapboxCoreMaps to 11.20.1.

Dependency requirements:

• Compatible version of Xcode: 16.2

[!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.20.2 or any version from 11.21.0 onward. This specific bug is only relevant to users who use tilestore offline regions.

📦 Pre-built binaries for faster build times are available via mapbox-maps-ios-binary.

Bug fixes 🐞

• Map ornaments positioning Fix incorrect positioning of map ornaments when multiple ornaments are placed in the same corner. (@evil159)
• Feature Cutout Artifacts at Route Overlaps Fixed feature cutout artifacts caused by a shader caching issue at route overlaps, preventing visual artifacts where routes intersect. (@lasselammi)
• FillExtrusion Data Race Fixed a data race condition where two threads could simultaneously write to a shared static variable in FillExtrusion layer rendering. (@zmiao)
• Runtime Symbol Appearance Switches Fixed several issues related to runtime symbol appearance switches: active appearance was not recalculated when appearance order or conditions changed, text appearances were skipped when an image was active, only the first of multiple layers sharing the same source had appearances recalculated, and new layouts after relayout did not trigger appearance recalculation. (@woodroof)
• Icon Visibility After Memory Reduction Fixed disappearing icons after reducing memory use. The vector icon manager now correctly clears its cache on reduceMemoryUse, restoring previous behavior. (@Nelarius)
• Landmark POI Image Relayout Fixed an issue where landmark POI image loads triggered unnecessary relayout for unrelated layers, improving rendering performance and stability. (@mpulkki-mapbox)
• TileStore Eviction Blocking Fixed TileStore eviction logic that could block the TileStore thread completely. Added a configurable cooldown delay between eviction calls and introduced over-eviction to reduce the frequency of eviction operations. (@olegfedorovdev)
• Elevated Line Out-of-Bounds Clipping Fixed an out-of-bounds issue for elevated lines caused by an incorrect clipping result producing zero-length segments. (@metalpavel)

Dependencies

• Update MapboxCommon to 24.20.0.
• Update MapboxCoreMaps to 11.20.0.

Dependency requirements:

• Compatible version of Xcode: 16.2