releases.shpreview
Mapbox/Mapbox Maps iOS

Mapbox Maps iOS

$npx @buildinternet/releases show mapbox-maps-ios
Mon
Wed
Fri
MayJunJulAugSepOctNovDecJanFebMarApr
Less
More
Releases29Avg9/moVersionsv11.19.0-beta.1 → v11.23.0
May 16, 2025

Bug fixes 🐞

  • Apply a workaround for 401 status code/timeout network issues on iOS devices (iOS 18.4 and 18.5 exclusively).

Dependencies

  • Update MapboxCommon to 24.12.1.
  • Update MapboxCoreMaps to 11.12.1.

Dependency requirements:

  • Compatible version of Xcode: 16.2.0
May 7, 2025

Features ✨ and improvements 🏁

Bug fixes 🐞

  • Failing network requests on iOS Simulators running iOS 18.4 were mitigated by disabling TLS 1.3.
    This is a known issue in the iOS SDK. The fix applies exclusively to iOS Simulators and only for iOS 18.4.x versions. The upcoming iOS 18.5 will have TLS 1.3 support enabled by default, as it did before iOS 18.4.
  • StyleManager/image(withId:) now supports vector icons.
  • Fix missing city or street names in the satellite mode.
  • Fix map flickering caused by the fill-extrusion pan tiles and missing stencil in 3D layers
  • Avoid re-allocations per frame on tileclippingMasksIDs
  • Reduce excessive allocations on the tile pyramid nodes re-creation
  • Optimize symbol-sort-key sorting algorithm
  • Fix semi-transparent landmark icons.
  • Fix clipPath and mask rendering for vector icon rasterization.
  • Fix dotted lines on tile borders.
  • Fix pattern not found when using imports.
  • Fix line layer not rendering if using line-pattern inside an imported style.
  • Avoid dynamic view annotations overlapping given symbol layers.

💫️ Other

  • Fix ground effect gradient not working with multiple polygons.
  • Add simple bounds check to avoid crash during centroid computation.
  • Fix invisible line when interpolating line-width from 0 to 1 using line-progress.
  • Fix elevated structure normals.
  • Speedup tile loading.
  • Support color-use-theme for rain and snow.
  • Elevated bridge rail guard style support for color, emissive strength and enable/disable rail guard.
  • Remove material copy that was causing temporary allocations.

Dependencies

  • Update MapboxCommon to 24.12.0.
  • Update MapboxCoreMaps to 11.12.0.

Dependency requirements:

  • Compatible version of Xcode: 16.2.0
Apr 25, 2025

[!IMPORTANT] This is the last version to support Xcode 15

Dependencies

  • Updated MapboxCommon to 24.11.3.
  • Updated MapboxCoreMaps to 11.11.3.

Dependency Requirements

  • Compatible Xcode version: 15.2.0.
Apr 23, 2025

Features ✨ and improvements 🏁

Bug fixes 🐞

  • Fix map flickering caused by the fill-extrusion pan tiles and missing stencil in 3D layers
  • Avoid re-allocations per frame on tileclippingMasksIDs
  • Reduce excessive allocations on the tile pyramid nodes re-creation
  • Optimize symbol-sort-key sorting algorithm

Dependencies

  • Update MapboxCommon to 24.12.0-rc.1.
  • Update MapboxCoreMaps to 11.12.0-rc.1.

Dependency requirements:

  • Compatible version of Xcode: 16.2.0
Apr 9, 2025

Features ✨ and Improvements 🏁

  • Expose graphicsPrograms, graphicsProgramsCreationTimeMillis and fboSwitchCount for CumulativeRenderingStatistics.
  • Avoid DVA overlapping given symbol layers.
  • Vector icons can now also be retrieved via getStyleImage.
  • Add new at-interpolated expression.
  • Enable tile pack v2 format by default.

Bug fixes 🐞

  • Fix semi transparent landmark icons.
  • Return null for config expression if requested config option is missing.
  • Fix clipPath and mask rendering for vector icon rasterization.
  • Fix dotted lines on tile borders.
  • Fix pattern not found when using imports.
  • Fix line layer not rendering if using line-pattern inside an imported style.

💫️ Other

  • Fix ground effect gradient not working with multiple polygons.
  • Add simple bounds check to avoid crash during centroid computation.
  • Fix invisible line when interpolating line-width from 0 to 1 using line-progress.
  • Fix elevated structure normals.
  • Speedup tile loading.
  • Support color-use-theme for rain and snow.
  • Elevated bridge rail guard style support for color, emissive strength and enable/disable rail guard.
  • Remove material copy that was causing temporary allocations.

