6.5.0

With more than 110 pull requests, this release not only brings WFS 2.0 support and improved touch support for drawing geometries and querying features. In addition to that, several improvements, many bugs fixes, and nicer API docs and examples have found their way into the 6.5.0 release.

Upgrade notes

Units of the hitTolerance option fixed

Previously, the hitTolerance option of the map's getFeaturesAtPixel(), forEachFeatureAtPixel() and hasFeatureAtPixel() methods behaved differently depending on the devicePixelRatio (or the pixelRatio of the map), because the original value was internally multiplied by the device pixel ratio twice instead of just once. Now this is fixed. Note: The hitTolerance's units are css pixels. The documentation was updated to reflect this.

If your application adjusts for that with code like

{ hitTolerance: 10 / devicePixelRatio, }

you'll have to change that code to

{ hitTolerance: 10, }

New features and improvements

• New scale option in RegularShape and Circle style constructors
• WFS 2.0.0 support
• Added preRender and postRender methods to WebGLLayerRenderer
• Added className constructor option in ol/layer/Heatmap
• Added load events for ol/source/Vector
• New iconUrlFunction option for ol/format/KML
• Added transition option to OSM and CartoDB sources
• DragAndDrop interaction support for formats that read ArrayBuffer sources
• New padding option for ol/View
• New cancel event for the DragBox interaction
• When using hitTolerance, detect closest features first
• Ability to draw Circle geometries with a custom renderer

List of all changes

