v11.13.1

Bug fixes 🐞

• Apply a more robust policy for retrying failed network requests
• Fix a memory leak during icon rasterization

Dependencies

• Update MapboxCommon to 24.13.1.
• Update MapboxCoreMaps to 11.13.1:

Dependency requirements:

• Compatible version of Xcode: 16.2

v11.13.0

Breaking changes ⚠️

• The experimental style MapStyle.standardExperimental is removed. Use MapStyle.standard instead.
• PointAnnotation.iconImageCrossFade has been deprecated and setting value to it will not have any impact. Use PointAnnotationManager.iconImageCrossFadeTransition instead.

Features ✨ & Improvements 🏁

• The Interactions and Featuresets API is promoted from experimental. It allows you to add interaction handlers to layers, Standard Style Featuresets (POI, Buildings and Place Labels), and the map itself in the consistent way. You can control the propagation of events, tappable area, and the order of event handling.
• Methods GestureManager.onMapTap, GestureManager.onMapLongPress, GestureManager.onLayerTap, GestureManager.onLayerLongPress and their SwiftUI counterparts are deprecated. Use TapInteraction and LongPressInteraction instead.

// Before (SwiftUI)
Map()
    .onMapTapGesture { context in
        // Handle tap on map
    }
    .onLayerLongPressGesture("a-layer-id") { feature, context in
        // Handle press on a layer
        return true
    }

// After (SwiftUI)
Map {
    TapInteraction { feature in
        // Handle tap on map
        return true
    }

    LongPressInteraction(.layer("a-layer-id")) { feature, context in
        // Handle press on a layer
        return true
    }

    // Bonus: If you use Standard style, new API allows to handle tap on POI, Buildings and Place Labels
    TapInteraction(.standardPoi) { poi, feature in
        print("Tap on \(poi.name)")
        return true
    }
}

// Before (UIKit)
mapView.gestures.onMapTap.observe { context in
    // Handle Tap on Map
}.store(in: &cancelables)

mapView.gestures.onLayerLongPress("a-layer-id") { feature, context in
    // Handle Long press
    return true
}

// After (UIKit)
mapView.mapboxMap.addInteraction(TapInteraction { context in
    // Handle tap on map
    return true
})

mapView.mapboxMap.addInteraction(LongPressInteraction(.layer("a-layer-id")) { feature, context in
    // Handle long press on a layer
    return true
})

// Bonus: If you use Standard style, new API allows to handle tap on POI, Buildings and Place Labels
mapView.mapboxMap.addInteraction(TapInteraction(.standardPoi) { poi, feature in
    print("Tap on poi \(poi.name)")
    return true
})

• Custom Layer Matrices API on Globe for Mobile
  Introducing the CustomLayerMapProjection, accessible via the CustomLayerRenderParameters instance. This new API provides utility functions for rendering primitives on the currently active map projection.
  Check out the CustomLayerExample.swift file for example usage of these new APIs.

  

• Introduce experimental worldview expression.
• Add new VectorSource.promoteId2 and GeoJSONSource.promoteId2. Deprecate VectorSource.promoteId and GeoJSONSource.promoteId. The newer version support the expression variant of promoteId, which can be used to dynamically nominate IDs to the features.
• Expose new experimental properties: CircleLayer.circleElevationReference, FillLayer.fillConstructBridgeGuardRail, FillLayer.fillBridgeGuardRailColor, FillLayer.fillTunnelStructureColor.
• Expose new showLandmarkIcons property in MapStyle.standard.
• New example for elevated spiral line. Utilized the experimental API LineLayer/linezOffset.
• Update Dynamic View Annotations to avoid overlapping symbol layers
• StyleManager.image(withId:) can now retrieve vector icons
• New at-interpolated expression added and separated from existing at expression.
• Tile pack v2 format will now be used by default for endpoints that support it
• Add support for shadows on elevated symbols
• Support *colorUseTheme for Rain and Snow properties
• Elevated bridge rail guard style support for color, emissive strength and enable/disable rail guard

Bug Fixes 🐞