Dependencies

  • Updated MapboxCommon to 24.12.0-beta.1.
  • Updated MapboxCoreMaps to 11.12.0-beta.1.

Dependency Requirements

  • Compatible Xcode version: 16.2.0.
Apr 2, 2025

Bug fixes 🐞

  • Fix a rare crash in HTTP requests caused by [NSString initWithBytes:length:encoding:] succeeds when headers contain invalid utf-8 values.

Dependencies

  • Update MapboxCommon to 24.5.1.

Dependency requirements:

  • Compatible version of Xcode: 15.2.0
Mar 26, 2025

Features ✨ and Improvements 🏁

  • ✨ Landmark icons Landmark icons are stylized, uniquely designed POI icons that indicate the most popular and recognizable landmarks on the map.
  • Introduced an experimental API for setting ColorTheme on style imports.
  • Added experimental use-theme properties for all annotation types and the Puck3D layer.
  • Enabled panning and pinching gestures for trackpads.
  • Reduced installation size by approximately 10 MB by redacting unnecessary debug symbols.
  • Optimized battery usage by reducing background triggers when the app is not in focus.
  • Lowered CPU load by implementing exponential backoff for failed connection attempts.
  • Added support for vector icons in the location indicator layer.
  • Increased the placement range for Dynamic View Annotations when the pitch level exceeds 45 degrees.

Bug Fixes 🐞

  • Resolved Dynamic View Annotations placement issues at high zoom levels.
  • Fixed an issue where line placement symbols would disappear at zoom levels between 5 and 6.
  • Addressed missing vector images after a style change.
  • Fixed background layer updates when a raster image was updated in place.
  • Ensured the background layer updates correctly when changing the color theme.
  • Fixed LUT (look-up table) application for in-place updated images.
  • Resolved in-place updates for SDF (Signed Distance Field) images.
  • Corrected mipmaps for images updated in place.
  • Added support for positive mask coordinates for vector images.
  • Fixed dark gradient shades in the night preset.
  • Addressed rare cases of missing background colors.
  • Improved Custom Raster Source behavior upon re-creation.
    • Previously, when the Custom Raster Source was re-created within the same call chain, its rendering counterparts were not updated. This prevented CustomRasterSourceTileRenderer from being properly re-initialized.

Dependencies

  • Updated MapboxCommon to 24.11.0.
  • Updated MapboxCoreMaps to 11.11.0:
    • Fixed semi-transparent landmark icons.
    • Improved tile loading speed.

Dependency Requirements

  • Compatible Xcode version: 15.2.0.
Mar 19, 2025

Bug fixes 🐞

  • Fix a bug that may cause style packs to be either inaccessible or incorrect when updating an older tile store database created with Maps SDK 11.9 or earlier versions. In systems that have already used Maps SDK 11.10.0 through 11.10.1, a re-download of style packs may be necessary.
  • Fix a map start time regression by speed up tile loading.

Dependencies

  • Update gl-native to v11.10.3, common to v24.10.1.

Dependency requirements:

  • Compatible version of Xcode: 15.2.0
Mar 12, 2025

Changes

<Compose changelog here>

Features ✨ and improvements 🏁

  • Expose experimental API for setting ColorTheme on style imports.
  • Expose use-theme properties for all annotation types and Puck3D layer.

Dependencies

  • Update MapboxCommon to 24.11.0-rc.2.
  • Update MapboxCoreMaps to 11.11.0-rc.2:
    • Fixed incorrect rgba to hsla conversion for white color
    • Fix vector images rasterization
    • Make katakana and CJK symbol rendered correctly in vertical writing mode
</details>

Dependency requirements:

  • Compatible version of Xcode: 15.2.0
Mar 6, 2025

Changes

  • Address the EXC_BAD_ACCESS crash in the LocationProducer.latestCLLocation.setter
  • Add logs to indicate that deallocating MapView out of the main thread is an undefined behaviour

Dependency requirements:

  • Compatible version of Xcode: 14.1.0
Mar 3, 2025

Features ✨ and improvements 🏁

  • Support panning and pinching gestures for trackpads.
  • Reduce installation size by ≈ 10 MB by redacting the rest of the debug symbols.
  • Reduce the amount of background triggers to optimize battery usage when the app is not in the focus anymore.
  • Reduce CPU load by adding exponential backoff for failed connection attempts
  • Vector icons supported in the location indicator layer
  • Dynamic View Annotations could be placed further away when the pitch level is more than 45 degrees