• #11859 - Do not fire duplicate postrender events (@MoonE)
• #11858 - Correct documented event names for VectorSourceEvent (@MoonE)
• #11844 - Fix Style expressions error message (@MoonE)
• #11838 - Custom circle render (@changqingom)
• #11811 - Better getPointResolution default when no transform available (@mike-000)
• #11821 - Call the finishCondition when drawing points / circles (@MoonE)
• #11824 - Add Units back to API docs (@ahocevar)
• #11817 - stopPropagation support for PluggableMap (@greggian)
• #11815 - Remove unnecessary line that breaks drawing with multi-touch (@ahocevar)
• #11800 - Fix removeLastPoint when removing last point (@ahocevar)
• #11769 - Modify interaction developer experience improvements (@ahocevar)
• #11803 - Modify fix vertex insertion (@MoonE)
• #11783 - Cache hit detect indexes and check closest pixels first. (@MoonE)
• #11791 - Now that pepjs was updated, we can point to the official package (@ahocevar)
• #11790 - Fix attributions links for WMS layers from swisstopo (@openlayers)
• #11781 - Pass geometry to forEachFeatureAtPixel callback (@ahocevar)
• #11778 - No need to adjust hitTolerance for pixel ratio twice (@ahocevar)
• #11780 - Add a cancel event to the DragBox interaction (@M393)
• #11779 - Restore Mode.CIRCLE in Draw interaction (@mike-000)
• #11753 - Use Mode.LINE_STRING in Draw interaction for Circle geometries (@mike-000)
• #11767 - Improve documentation of geometry rotation (@mike-000)
• #11755 - Add padding option for View (@ahocevar)
• #11754 - Fix typo that prevents Rotate icon from indicating the view rotation (@ahocevar)
• #11719 - Clamp EPSG:3857 y to lowest/highest possible value instead of validity extent (@ahocevar)
• #11737 - Write the correct SRS code in EsriJSON (@ahocevar)
• #11749 - Document that snapTolerance must be greater than 0 (@ahocevar)
• #11750 - Update TMS tileUrlFunction example in ol/source/XYZ documentation (@mike-000)
• #11739 - Fix: Check for layer extent in CanvasLayerRenderer.getDataAtPixel (@boeckMt)
• #11748 - Add fetch and TextDecoder to polyfill list in README (@mike-000)
• #11740 - Wfs bbox per feature type (@ger-benjamin)
• #11722 - Correct meaning of 'start' and 'end' text align for LTR text (@ahocevar)
• #11741 - Include LICENSE.md in built package (@bz2)
• #11718 - Initialize sketch point on Draw#extend() (@ahocevar)
• #11732 - Replace readURI with readStyleURL for KML StyleURLs (@mike-000)
• #11723 - Drag and Drop Interaction support for formats that read ArrayBuffer sources (@mike-000)
• #11724 - Add transition option to OSM and CartoDB sources, document default (@MoonE)
• #11721 - Handle empty Z coordinates in KML (@mike-000)
• #11587 - Determine orientation by actual text start and end x (@MoonE)
• #11720 - Return to simpler and less efficient winding order algorithm (@ahocevar)
• #11715 - Add all symbols to the legacy build (@ahocevar)
• #11716 - Treat svg as binary resource (@mike-000)
• #11698 - Draw pointer improvements (@ahocevar)
• #11490 - iconUrlFunction option for ol/format/KML (@mike-000)
• #11628 - VectorSource load events (@simonseyock)
• #11691 - Use Parcel v2 in copy/paste example code (@ahocevar)
• #11673 - Do not emulate dblclick and slingleclick on multi-touch (@ahocevar)
• #11676 - Fix countries.geojson Antarctica polygon so it wraps correctly (@mike-000)
• #11646 - Ensure a unique tile key for each tile coordinate (@ahocevar)
• #11655 - Fix documentation of image render mode for vector tile layers (@ahocevar)
• #11668 - Don't try to get image data for zero sized images (@tapioko)
• #11648 - Dwithin filter (@virtualcitySYSTEMS)
• #11658 - Make webpack dev server run with current version (@MoonE)
• #11590 - Export all the Event sub class (@sbrunner)
• #11594 - Display current OS copyright date in the Raster Reprojection example (@mike-000)
• #11657 - Use https to avoid security warnings (@mike-000)
• #11649 - Deal with undefined units from proj4 longlat projections (@ahocevar)
• #11403 - #11402 add CSS class name support for control buttons (@cazacugmihai)
• #11592 - New decluttering implementation (@ahocevar)
• #11618 - Update the Marker Animation example (@mike-000)
• #11620 - Add charset to the examples html below the map (@MoonE)
• #11613 - Allow mouse input if map is rendered in an other window (@elnabo)
• #11597 - Improved performance when removing feature with only one Select (@MoonE)
• #11607 - Reset attributions control to collapsible when no uncollapsible sources are visible (@mike-000)
• #11609 - Modify interaction insert only one vertex (@M393)
• #11605 - Remove context references when releasing tiles (@ahocevar)
• #11591 - Make permalink example less complex (@kannes)
• #11569 - Fix binary data exports to codesandbox in examples (@mike-000)
• #11579 - Replace Animated GIF example globe gif (@mike-000)
• #11565 - Animated GIF example (@mike-000)
• #11571 - Replace countryflags.io with flagcdn.com in the Style Renderer example (@mike-000)
• #11568 - Fix raster source crash bug when using multiple threads (@rgroothuijsen)
• #11563 - Fix end world calculation if projection is not symmetric (@MoonE)
• #11561 - Constrain resolution when fit called without duration (@M393)
• #11559 - Only draw visible worlds (@MoonE)
• #11519 - Do not draw multipoints outside render extent (@MoonE)
• #11532 - Make TileGrid behave as documented with extent and sizes options (@ahocevar)
• #11545 - Use the className param in ol.layer.Heatmap (@fredj)
• #11548 - Bind tileUrlFunction before returning it from getTileUrlFunction (@ahocevar)
• #11549 - Only use elementFromPoint with ShadowRoot (@ahocevar)
• #11502 - Fix issue with WMS Capabilities containing a single layer (@jbelien)
• #11540 - Avoid unnecessary transform in the MVT format (@gberaudo)
• #11537 - Add rotation and rotateWithView to ol/style/Circle clone method and options (@mike-000)
• #11543 - wmts matrixset null pointer fix and improved handling of Identifier (@sweco-dkjesh)
• #11509 - Add urn:x-ogc:def:crs:EPSG:6.6:4326 as WGS84 proj identifier (@fgravin)
• #11521 - Do not use fractional pixel ratio for rendering vector tiles (@ahocevar)
• #11517 - Make clockwise check work when coordinates are duplicated (@ahocevar)
• #11501 - Empty this.canvas_ for all pixel ratios when render() is called (@mike-000)
• #11471 - Feature: added preRender and postRender methods to WebGLLayerRenderer… (@MichaelLangbein)
• #11491 - Cosmetic fix to doc (missing closing quote) (@mike-000)
• #11488 - "Layer Z-Index" example bugfix (@michalzielanski)
• #11486 - guard for null (@davidiamaf)
• #11481 - Adding original properties to cloned geometry (@michalzielanski)
• #11404 - Add security scan (@tschaub)
• #11470 - Fix pointer events polyfill link (@ahocevar)
• #11467 - Style renderer example (@ahocevar)
• #11455 - Apidoc improvements (@MoonE)
• #11474 - fix: modify rbush package import (@haasz)
• #11472 - Typescript 4.0.2 (@ahocevar)
• #11454 - VectorTile source projection has to match the view projection (@ahocevar)
• #11438 - Better scroll behaviour for apidocs (@MoonE)
• #11446 - Checks before calling handleEvent on interactions (@ahocevar)
• #11305 - PluggableMap: avoid crash when multiple interactions are removed (@megawac)
• #11433 - Fix typo in module name (@fredj)
• #11419 - WFS 2.0.0 support (@bjornharrtell)
• #11418 - Icon color default to composite operation (@MoonE)
• #11416 - Examples add labels to inputs (@MoonE)
• #11417 - Fix sort order of examples search results (@ahocevar)
• #11413 - Include scale option in RegularShape and Circle style constructors (@mike-000)
• #11401 - Ensure image extent is valid when scale is negative (@mike-000)
• #11395 - Correct inchesPerMeter and add tests for ScaleBar text (@mike-000)
• #11407 - Support deprecated coordinates element for GML3+ formats (@bjornharrtell)
• #11398 - Fix link to workshop / download (@MoonE)
• #11391 - Simplify scale calculation used for WMS getLegendUrl() (@mike-000)