OpenLayers
The 7.5.2 is a patch release that includes a fix for hit detection on Vector and VectorTile layers configured with declutter: true
. See the 7.5.0 release notes for a complete list of changes since the previous release.
The 7.5.1 is a patch release that includes a couple fixes to TypeScript declarations published with the package. See the 7.5.0 release notes for a complete list of changes since the previous release.
The 7.5 release includes a solid batch of new features and fixes. Among the improvements, you'll find more control over label decluttering, improved WebGL semi-transparent tile rendering, more consistency hit detecting transparent items, improvements with WebGL vector rendering, fixes for raster source loading, and more.
No special changes should be required when upgrading from previous 7.x releases. See the upgrade notes for a few minor changes in behavior.
See below for a complete list of features and fixes.
touch-action: none;
for elements in viewport (by @mike-000 in https://github.com/openlayers/openlayers/pull/14906)+nadgrids
for fromEPSGCode()
(by @mike-000 in https://github.com/openlayers/openlayers/pull/14692)geometry-type
operator, fix exponential interpolate
(by @jahow in https://github.com/openlayers/openlayers/pull/14837)Full Changelog: https://github.com/openlayers/openlayers/compare/v7.4.0...v7.5.0
The 7.4 release includes WebGL vector tiles along with several improvements to vector styling of WebGL layers, a new interaction for one-finger zooming on touch devices, and support for way geometries in the OSMXML parser. Several bug fixes for working with user projections and performance improvements for WebGL tile rendering are also on on board.
Full Changelog: https://github.com/openlayers/openlayers/compare/v7.3.0...v7.4.0
The 7.3 release includes rendering performance improvements with many layers, performance improvements when snapping during editing, and a handful of useful fixes. See the detailed list of changes below. Nothing special should be required when upgrading from the 7.2 release. Thanks to those who contributed!
See below for a complete list of features and fixes.
ol/View
when using useGeographic()
(by @kikuchan in https://github.com/openlayers/openlayers/pull/14531)event.key
instead of event.charCode
(by @WebKieth in https://github.com/openlayers/openlayers/pull/14492)isVisible()
and getAttributions()
methods on Layer (by @ahocevar in https://github.com/openlayers/openlayers/pull/14476)ol/source/Raster
(by @mike-000 in https://github.com/openlayers/openlayers/pull/14414)Full Changelog: https://github.com/openlayers/openlayers/compare/v7.2.2...v7.3.0
The 7.2.1 release is a patch to provide a working full build. See the changelog for 7.2.0 for new features and fixes since 7.1.
Full Changelog: https://github.com/openlayers/openlayers/compare/v7.2.0...v7.2.1
The 7.2.2 release adds back missing symbols to the full build. See the changelog for 7.2.0 for new features and fixes since 7.1.
Full Changelog: https://github.com/openlayers/openlayers/compare/v7.2.1...v7.2.2
The 7.2 release includes …
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).
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.
width
and height
configuration options to Icon
stylesIt 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.
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
.
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
.
See below for a complete list of features and fixes.
width
and height
to Icon style (by @KaiVolland in https://github.com/openlayers/openlayers/pull/14364)change:position
event is fired if identify transform used (by @mike-000 in https://github.com/openlayers/openlayers/pull/14319)ol/source/Raster
shared context (by @mike-000 in https://github.com/openlayers/openlayers/pull/14215)Full Changelog: https://github.com/openlayers/openlayers/compare/v7.1.0...v7.2.0
The 7.1 release adds a handful of new features and updates the story for users of the full library build.
The draw interaction has a new trace
option. When this is set, you can click on existing features to trace their outlines while creating new polygons or lines.
The GeoTIFF source now supports imagery with internal masks. In addition, the GeoTIFF source accepts a convertToRGB: 'auto'
setting. With this new setting, the values will be converted to RGB in cases where the input data has three bands and the photometric interpretation is one of CMYK, YCbCr, CIELab, or ICCLab.
If you have been using the full build of the library, we now include this full build in the release package. This should mean stable URLs that you can point to in a <script>
tag. See the https://openlayers.org/download/ page for more detail.
ol/AssertionError
and error codesFuture versions will no longer throw ol/AssertionError
with an error code
. Instead, they will throw Error
with just the error message.
ol/source/ImageWMS
and ol/source/TileWMS
The updateParams()
method is the only way to update WMS parameters. Changes made directly to the params
object passed as a constructor option will have no effect.
See below for a complete list of features and fixes.
Full Changelog: https://github.com/openlayers/openlayers/compare/v7.0.0...v7.1.0
The 7.0 release includes an impressive batch of features and fixes from over 90 pull requests. We're excited about a new foundation for WebGL vector rendering. The previous point rendering functionality has been extended to include lines and polygons. The rendering API is still low level and experimental. Future releases will include a higher level styling API.
In developing the new WebGL rendering functionality, we changed the signature for a number of methods on a helper class that had been marked as part of the API in 6.x releases. While this is technically a breaking change, it is unlikely that applications were using this helper class, so upgrades should be straightforward.
We took advantage of the breaking change in the WebGL helper class to remove a few other deprecated parts of the API. In addition, since Microsoft ended support for Internet Explorer a few months ago, we decided to do the same.
tilePixelRatio
has been removed from the DataTile
source.imageSmoothing
option has been removed from sources.undefinedHTML
option has been removed from the MousePosition
control.forEachLayerAtPixel
method has been removed from the Map
class.Overlay
component.labelCache
has been removed from the ol/render/canvas.js
module.Please see https://docs.microsoft.com/en-us/lifecycle/announcements/internet-explorer-11-end-of-support.
The Helper
constructor from the ol/webgl/Helper.js
module is no longer part of the public API.
The toStringHDMS
function from the ol/coordinate.js
module now formats longitude, latitude pairs so that the minutes and seconds are omitted if they are zero. This changes the values displayed on graticules.
The default intervals
now align with integer minutes and seconds better suited to the default label formatter. If formatting in decimal degrees you may wish to specify custom intervals
suited to that format.
Inserting with setAt
or insertAt
beyond the current length used to create a sparse Collection with undefined
inserted for any missing indexes. This will now throw an error instead.
The control will now by default keep displaying the last mouse position when the mouse leaves the viewport. With placeholder: ' '
you can keep the old behaviour. The placeholder
option no longer accepts false
as a valid value, instead simply omit the option. The undefinedHTML
option has been removed. You should use placeholder
instead.
The PluggableMap
class has been removed. If you want to create a custom map class, extend the Map
class instead.
ol/style/Image
and subclasses displacement
is no longer scaled with the image. If you previously expected this unintended behavior you should now increase the displacement when setting the scale.
See below for a complete list of features and fixes.
LUMINANCE_ALPHA
(by @mike-000 in https://github.com/openlayers/openlayers/pull/13974)tilePixelRatio
(by @mike-000 in https://github.com/openlayers/openlayers/pull/13930)change
event listeners where input
events are also used (by @mike-000 in https://github.com/openlayers/openlayers/pull/13932)imageSmoothing
source options (by @mike-000 in https://github.com/openlayers/openlayers/pull/13931)