• Fixed disappearing volatile tiles on camera changes in offline mode when maximumStaleInterval is set.
• Resolved frequent DVA repositioning issues.
• Fixed fill patterns for elevated roads.
• Tiles are now properly reloaded when the language setting is removed.
• Limited the collision grid size for view annotations to improve performance.
• Fix elevated lines rendering regression
• Fix incorrect placement for symbols with symbol-z-elevate on Globe projection
• Elevated symbol heights now change as smooth as building heights
• Fix map flickering caused by the fill-extrusion pan tiles and missing stencil in 3D layers
• Fix unstable placement for elevated symbols
• Fix icon rasterization issue with luminance mask contexts
• Fix clipPath and mask rendering for vector icon rasterization
• Fix symbol order when SymbolLayer.symbolZElevate is true.
• Fix issue that promoteId content is missing after vector source serialization
• Fix semi-transparent landmark icons
• Return null for config expression if requested config option is missing
• Fix dotted lines on tile borders
• Fix pattern not found error when using imports
• Fix line layer not rendering when using LineLayer.linePattern inside an imported style
• Fix flickering of elevated HD roads
• Fix ground effect gradient not working with multiple polygons
• Fix invisible line when interpolating LineLayer.lineWidth from 0 to 1 using line-progress
• Fix temporary allocations in getDashPatternTexture
• Fix a bug where cameraForCoordiantes with screen box oscillates when initial zoom is close to set max zoom
• Skip unneeded tiles relayout when landmark icons get enabled
• Fix a crash in disk cache code when fetching a high-zoom (z > 16) tile

💫️ Optimizations and other updates

• Remove confusing error message when events are disabled and not sent
• Tiled model translation support for 3D models
• Flood light ground effect now shown on top of 3D objects
• Support mapbox:// tile URLs without version and tiles
• Reduce excessive allocations on the tile pyramid nodes re-creation
• Avoid crash during centroid computation

Dependencies

• Update MapboxCommon to 24.13.0.
• Update MapboxCoreMaps to 11.13.0.

Dependency requirements:

• Compatible version of Xcode: 16.2

v11.13.0-rc.1

Features ✨ & Improvements 🏁

• Custom Layer Matrices API on Globe for Mobile
  Introducing the CustomLayerMapProjection, accessible via the CustomLayerRenderParameters instance. This new API provides utility functions for rendering primitives on the currently active map projection.
  Check out the CustomLayerExample.swift file for example usage of these new APIs.

  

---

Bug Fixes 🐞

• Fixed disappearing volatile tiles on camera changes in offline mode when maximumStaleInterval is set.
• Resolved frequent DVA repositioning issues.
• Fixed fill patterns for elevated roads.
• Tiles are now properly reloaded when the language setting is removed.
• Limited the collision grid size for view annotations to improve performance.

---

Dependencies

• Updated MapboxCommon to 24.13.0-rc.1
• Updated MapboxCoreMaps to 11.13.0-rc.1

Dependency Requirements

• Compatible Xcode version: 16.2

v11.12.2

Changes

• Limit view annotations collision grid size

Dependencies

• Update MapboxCommon to 24.12.2.
• Update MapboxCoreMaps to 11.12.2.

Dependency requirements:

• Compatible version of Xcode: 16.2.0

v11.13.0-beta.1

Changes

Breaking changes ⚠️

• The experimental style MapStyle.standardExperimental is removed. Use MapStyle.standard instead.
• PointAnnotation.iconImageCrossFade has been deprecated and setting value to it will not have any impact. Use PointAnnotationManager.iconImageCrossFadeTransition instead.

Features ✨ and improvements 🏁

• The Interactions and Featuresets API is promoted from experimental. The new API allows you to add interaction handlers to layers, Standard Style featuresets (POI, Buildings and Place Labels), and the map itself in the consistent way. You can control the propagation of events, tappable area, and the order of event handling.
  • Methods GestureManager.onMapTap, GestureManager.onMapLongPress, GestureManager.onLayerTap, GestureManager.onLayerLongPress and their SwiftUI counterparts are deprecated. Use TapInteraction and LongPressInteraction instead.

// Before (SwiftUI)
Map()
    .onMapTapGesture { context in
        // Handle tap on map
    }
    .onLayerLongPressGesture("a-layer-id") { feature, context in
        // Handle press on a layer
        return true
    }

// After (SwiftUI)
Map {
    TapInteraction { feature in
        // Handle tap on map
        return true
    }

    LongPressInteraction(.layer("a-layer-id")) { feature, context in
        // Handle press on a layer
        return true
    }

    // Bonus: If you use Standard style, new API allows to handle tap on POI, Buildings and Place Labels
    TapInteraction(.standardPoi) { poi, feature in
        print("Tap on \(poi.name)")
        return true
    }
}

// Before (UIKit)
mapView.gestures.onMapTap.observe { context in
    // Handle Tap on Map
}.store(in: &cancelables)

