mapbox-gl

With this release, we're adding a new changelog policy to our contribution guidelines.

This release also fixes several long-standing bugs and unintentional rendering behavior with line-pattern. The fixes come with a visual change to how patterns added with line-pattern scale. Previously, patterns that became larger than the line would be clipped, sometimes distorting the pattern, particularly on mobile and retina devices. Now the pattern will be scaled to fit under all circumstances. #9266 showcases examples of the visual differences. For more information and to provide feedback on this change, see #9394.

Features

• Add within expression for testing whether an evaluated feature lies within a given GeoJSON object (#9352).

  • We are aware of an edge case in which points with wrapped coordinates (e.g. longitude -185) are not evaluated properly. See (#9442) for more information.

  • An example of the within expression:
    "icon-opacity": ["case", ["==", ["within", "some-polygon"], true], 1, ["==", ["within", "some-polygon"], false], 0]

• Map API functions such as easeTo and flyTo now support padding: PaddingOptions which lets developers shift a map's center of perspective when building floating sidebars

Improvements

• Results from queryRenderedFeatures now have evaluated property values rather than raw expressions

• Improve scaling of patterns used in line-pattern on all device resolutions and pixel ratios

• Slightly improve GPU memory footprint

• LngLatBounds.extend is more flexible because it now accepts objects with lat and lon properties as well as arrays of coordinates

• Reduce bundle size and improve visual quality of showTileBoundaries debug text

Bug fixes

• Correctly adjust patterns added with addImage(id, image, pixelRatio) by the asset pixel ratio, not the device pixel ratio

• Allow needle argument to in expression to be false

• Fix exception thrown when trying to set feature-state for a layer that has been removed, fixes #8634

• Fix a bug where maps were not displaying inside elements with dir=rtl

• Fix a rendering error for very old versions of Chrome (ca. 2016) where text would appear much bigger than intended

• Prevent exception resulting from line-dash-array of empty length

• Fix a bug where icon-image expression that evaluates to an empty string ('') produced a warning

• Fix a bug where certain popup methods threw errors when accessing the container element before it was created, fixes #9429