v2.9.0

Important

⚠️ Breaking changes

• [Android] When a method returns StylePropertyValue the property values will now be typed rather than a string.
• PointAnnotation.iconImageCrossFade has been deprecated and setting a value to it will not have any impact. Use PointAnnotationManager.iconImageCrossFade instead.
• The STANDARD_EXPERIMENTAL style has been removed. Use the STANDARD style instead.

New Features ✨

• Expose new methods for working with style imports: addStyleImportFromJSON, addStyleImportFromURI, updateStyleImportWithJSON, updateStyleImportWithURI, and moveStyleImport.

• Introduce dragEvents API to the Annotation Managers to handle drag event callbacks for annotations:

  • onBegin: Called when a drag gesture starts on an annotation.
  • onChanged: Called continuously as the annotation is dragged.
  • onEnd: Called once the drag gesture completes.

  Example usage:

  manager.dragEvents(
    onBegin: (annotation) {
      print("Drag started for: ${annotation.id}");
    },
    onChanged: (annotation) {
      print("Dragging at: ${annotation.geometry}");
    },
    onEnd: (annotation) {
      print("Drag ended at: ${annotation.geometry}");
    },
  );

• Promote interaction APIs to stable. The following APIs are now stable:

  • MapboxMap.addInteraction
  • MapboxMap.removeInteraction
  • MapboxMap.setFeatureStateForFeaturesetDescriptor
  • MapboxMap.setFeatureStateForFeaturesetFeature
  • MapboxMap.getFeatureStateForFeaturesetDescriptor
  • MapboxMap.getFeatureStateForFeaturesetFeature
  • MapboxMap.removeFeatureStateForFeaturesetDescriptor
  • MapboxMap.removeFeatureStateForFeaturesetFeature
  • MapboxMap.resetFeatureStatesForFeatureset
  • MapboxMap.queryRenderedFeaturesForFeatureset

• Move experimental modelElevationReference property to LocationPuck3D.

Bug fixes 🐞

• In this release we fixed a bug in our Android conversion code where the property values in StylePropertyValue were being returned as strings rather than their actual type. This fix will cause a behavioral change in the return value of the following methods on Android:
  • getStyleImportConfigProperties, getStyleImportConfigProperty, getStyleLayerProperty, getStyleSourceProperty, getStyleTerrainProperty, getStyleLightProperty.
• Fixed an issue where style expressions did not override constant values when both were present.
• [ios] Fix crash when force unwrapping UIImage for point annotations.

Dependency Updates

• Update Mapbox Maps SDK to v11.13.0
  • For platform-specific updates see: iOS & Android