Mapbox Maps iOS

Features ✨ and improvements 🏁

• Introduce ScaleBarViewOptions.units property supporting metric, imperial, and nautical units, replacing the boolean useMetricUnits property.
• Add 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 MapInitOptions.mapStyle property. Use it to initialize map with a custom style.

// Before
let options = MapInitOptions(styleURI: .standardSatellite)
let mapView = MapView(frame: view.bounds, mapInitOptions: options)
mapView.mapboxMap.setStyleImportConfigProperties(for: "basemap", configs: ["lightPreset": "dusk"])

// After:
let options = MapInitOptions(mapStyle: .standardSatellite(lightPreset: .dusk))
let mapView = MapView(frame: view.bounds, mapInitOptions: options)

• Add StyleReloadPolicy to control style reload behavior. Use reloadPolicy: .always parameter in loadStyle() methods or MapStyle initializers to always reload the style even when the URI or JSON matches the currently loaded style. Defaults to .onlyIfChanged for optimal performance.
• Add experimental scaleFactor parameter to MapOptions and MapSnapshotOptions for scaling icons and texts. Default value is 1.0.
• 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 AppearancesExample for further details.
• Enable use of MapboxCommon's location manager in MapView.

Bug fixes 🐞

• Fix crash in OrnamentsManager when setting attribution color.
• Fix terrain crash on style switches.
• Fix line patterns not elevating properly on HD roads.
• Implement zoom expression evaluation for line-cutout-width.
• Fix uint underflow in work limiting scheduler.

Optimizations and enhancements 🚀

• Fix GeoJSON tiled model disappearance in fast zoom situations.
• Optimize memory usage in GridIndex and related code.
• Memory improvements for vertex buffers.
• Avoid extra allocations in Formatted objects.
• Logging improvements to reduce duplication.

Dependencies

• Update MapboxCommon to 24.17.0-beta.1.
• Update MapboxCoreMaps to 11.17.0-beta.1:

Dependency requirements:

• Compatible version of Xcode: 16.2

Bug fixes 🐞

• Fix crash on 3D/satellite styles switching.
• Fix performance regression by avoiding heavy search path.

Dependencies

• Update MapboxCommon to 24.16.2.
• Update MapboxCoreMaps to 11.16.2.

Dependency requirements:

• Compatible version of Xcode: 16.2

Bug fixes 🐞

• Fix asserting in image manager caused by Landmark Icons not cleared on style unload
• Fix rendering TileStore tiles when TileStore is used as disk cache
• Fix regression due to faulty eachChild method implementation in certain expressions
• Fix crash caused by incorrect texture release order

Dependencies

• Update MapboxCommon to 24.16.1.
• Update MapboxCoreMaps to 11.16.1.

Dependency requirements:

• Compatible version of Xcode: 16.2

Dependencies

• Update MapboxCommon to 24.15.4.
• Update MapboxCoreMaps to 11.15.4.

Dependency requirements:

• Compatible version of Xcode: 16.2

Features ✨ and improvements 🏁

• Added support for LandmarkIcons featureset in Mapbox Standard Style. Use the standardLandmarkIcons featureset descriptor to handle interactions on landmark buildings icons:

Map {
    TapInteraction(.standardLandmarkIcons) { landmark, ctx in
        print("Landmark \(landmark.name) is tapped")
    }
}

• Enhanced MapStyle.standard() and MapStyle.standardSatellite() with new configuration parameters for color customization, landmark icons visibility, point-of-interest styling, road appearance, and administrative boundaries.
• Expose LineLayer.lineCutoutFadeWidth to control route line cutout fade width.

Bug fixes 🐞