mapView.gestures.onLayerLongPress("a-layer-id") { feature, context in
    // Handle Long press
    return true
}

// After (UIKit)
mapView.mapboxMap.addInteraction(TapInteraction { context in
    // Handle tap on map
    return true
})

mapView.mapboxMap.addInteraction(LongPressInteraction(.layer("a-layer-id")) { feature, context in
    // Handle long press on a layer
    return true
})

// Bonus: If you use Standard style, new API allows to handle tap on POI, Buildings and Place Labels
mapView.mapboxMap.addInteraction(TapInteraction(.standardPoi) { poi, feature in
    print("Tap on poi \(poi.name)")
    return true
})

• Add new VectorSource.promoteId2 and GeoJSONSource.promoteId2. Deprecate VectorSource.promoteId and GeoJSONSource.promoteId. The newer version support the expression variant of promoteId, which can be used to dynamically nominate IDs to the features.
• Expose new experimental properties: CircleLayer.circleElevationReference, FillLayer.fillConstructBridgeGuardRail, FillLayer.fillBridgeGuardRailColor, FillLayer.fillTunnelStructureColor.
• Expose new showLandmarkIcons property in MapStyle.standard.
• New example for elevated spiral line using the experimental API LineLayer/linezOffset.

Update MapboxCoreMaps to 11.13.0-beta.1:

Features ✨ and improvements 🏁

• Update Dynamic View Annotations to avoid overlapping symbol layers
• StyleManager.getStyleImage() can now retrieve vector icons
• New at-interpolated expression added and separated from existing at expression.
• Tile pack v2 format will now be used by default for endpoints that support it
• Add support for shadows on elevated symbols
• Add screenShape MapOption for better culling on non-rectangular displays
• Support color-use-theme for rain and snow
• Elevated bridge rail guard style support for color, emissive strength and enable/disable rail guard

Bug fixes 🐞

• Fix elevated lines rendering regression. Original report here.
• Fix incorrect placement for symbols with symbol-z-elevate on Globe projection
• Elevated symbol heights now change as smooth as building heights
• Fix map flickering caused by the fill-extrusion pan tiles and missing stencil in 3D layers
• Fix unstable placement for elevated symbols
• Fix icon rasterization issue with luminance mask contexts
• Fix clipPath and mask rendering for vector icon rasterization
• Fix symbol order when symbol-z-elevate is true
• Fix issue that promoteId content is missing after vector source serialization
• Fix semi-transparent landmark icons
• Return null for config expression if requested config option is missing
• Fix dotted lines on tile borders
• Fix pattern not found error when using imports
• Fix line layer not rendering when using line-pattern inside an imported style
• Fix flickering of elevated HD roads
• Fix ground effect gradient not working with multiple polygons
• Fix invisible line when interpolating line-width from 0 to 1 using line-progress
• Fix temporary allocations in getDashPatternTexture

💫️ Optimizations and other updates

• Remove confusing error message when events are disabled and not sent
• Tiled model translation support for 3D models
• Flood light ground effect now shown on top of 3D objects
• Support mapbox:// tile URLs without version and tiles
• Reduce excessive allocations on the tile pyramid nodes re-creation
• Avoid re-allocations per frame on tileclippingMasksIDs
• Use LayerUID uint16_t instead of std::string for map keys
• Add simple bounds check to avoid crash during centroid computation

Update MapboxCommon to 24.13.0-beta.1:

Features ✨ and improvements 🏁

• Support radius individually per point geofence geometry

Bug fixes 🐞

• Fix possible offline cache migration issues
• Fix iOS 18.4-18.5 network issues
• Fix possible crashes in HTTP requests processing in case of invalid UTF-8 headers

Dependency requirements:

• Compatible version of Xcode: 16.2

v11.12.1

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

v11.12.0

Features ✨ and improvements 🏁

• Mapbox Geofencing is now available in public preview. Follow the documentation and code examples for iOS and Android to get started.
  
• Advanced performance reports now provide more GPU-oriented data. Check out:
  • CumulativeRenderingStatistics/graphicsPrograms
  • CumulativeRenderingStatistics/graphicsProgramsCreationTimeMillis
  • CumulativeRenderingStatistics/fboSwitchCount.
• Experimental support for non-rectangular screen shapes with a new MapboxMap/screenCullingShape property.

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

11.11.1

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.

v11.12.0-rc.1

Features ✨ and improvements 🏁

• Exposed an experimental API to define a non-rectangular screen culling shape MapboxMap.screenCullingShape.

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

v11.12.0-beta.1

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.