mapbox_maps_flutter

What's new ✨

• Add LineLayer.lineBorderGradient and .lineBorderGradientExpression to color a line's border along its length with a gradient driven by line-progress. Requires a GeoJSON source with lineMetrics: true.
• RenderedQueryGeometry is now a sealed class hierarchy (ScreenCoordinateRenderedQueryGeometry, ScreenBoxRenderedQueryGeometry, ScreenCoordinateListRenderedQueryGeometry) instead of an untyped {value, type} pair. Construct it the same way as before, via fromScreenCoordinate()/fromScreenBox()/fromList(). Use pattern matching on the subclasses to inspect it instead of the now-deprecated, read-only value/type accessors.

Bug fixes 🐞

• Fix an uncatchable crash in MapWidget when the platform view is created before layout completes, on iOS (always) and Android's HC hosting mode (the default) (#1141).
• [web] Fix queryRenderedFeatures querying the whole viewport for an empty fromList([]); it now matches no features, in line with mobile.

Platform API coverage

Web support is actively being developed. Not all APIs available on iOS and Android are supported on web yet — full parity is coming in future releases. APIs that are not available on a given platform will throw UnimplementedError at runtime.

Dependency Updates

• Update Mapbox Maps SDK to v11.29.0
  • For platform-specific updates see: iOS & Android
• Update GL JS to v3.29.0
  • See changelog

Dependency Updates

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

• Update Maps SDK to v11.29.0

Dependency Updates

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

Dependency Updates

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

• Update Maps SDK to v11.28.3

Dependency Updates

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

• Update Maps SDK to v11.28.2

• Update Maps SDK to v11.28.1

• Add ModelSource API, exposing the 3D model source (a collection of 3D models, each with its own position, orientation, and node/material overrides).
• Add MapWidget.isOpaque option to control whether the map is rendered as opaque or supports a transparent background. Set to false (together with a transparent style) to enable transparency on iOS; Android already supports this via MapWidget.textureView (#415).
• [iOS] Fix updateSettings on CompassSettings, AttributionSettings, LogoSettings, IndoorSelectorSettings, ScaleBarSettings, GesturesSettings, and LocationComponentSettings resetting omitted fields (position, margins, enabled, scrollMode, puck configuration) to defaults instead of preserving them, matching Android's partial-update behaviour.
• [Android] Fix LocationComponentSettings.updateSettings dropping the previously configured 2D or 3D puck's settings when switching between puck types.

Dependency Updates

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

• Update Maps SDK to v11.27.2

• [iOS] Support GesturesSettings.scrollDecelerationEnabled on iOS (#1127).
• [Android] Migrate to built-in Kotlin.
• Add MapboxMap.httpService.setCustomHeadersForHost to attach custom HTTP headers to a single host only, and MapboxMap.httpService.clearCustomHeaders to remove all configured headers. Host-scoped headers are matched against the request's exact URL host (case-insensitive, no subdomain or substring matching).
• Deprecate MapboxMap.setCustomHeaders: headers set this way are attached to every host the map fetches from — including third-party hosts referenced by styles, sources, sprites, glyphs and tiles — which can leak credentials. Use setCustomHeadersForHost instead.

• [iOS] Fix iOS compass ignoring CompassSettings.fadeWhenFacingNorth (and visibility in general) unless enabled was also set. enabled and fadeWhenFacingNorth are now applied independently, matching the Android behaviour (#602).
• [Android] Use flutter.compileSdkVersion to align Android compileSdk with Flutter SDK

Dependency Updates

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

• Update Maps SDK to v11.25.3

• Deprecate MapboxMap.onTapListener and MapboxMap.onLongTapListener in favor of the MapboxMap.addInterfaction API.
• Add MapboxMap.httpService.setMaxRequestsPerHost to cap the number of concurrent HTTP requests per host issued by the underlying HTTP service. Useful for reducing the chance of hitting per-token rate limits during offline tile region downloads.

• Add TileStore.setOptionForKey to allow setting custom tile store options by arbitrary string key, in addition to the existing predefined options (diskQuota, mapboxApiUrl, tileUrlTemplate).

• Deprecate MapWidget.cameraOptions in favor of the viewport API.
• Deprecate MapWidget.onTapListener and MapWidget.onLongTapListener in favor of the MapboxMap.addInteraction API.

• Update Maps SDK to v11.22.0