• Fix Offline Region missing middle zoom level tiles
• Fixed issues where feature state were not immediately applied
• Fix precision issue in hillshade causing terrain with steps
• Fix interactions with 2D and 3D location indicator.
• Fix view annotation disappearing due to Location Indicator use in some pitch levels.
• Fix occlusion-opacity layers reordering
• Fix gradients and interpolations with fully-transparent colors
• Fix Dynamic View Annotations stability.
• Fix location indicator layer rendering when the persistent buffer mapping flag is enabled
• Fix incorrect background color of icons when non-default color-theme is used
• Fix respectin the "tile-minimum-cache-duration" tilestore option
• Fix removal of tiles from group when update application is resumed
• Fix assertion on missing low zoom levels in the tile pack leveling scheme
• Fix crash in style layer property setter
• Fix var expressions that did not work properly with config expressions.
• Fix cutout disappearing at certain zoom and pitch levels with orthographic camera.
• TileStore improvements: import functionality, reliability, and support have been enhanced.

Dependencies

• Update MapboxCommon to 24.16.0.
• Update MapboxCoreMaps to 11.16.0.

</details>

Dependency requirements:

• Compatible version of Xcode: 16.2

Features ✨ and improvements 🏁

• TileStore improvements: import functionality, reliability, and support have been enhanced.

Dependencies

• Update MapboxCommon to 24.16.0-rc.2
• Update MapboxCoreMaps to 11.16.0-rc.2

Dependency requirements:

• Compatible version of Xcode: 16.2

Dependencies

• Update MapboxCommon to 24.15.3.
• Update MapboxCoreMaps to 11.15.3:

Dependency requirements:

• Compatible version of Xcode: 16.2

Changes

<Compose changelog here>

Dependencies

• Update MapboxCommon to 24.14.8.
• Update MapboxCoreMaps to 11.14.8:
  • <details> <summary>Changelog </summary>

</details>

Dependency requirements:

• Compatible version of Xcode: 16.2

Bug fixes 🐞

• Fix assertion on missing low zoom levels in the tile pack leveling scheme
• Fix crash in style layer property setter
• Fix var expressions that did not work properly with config expressions.
• Fix cutout disappearing at certain zoom and pitch levels with orthographic camera.

Dependencies

• Update MapboxCommon to 24.16.0-rc.1.
• Update MapboxCoreMaps to 11.16.0-rc.1:

Dependency requirements:

• Compatible version of Xcode: 16.2

Changes

• Improved CPU and Memory bandwidth consumption.

Dependencies

• Update MapboxCommon to 24.15.2.
• Update MapboxCoreMaps to 11.15.2.

Dependency requirements:

• Compatible version of Xcode: 16.2

Changes

Internal improvements and optimizations.

Dependencies

• Update MapboxCommon to 24.14.7.
• Update MapboxCoreMaps to 11.14.7.

Dependency requirements:

• Compatible version of Xcode: 16.2

Bug fixes 🐞

• Fix feature cutout disappearing on certain zoom/pitch
• [Offline] Handle composited components min zoom levels properly
• Fix brightness evaluation in rare cases

Dependencies

• Update MapboxCommon to 24.15.1.
• Update MapboxCoreMaps to 11.15.1.

</details>

Dependency requirements:

• Compatible version of Xcode: 16.2

Features ✨ and improvements 🏁

• Added support for LandmarkIcons featureset in Mapbox Standard Style. Use the standardLandmarkIcons featureset descriptor to handle interactions on landmark buildings icons:

Map {
    TapInteraction(.standardLandmarkIcons) { landmark, ctx in
        print("Landmark \(landmark.name) is tapped")
    }
}

• Enhanced MapStyle.standard() and MapStyle.standardSatellite() with new configuration parameters for color customization, landmark icons visibility, point-of-interest styling, road appearance, and administrative boundaries.
• Expose LineLayer.lineCutoutFadeWidth to control route line cutout fade width.

Bug fixes 🐞

