The 7.2 release includes …

• …some new features (e.g. for icon styling),
• …performance optimisations (e.g. for canvas rendering),
• …better interoperability (e.g. OGC API - Tiles support, saner projection-handling for GeoTIFFs and a new PMTiles example),
• …the usual smaller bugfixes, and
• …a lot of dependency updates.

Please find below four aspects of this release that we want to highlight and make sure to scan over the full list of included changes (even further below).

OGC vector and map tile sources are now a stable part of the API

The OGC API – Tiles core v1 spec has been published, and as a consequence we marked the long existing vector and map tile sources as part of the stable API.

Introduce width and height configuration options to Icon styles

It is now possible to create an icon symbolizer with an explicit width and/or height, e.g.:

const myIcon = new Icon({
  src: 'data/icon.png',
  width: 32,
  height: 32
});

This is an additional configuration option to make working with image icons easier.

Rendered resolutions of ol/source/Raster

Previously, ol/source/Raster processed input sources at the current view resolution, which caused interpolation artefacts in cases where input sources were up- or downsampled. Now, ol/source/Raster picks up the resolutions from the first input source that has resolutions configured (either implicitly through a tile grid in the case of tile sources, or directly when configured through the resolutions constructor option). This improves the rendered output in most cases.

If the previous behavior is desired, configure the source with resolutions: null.

Fixed wrapX behavior of ol/control/MousePosition

Previously, ol/control/MousePosition always displayed coordinates as-is. Now it has a wrapX option, which is true by default. This avoids longitudes aoutside the -180 to 180 degrees range.

If you want the previous behavior, which displays coordinates with longitudes less than -180 or greater than 180, configure the control with wrapX: false.

List of all changes

See below for a complete list of features and fixes.

