Mapbox GL JS Release Notes

Features and improvements ✨

• Introduce the TileProvider API, a mechanism for extending GL JS with custom vector tile providers.
• Add first-class support for PMTiles via the new TileProvider API and an official plugin (mapbox-gl-pmtiles-provider.js) that loads on demand.
• Add experimental line-blend-mode property for rendering lines using additive or multiply blending.
• Slightly improve overall map loading times.
• Improve symbol layer rendering performance (by adopting Uniform Buffer Objects for data-driven properties).
• Improve indoor maps loading performance.

Bug fixes 🐞

• Fix dragging gesture not working on the compass control.
• Various fixes and improvements for the Appearances API.
• Fix an edge case when combining custom icons with images included in the style's sprite.
• Fix setWorldview not updating layout properties correctly.
• Fix an issue when rendering stacked underground 3D roads.
• Fix line dashes with non-integer total array lengths.
• Fix various rendering issues when using *-cutoff-fade-range properties.
• Fix clip layer not clipping fill-extrusion ambient occlusion.

Breaking changes ⚠️

• Removed mapbox-gl-unminified.js bundle in the distribution — please switch to either mapbox-gl.js, mapbox-gl-dev.js, or the new esm-min/mapbox-gl.js ESM bundle.
• Removed spriteFormat Map option — now Mapbox styles will always use vector icons, while non-Mapbox styles will continue using classic raster sprites.

3.19.0

Features and improvements ✨

• Promote elevated lines properties to stable: line-z-offset and line-elevation-reference.
• Add experimental text-size-scale-range and icon-size-scale-range style properties.
• Add experimental Map#setScaleFactor/Map#getScaleFactor methods for controlling symbol layer scaling.
• Apply global scale factor to images within text-field.
• Fix z-fighting for elevated raster layers.
• Add raster-elevation-reference paint property to elevate raster layers relative to ground instead of sea level.
• Add line-elevation-ground-scale layout property to scale elevated lines with terrain exaggeration.
• Use native async/await when loading models. Note: Please ensure GL JS is excluded from transpilation in your build setup.
• Explicitly state minimum supported browser versions in browserslist.
• Support pitch and distance expressions in filters.
• Support incremental updates when using setFeatureState.
• Add experimental Map#setNearClipOffset/Map#getNearClipOffset methods to control the near clip offset when ortohographic projections are used.

Bug fixes 🐞

• Fix RasterArrayTileSource#reload() not working correctly.
• Add request cancellation support to the ModelSource.
• Fix flickering of aliased thin lines.
• Fix elevated line bevel join artifacts at sharp corners.
• Fix regressions in NavigationControl.
• Fix namespace conflicts in different featuresets' selectors.
• Recalculate layers with visibility: none in case properties were changed.
• Fix bug in border update logic of fill-extrusion layer, overriding clip layer's behaviour.
• Fix empty tiles on non-integer maxZoom when terrain was used.
• Fix prototype pollution via Style JSON.

Features and improvements ✨

• Promote elevated lines properties to stable: line-z-offset and line-elevation-reference.
• Add experimental text-size-scale-range and icon-size-scale-range style properties.
• Add experimental Map#setScaleFactor/Map#getScaleFactor methods for controlling symbol layer scaling.
• Apply global scale factor to images within text-field.

Bug fixes 🐞

• Fix RasterArrayTileSource#reload() not working correctly.
• Add request cancellation support to the ModelSource.
• Fix flickering of aliased thin lines.
• Fix elevated line bevel join artifacts at sharp corners.

Features and improvements ✨

• Fix z-fighting for elevated raster layers.
• Add raster-elevation-reference paint property to elevate raster layers relative to ground instead of sea level.
• Add line-elevation-ground-scale layout property to scale elevated lines with terrain exaggeration.
• Use native async/await when loading models. Note: Please ensure GL JS is excluded from transpilation in your build setup.
• Explicitly state minimum supported browser versions in browserslist.

Bug fixes 🐞

• Fix regressions in NavigationControl.
• Fix namespace conflicts in different featuresets' selectors.
• Recalculate layers with visibility: none in case properties were changed.
• Fix bug in border update logic of fill-extrusion layer, overriding clip layer's behaviour.

Features and improvements ✨

• Add scaleFactor support for images within text-field.
• Add showButton option to GeolocateControl that allows hiding the control button.
• Add followUserLocation option and setFollowUserLocation method to GeolocateControl to control whether the map follows the user's location.
• Improve GeolocateControl timeout handling.
• Add support for text-rotate, text-size, and text-offset properties in appearances.
• Add shadow-draw-before-layer property to directional light, allowing control over shadow draw order in the layer stack.
• Add model-allow-density-reduction property to model layers. (h/t @JoshuaJMoore)

Bug fixes 🐞

• Fix interaction handlers not working on model layers.
• Fix stretchable icons without icon-text-fit rendering with an incorrect size.
• Fix icon-size not working correctly with coalesce expressions.
• Fix raster-color interpolation when using nearest raster-resampling.
• Fix render cut off for elevated raster-layer rendering in ortho projection range.
• Fix symbol placement with optional and missing parts.
• Expose all error properties for GeolocateControl error event (h/t @lucavb).
• Fix an error when querying multipolygons in dynamic: true mode.
• Fix AttributionControl links sanitization.
• Fix appearances with no icon-size using the default value instead of the layout-defined one.
• Fix updates to model source via ModelSource.setModels while models are still loading.
• Fix polygon clipping precision errors causing rendering artifacts in elevated structures.
• Preserve featuresets in map.getStyle() output.
• Expose TypeScript types from @mapbox/mapbox-gl-style-spec for direct imports.