• Fix Offline Region missing middle zoom level tiles
• Fixed issues where feature state were not immediately applied
• Fix precision issue in hillshade causing terrain with steps
• Fix interactions with 2D and 3D location indicator.
• Fix view annotation disappearing due to Location Indicator use in some pitch levels.
• Fix occlusion-opacity layers reordering
• Fix gradients and interpolations with fully-transparent colors
• Fix Dynamic View Annotations stability.
• Fix location indicator layer rendering when the persistent buffer mapping flag is enabled
• Fix incorrect background color of icons when non-default color-theme is used
• Fix respectin the "tile-minimum-cache-duration" tilestore option
• Fix removal of tiles from group when update application is resumed

Dependencies

• Update MapboxCommon to 24.16.0-beta.1.
• Update MapboxCoreMaps to 11.16.0-beta.1.

</details>

Dependency requirements:

• Compatible version of Xcode: 16.2

Bug fixes 🐞

• Make background location tracking consistent with server configuration

Dependencies

• Update MapboxCommon to 24.14.6.
• Update MapboxCoreMaps to 11.14.6.

Dependency requirements:

• Compatible version of Xcode: 16.2

Features ✨ and improvements 🏁

• Support -use-theme property for icons
• Improve performance of the zooming-out animation by enabling tile hinting.
• Symbol layers now supporting GeoJSON sources for elevation
• Line cutout opacity properties: lineCutoutOpacity and lineCutoutWidth

Bug fixes 🐞

• Reduce RAM usage for Line features
• Fix crash on Mapbox stack deallocation
• Improved update reliability by only removing patches after successful application
• Improved task scheduler to prevent deadlock on shutdown
• Fix interaction with 2D and 3D location indicators.
• Fix disappearing ViewAnnotation when camera is far away from the device location
• Fix disapearing Dynamic ViewAnnotations after alternative route selection and viewport state updates
• Fix missing ViewAnnotation on zoom level higher than 22
• Fix text miss placement if it is accompanied by icon
• Fix background color for non-default color theme
• Support per-fragment symbol occlusion opacity
• Enable road elevation for symbols with line placement
• Dithered transparency for lane cutout
• Improve animation performance by time limiting symbol updates
• Improve fill extrusion parsing performance
• Fix tile border debug feature flickering on globe

Dependencies

• Update MapboxCommon to 24.15.0.
• Update MapboxCoreMaps to 11.15.0.

Dependency requirements:

• Compatible version of Xcode: 16.2

Changes

• Improve View Annotations impact on frame time.

Dependencies

• Update MapboxCommon to 24.14.4.
• Update MapboxCoreMaps to 11.14.4.

Dependency requirements:

• Compatible version of Xcode: 16.2

Changes

🐞 Bug fixes

• Fix 3d models dealing crash during map destruction.
• Fix location indicator rendering issues in some states.
• Fix dynamic view annotations disappearance in some states.

Dependencies

• Update MapboxCommon to 24.14.3.
• Update MapboxCoreMaps to 11.14.3.

Dependency requirements:

• Compatible version of Xcode: 16.2

Bug fixes 🐞

• Fix View Annotation to be not displayed at zoom levels > 22
• Fix model manager crash during destruction stage
• Fix the alignment of the text and icon when using the text-anchor property.
• Avoid deadlock between new task scheduling and shutdown

Dependencies

• Update MapboxCommon to 24.15.0-rc.1.
• Update MapboxCoreMaps to 11.15.0-rc.1.

Dependency requirements:

• Compatible version of Xcode: 16.2

Bug fixes 🐞

• Fix incorrect background color of icons when non-default color-theme is used.
• Fix infinite loop in attribution button tint color configuration.

Dependencies

• Update MapboxCommon to 24.15.0-beta.3.
• Update MapboxCoreMaps to 11.15.0-beta.3.

Dependency requirements:

• Compatible version of Xcode: 16.2

Features ✨ and improvements 🏁

• Optimize LineBucket triangle allocation with reusable vector.
• Re-enable symbol placement time limit by filtering only fast zoom animations.
• Limit the time spent in updating symbols when the view is animating.

Dependencies

• Update MapboxCommon to 24.14.2.
• Update MapboxCoreMaps to 11.14.2.

Dependency requirements:

• Compatible version of Xcode: 16.2