11.9.2

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

v10.19.3

Changes

• Update MapboxCommon to 23.11.4

Dependencies

• Update MapboxCommon to 23.11.4.

Dependency requirements:

• Compatible version of Xcode: 14.1.0

v11.10.0-rc.1

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

v10.19.2

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

11.10.0-beta.1

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

v11.9.1

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.

Dependency requirements:

• Compatible version of Xcode: 15.2.0

v11.9.0

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 🏁

• New experimental weather effects – Snow and Rain.
• Experimental elevation support for FillLayer and PolygonAnnotation (including corresponding manager and group).
  The zOffset property is supported in the FillLayer, SymbolLayer, LineLayer and PolygonAnnotation now.
• A new option to control the radius of the tap area for TapInteraction, LongPressInteraction and interaction managers.
• Expression got a new convenience constructor to make building basic expressions much faster, e.g.: Exp(.eq, Exp(.get, "extrude"), "true").
• Add to-hsla expression support.
• Add an ImageOptions to specify image expression options.
• Expose a TileStore/clearAmbientCache() method to clear ambient cache.
• Add a new API to disable custom resizing implementation of the MapView. To disable the custom resizing implementation, set MapView/resizingAnimation to .none.
• Add a property emphasisCircleGlowRange to LocationIndicatorLayer to control the glow effect of the emphasis circle – from the solid start to the fully transparent end.
• Add support for pitchAlignment in BackgroundLayer.
• Add support for Base and Height alignment in FillExtrusionLayer. These properties will give you more control over building 3D rectangles on the terrain.
• Promoted from experimental to stable:
  • StyleImage
  • ClipLayer
• Add two separate Geofence examples in SwiftUI - GeofencingPlayground and GeofencingUserLocation.

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

v10.19.1

Changes

• Fix issue when highlighted state isn't being preserved across tile boundaries.

Dependencies

• Update MapboxCommon to 23.11.2.
• Update MapboxCoreMaps to 10.19.2:

Dependency requirements:

• Compatible version of Xcode: 14.1.0

v11.9.0-rc.1

Changes

• Add a new API to disable custom resizing implementation of the MapView. To disable the custom resizing implementation, set MapView.resizingAnimation to .none.
• Add to-hsla expression support.

Dependencies

• Update MapboxCommon to 24.9.0-rc.1.
• Update MapboxCoreMaps to 11.9.0-rc.1:

Dependency requirements:

• Compatible version of Xcode: 15.2.0

v11.5.3

Changes

• Add a way to filter attribution menu items.

Dependencies

• Update MapboxCommon to 24.5.0.
• Update MapboxCoreMaps to 11.5.3

Dependency requirements:

• Compatible version of Xcode: 15.2.0