• Fix types and docs for GeolocationError (by @ahocevar in https://github.com/openlayers/openlayers/pull/14395)
• Introduce width and height to Icon style (by @KaiVolland in https://github.com/openlayers/openlayers/pull/14364)
• Fix typo in Helper.js & inconsistency in ShaderBuilder.js comment. (by @Tomcariello in https://github.com/openlayers/openlayers/pull/14368)
• Rendering tests instead of unit tests for MapboxVector layer background (by @openlayers in https://github.com/openlayers/openlayers/pull/14355)
• Mark OGC tile sources as stable (by @tschaub in https://github.com/openlayers/openlayers/pull/14354)
• Calculate snap tolerance extent allowing for rotation (by @mike-000 in https://github.com/openlayers/openlayers/pull/14344)
• Updated extensions for Stamen tiles (by @tschaub in https://github.com/openlayers/openlayers/pull/14347)
• Convert closest point on geometry edge to user coordinates for snap (by @mike-000 in https://github.com/openlayers/openlayers/pull/14349)
• Fix immediate renderer image and text rotation in rotated canvas (by @mike-000 in https://github.com/openlayers/openlayers/pull/14333)
• Consider rotation when obtaining vector context pixel ratio (by @mike-000 in https://github.com/openlayers/openlayers/pull/14332)
• Update ArcGIS REST Feature Service example (by @mike-000 in https://github.com/openlayers/openlayers/pull/14296)
• Assign variable to work around swc minification problem (by @openlayers in https://github.com/openlayers/openlayers/pull/14320)
• Support better detection of projection in GeoTIFF files (by @ahocevar in https://github.com/openlayers/openlayers/pull/14321)
• Use ResizeObserver to detect resizes, also when in Shadow DOM (by @ahocevar in https://github.com/openlayers/openlayers/pull/14305)
• Ensure change:position event is fired if identify transform used (by @mike-000 in https://github.com/openlayers/openlayers/pull/14319)
• Rename numberSafeCompareFunction to ascending (by @tschaub in https://github.com/openlayers/openlayers/pull/14311)
• Change ela-compil url (by @fredj in https://github.com/openlayers/openlayers/pull/14301)
• Update sponsors (by @ahocevar in https://github.com/openlayers/openlayers/pull/14293)
• Remove unused arguments (by @ahocevar in https://github.com/openlayers/openlayers/pull/14292)
• Also set version in full build (by @openlayers in https://github.com/openlayers/openlayers/pull/14288)
• Update example showing COG with external overviews (by @tschaub in https://github.com/openlayers/openlayers/pull/14286)
• Add resolutions option to Raster source (by @ahocevar in https://github.com/openlayers/openlayers/pull/14282)
• Handle layers that do not have a source yet (by @openlayers in https://github.com/openlayers/openlayers/pull/14280)
• Remove Babel (by @tschaub in https://github.com/openlayers/openlayers/pull/14279)
• Configurable log level (by @tschaub in https://github.com/openlayers/openlayers/pull/14278)
• Update geotiff to v2.0.7 (by @ahocevar in https://github.com/openlayers/openlayers/pull/14257)
• Include file extensions in examples and docs (by @tschaub in https://github.com/openlayers/openlayers/pull/14263)
• Avoid creating tiles with one row each (by @tschaub in https://github.com/openlayers/openlayers/pull/14260)
• Add support for images in data tiles (by @tschaub in https://github.com/openlayers/openlayers/pull/14258)
• Add a PMTiles example (by @tschaub in https://github.com/openlayers/openlayers/pull/14256)
• Update more COG paths (by @mike-000 in https://github.com/openlayers/openlayers/pull/14252)
• Update ArcGIS MapServer examples service url (by @mike-000 in https://github.com/openlayers/openlayers/pull/14251)
• Use wkt definitions in EPSG.io Search example (by @mike-000 in https://github.com/openlayers/openlayers/pull/14239)
• Update COG path (by @mike-000 in https://github.com/openlayers/openlayers/pull/14236)
• Add wrapX support to the MousePosition control (by @openlayers in https://github.com/openlayers/openlayers/pull/14232)
• Minor fixes to ReprojDataTile tests (by @mike-000 in https://github.com/openlayers/openlayers/pull/14217)
• Pass transition option along to reproj data tile (by @tschaub in https://github.com/openlayers/openlayers/pull/14216)
• Set willReadFrequently option on ol/source/Raster shared context (by @mike-000 in https://github.com/openlayers/openlayers/pull/14215)
• Do not use .getImageData where .createImageData can be used (by @mike-000 in https://github.com/openlayers/openlayers/pull/14213)
• Set willReadFrequently option on pixel contexts (by @ahocevar in https://github.com/openlayers/openlayers/pull/14204)
• Create hit and taint detection canvas with willReadFrequently set to true (by @ahocevar in https://github.com/openlayers/openlayers/pull/14203)
• Use jsdelivr instead of unpkg (by @openlayers in https://github.com/openlayers/openlayers/pull/14200)
• Take scale transform into account for viewport pixels (by @ahocevar in https://github.com/openlayers/openlayers/pull/14199)
• Typo were => where (by @nboisteault in https://github.com/openlayers/openlayers/pull/14197)
• RenderFeature cannot be modified (by @MoonE in https://github.com/openlayers/openlayers/pull/14194)
• Typo (by @JakobMiksch in https://github.com/openlayers/openlayers/pull/14195)
• Translate interaction can't work with RenderFeature (by @MoonE in https://github.com/openlayers/openlayers/pull/14172)
• Only TileImage as ReprojTile source tile type (by @MoonE in https://github.com/openlayers/openlayers/pull/14173)
• Correct return type for ol/layer/VectorTile~getFeatures() (by @MoonE in https://github.com/openlayers/openlayers/pull/14165)
• Use arrow functions instead of binding anonymous functions (by @tschaub in https://github.com/openlayers/openlayers/pull/14170)
• Fix if condition in clusters-dynamic example (by @ahocevar in https://github.com/openlayers/openlayers/pull/14150)
• hitdetect GeometryCollection (by @MoonE in https://github.com/openlayers/openlayers/pull/14138)
• Make track properties in Link interaction configurable (by @ahocevar in https://github.com/openlayers/openlayers/pull/14126)
• Add a sourceready event to layers (by @tschaub in https://github.com/openlayers/openlayers/pull/14124)
• Add support for fetching proj4 definitions from epsg.io (by @tschaub in https://github.com/openlayers/openlayers/pull/14122)
• Avoid the redirect to the OL 2 page (by @tschaub in https://github.com/openlayers/openlayers/pull/14118)
• No else after return (by @tschaub in https://github.com/openlayers/openlayers/pull/14103)
• Fix WMTS source key (by @ahocevar in https://github.com/openlayers/openlayers/pull/14100)
• Reproject DataTiles (by @mike-000 in https://github.com/openlayers/openlayers/pull/13654)
• Updates for ol-mapbox-style v9.2 (by @ahocevar in https://github.com/openlayers/openlayers/pull/14086)
• Add version dropdown for API link (by @KaiVolland in https://github.com/openlayers/openlayers/pull/14085)
• Updates for the 7.1.0 release (by @openlayers in https://github.com/openlayers/openlayers/pull/14082)

New Contributors

• @nboisteault made their first contribution in https://github.com/openlayers/openlayers/pull/14197
• @Tomcariello made their first contribution in https://github.com/openlayers/openlayers/pull/14368

Full Changelog: https://github.com/openlayers/openlayers/compare/v7.1.0...v7.2.0