Bug fixes 🐞

  • Fix Dynamic View Annotations placement on high zoom levels
  • Fix line placement symbol disappearing issue when in zoom level between 5 and 6
  • Fixing missing vector images after style change
  • Fix background layer not being updated on raster image was in-place update
  • Fix background layer not being updated on color theme change
  • Fixing LUT (look-up table) not being applied to in-place updated images.
  • Fixing in-place updates for SDF (Signed Distance Field) images.
  • Fix mipmaps for images updated inplace
  • Support positive mask coordinates for vector images.
  • Fix dark shades of gradient effect in the night preset
  • Fix rarely missing background color
  • Fix Custom Raster Source behavior on re-creation
  • Previously, when the Custom Raster source was re-created within the same call chain, its rendering counterparts were not updated. This caused the CustomRasterSourceTileRenderer to remain not re-initialized.

Dependencies

  • Update MapboxCommon to 24.11.0-beta.1.
  • Update MapboxCoreMaps to 11.11.0-beta.1.

Dependency requirements:

  • Compatible version of Xcode: 15.2.0
Feb 25, 2025

Bug fixes 🐞

  • Fixing LUT not being applied to in-place updated images. Fixing in-place updates for SDF images.
  • Fix background layer not being updated if raster image was updated in-place or if color theme changed
  • Vector icons supported in location indicator layer
  • Fix mipmaps for images updated in-place
  • Ensure background color is correctly set
  • Fixing missing vector images after style change

Dependencies

  • Update MapboxCommon to 24.10.0.
  • Update MapboxCoreMaps to 11.10.2.
</details>

Dependency requirements:

  • Compatible version of Xcode: 15.2.0
Feb 13, 2025

[!IMPORTANT] Minimal deployment target is raised to iOS 14.0

Features ✨ and improvements 🏁

  • Mark SymbolElevationReference, FillExtrusionBaseAlignment, FillExtrusionHeightAlignment, ModelScaleMode, ModelType, ClipLayerTypes, BackgroundPitchAlignment types as Experimental. Initially they were exposed as stable by mistake. If you use them, please import MapboxMaps with Experimental SPI:
@_spi(Experimental) import MapboxMaps
  • Localize geofencing attribution dialog.
  • Support dictionary expression literals.
  • Bump minimal deployment target from 12.0 to 14.0.
  • [SwiftUI] Expose new slot() method on annotation groups that takes Slot instead of String. Use the type with annotationGroups:
CircleAnnotationGroup {}
  // old
  .slot("middle")
  // new
  .slot(.middle)
  • Introduce ViewAnnotation.priority, deprecate ViewAnnotation.selected. Use this property to define view annotation sort order.
  • Introduce ViewAnnotation.minZoom and ViewAnnotation.maxZoom. Use these properties to configure zoom-level specific view annotations.
  • Support expression input for promoteId
  • Expose zlevel of the current queried polygon in road elevation queries
  • Adjust depth bias when in orthographic mode
  • Use zLevelProgress property to disambiguate elevation on dynamic routes
  • Append http response message to response error
  • Expose experimental ColorTheme API to set style wide color theme. A color theme modifies the global colors of a style using a LUT (lookup table) for color grading. Pass the image either as a base64-encoded string or as UIImage:
let mapView = MapView()
mapView.mapboxMap.setMapStyleContent {
   ColorTheme(base64: "base64EncodedImage") // or use an uiimage shortcut ColorTheme(uiimage: lutImage)
}

[!NOTE] Each style can have only one ColorTheme. Setting a new theme overwrites the previous one. Further details can be found in documentation for ColorTheme

  • Add support for experimental *-use-theme propert that allow to override the color theme set on the Map. This is experimental and have several limitations - currently expressions are not supported. Color properties in Lights, Rain, Snow are not supported. *-use-theme for layer applied only after zoom level change.
  • Promote ClipLayer.clipLayerTypes and ClipLayer.clipLayerScope to stable.
  • Remove experimental DirectionalLight.shadowQuality.
  • Add experimental ViewAnnotationManager.viewAnnotationAvoidLayers for specifying layers that view annotations should avoid. The API currently only supports line layers.
  • Add support for the maxOverscaleFactorForParentTiles property in CustomRasterSource and CustomGeometrySource, allowing greater control over tile overscaling behavior when rendering custom raster tiles.

Bug fixes 🐞

  • Prefer last used anchor for DVA placement
  • Fix out of bound issue of gradient effect
  • Fix hidden elements caused by flood lighting
  • Fixing parsing raster sprite images with float stretch/content coordinates
  • Fix glyph loading issue when incorrect glyph url is used
  • Fix color theme data decoding
  • Speeding up start with big old offline database
  • Fixing disappearing tiles in some rare conditions
  • Fix rasterization of images with positive mask coordinates
  • Place viewannotation away from camera when pitch > 45
  • Fix dark shades of gradient effect in night preset
  • Fix exception on the platform side while parsing the config expression
  • Fix problems with models and depth precision in ortho projection
  • Fix for autoMaxZoom=true
  • Fixed background layers which used images from a mapbox-hosted style
  • Fixed images being displayed incorrectly in some cases with line patterns and line-join:none
  • Clipping next zoom with maxzoom during calculation of text/icon size. Fixed text-zoom interpolation to 0.
  • Fix too early sources loaded event
  • Fix line rendering for layers with elevated and non-elevated buckets
  • Fix crash on style re-load if a config referenced in the expression was missing
  • Fix high cpu usage when map goes to background
  • Fixed missing onStyleLoaded call if sprite is absent in cache and there are no network connection
  • Fix incorrect progress when zLevel splitting
  • [common/tile_store] Fix request coalescing with accepted formats
  • [telemetry] Set initial movement information to location events delegate

💫️ Other

  • Fix road shadows issues when far away and low zoom levels
  • Extend tilecover for elevated roads avoiding missing road segments
  • [tilestore, logging] Log error when contentResult is unvailable
  • [tile_store] Migrate resources from HTTP URL to mapbox:// URI
  • Concurrency parameter may be ignored by tilestore tool because of uninitialised variable which stops thread right away

Dependencies

  • Update MapboxCommon to 24.10.0.
  • Update MapboxCoreMaps to 11.10.0.
  • Update Turf to 4.0.0

Dependency requirements:

  • Compatible version of Xcode: 15.2.0
Feb 5, 2025

Bug fixes 🐞

  • Fix exception while parsing the config expression
  • Fix app crash when autoMaxZoom=true
  • Fixing parsing raster sprite images with float stretch/content coordinates
  • Fix color theme data decoding
  • Fix glyph loading issue when incorrect glyph url is used

Dependencies

  • Update MapboxCoreMaps to 10.19.3.

Dependency requirements:

  • Compatible version of Xcode: 15.2.0
Feb 3, 2025

Changes

  • Update MapboxCommon to 23.11.4

Dependencies

  • Update MapboxCommon to 23.11.4.

Dependency requirements:

  • Compatible version of Xcode: 14.1.0
Jan 31, 2025

[!IMPORTANT] Minimal deployment target is raised to iOS 14.0

Features ✨ and improvements 🏁

  • Expose experimental ColorTheme API to set style wide color theme. A color theme modifies the global colors of a style using a LUT (lookup table) for color grading. Pass the image either as a base64-encoded string or as UIImage:
let mapView = MapView()
mapView.mapboxMap.setMapStyleContent {
   ColorTheme(base64: "base64EncodedImage") // or use an uiimage shortcut ColorTheme(uiimage: lutImage)
}

Note: Each style can have only one ColorTheme. Setting a new theme overwrites the previous one. Further details can be fouund in documentation for ColorTheme

  • Add support for experimental *-use-theme propert that allow to override the color theme set on the Map. This is experimental and have several limitations - currently expressions are not supported. Color properties in Lights, Rain, Snow are not supported. *-use-theme for layer applied only after zoom level change.
  • Promote ClipLayer.clipLayerTypes and ClipLayer.clipLayerScope to stable.
  • Remove experimental DirectionalLight.shadowQuality.
  • Add experimental ViewAnnotationManager.viewAnnotationAvoidLayers for specifying layers that view annotations should avoid. The API currently only supports line layers.
  • Add support for the maxOverscaleFactorForParentTiles property in CustomRasterSource and CustomGeometrySource, allowing greater control over tile overscaling behavior when rendering custom raster tiles.

Bug fixes 🐞

  • Prefer last used anchor for DVA placement
  • Fix out of bound issue of gradient effect
  • Fix hidden elements caused by flood lighting
  • Fixing parsing raster sprite images with float stretch/content coordinates
  • Fix glyph loading issue when incorrect glyph url is used
  • Fix color theme data decoding
  • Speeding up start with big old offline database
  • Fixing disappearing tiles in some rare conditions

💫️ Other

  • Fix road shadows issues when far away and low zoom levels
  • Extend tilecover for elevated roads avoiding missing road segments

Dependencies

  • Update MapboxCommon to 24.10.0-rc.1.
  • Update MapboxCoreMaps to 11.10.0-rc.1.

Dependency requirements:

  • Compatible version of Xcode: 15.2.0
Jan 23, 2025

Changes

  • [MapboxCommon] Address high CPU usage in the com.mapbox.common.location.sharedRunLoop

Dependencies

  • Update MapboxCommon to 23.11.3.
  • MapboxCoreMaps 10.19.2

Dependency requirements:

  • Compatible version of Xcode: 14.1.0
Jan 20, 2025

[!IMPORTANT] Minimal deployment target is raised to iOS 14.0

Known issues 🐞

  • Disappearing tiles in some rare conditions. The fix is scheduled for RC.

Features ✨ and improvements 🏁

  • Mark SymbolElevationReference, FillExtrusionBaseAlignment, FillExtrusionHeightAlignment, ModelScaleMode, ModelType, ClipLayerTypes, BackgroundPitchAlignment types as Experimental. Initially they were exposed as stable by mistake. If you use them, please import MapboxMaps with Experimental SPI:
@_spi(Experimental) import MapboxMaps
  • Localize geofencing attribution dialog.
  • Support dictionary expression literals.
  • Bump minimal deployment target from 12.0 to 14.0.
  • [SwiftUI] Expose new slot() method on annotation groups that takes Slot instead of String. Use the type with annotationGroups:
CircleAnnotationGroup {}
  // old
  .slot("middle")
  // new
  .slot(.middle)
  • Introduce ViewAnnotation.priority, deprecate ViewAnnotation.selected. Use this property to define view annotation sort order.
  • Introduce ViewAnnotation.minZoom and ViewAnnotation.maxZoom. Use these properties to configure zoom-level specific view annotations.
  • [tile_store] Migrate resources from HTTP URL to mapbox:// URI
  • Support expression input for promoteId
  • Expose zlevel of the current queried polygon in road elevation queries
  • Adjust depth bias when in orthographic mode
  • Use zLevelProgress property to disambiguate elevation on dynamic routes
  • Append http response message to response error

Bug fixes 🐞

  • Fix crash on style re-load if a config referenced in the expression was missing
  • Fixed missing on style loaded call if sprite is absent in cache and there are no network connection
  • Fixed background layers which used images from a mapbox-hosted style
  • Fixed images being displayed incorrectly in some cases with line patterns and line-join:none
  • Clipping next zoom with maxzoom during calculation of text/icon size. Fixed text-zoom interpolation to 0.
  • Fix too early sources loaded event
  • Fix line rendering for layers with elevated and non-elevated buckets
  • Fix incorrect progress when zLevel splitting

Dependencies

  • Update MapboxCommon to 24.10.0-beta.2.
  • Update MapboxCoreMaps to 11.10.0-beta.2.

Dependency requirements:

  • Compatible version of Xcode: 15.2.0

Bug fixes 🐞

  • Fixed crash on style re-load if a config referenced in the expression was missing
  • Fixed missing on style loaded call if sprite is absent in cache and there are no network connection
  • Fixed background layers which used images from a mapbox-hosted style
  • Fixed disappearing tiles in some rare conditions

Dependencies

  • Update MapboxCommon to 24.9.0.
  • Update MapboxCoreMaps to 11.9.2.
</details>

Dependency requirements:

  • Compatible version of Xcode: 15.2.0
Dec 19, 2024

[!WARNING] ⚠️⚠️⚠️ Upcoming breaking changes ⚠️⚠️⚠️

This is the last minor SDK version to support iOS 12 and iOS 13. Only versions v11.9.* will support iOS 12 and 13. The subsequent minor releases (starting with v11.10.0-beta.1) will have iOS 14 as the minimum deployment target requirement.

[!WARNING] ⚠️⚠️⚠️ Potentially breaking changes ⚠️⚠️⚠️

Mark symbolElevationReference, symbolZOffset, lineTrimColor, lineTrimFadeRange, lineZOffset as Experimental in AnnotationManagers. This is potentially breaking change, however those properties are not marked as experimental only in AnnotationManagers by mistake. In order to continue use them use the following import @_spi(Experimental) import MapboxMaps.

Features ✨ and improvements 🏁

Bug fixes 🐞

  • Function to update location for LocationIndicatorLayer now correctly encodes the data for the rendering engine.

Dependencies

  • Update MapboxCommon to 24.9.0.
  • Update MapboxCoreMaps to 11.9.0.

Dependency requirements:

  • Compatible version of Xcode: 15.2.0
Latest
v11.23.0
Tracking Since
Dec 19, 2024
Last checked May 1, 2026