MapGL API Release notes

There are two ways to choose MapGL version:

(recommended) major version: https://mapgl.2gis.com/api/js/v1
fixed version: https://mapgl.2gis.com/api/js/v1.6.2

Major version guarantees to have stable API (breaking changes will land into the next major version). It is updated regularly with new features, bug fixes and performance improvements.

Fixed version does not have any updates. That's why it has a short support period of 3 months after a new version is released. We guarantee that the version will be working during the support period. The only reason to choose fixed version is when you need Subresource Integrity (SRI). Because of short support period you have to update the version regularly.

v1.6.2

URL: https://mapgl.2gis.com/api/js/v1.6.2

SRI: sha512-Qd8FJ4dTV0r7QlO5EZ/bH3eJHryP5F2JlGgSLpm16hKxd3v+YAx2fALVs2qdO8hKWD1FR6vpvuuqaioWbA08mQ==

Release Date: 24.12.2020

Fixed a bug where the inertia of the map doesn't work if a styleZoom was set

v1.6.1

URL: https://mapgl.2gis.com/api/js/v1.6.1

SRI: sha512-bvhJrH7/tuHmfLODpVydlwpKOhLXPvWLoiQ0ekhz6UGrzLnRkV30W7imPBstY/CFBB/nDwUVeoaY8JBCSq2TsA==

Release Date: 22.12.2020

Support End Date: 24.03.2021

Fixed the map center changing behavior by setting different zoom types. If a styleZoom option was set, the map style zoom doesn't change while map dragging. Conversely, if a zoom option was set — the map zoom doesn't change, but the style zoom does.

v1.6.0

URL: https://mapgl.2gis.com/api/js/v1.6.0

SRI: sha512-HDATpIofgFh3SujGnHfWkSTs8jOHMHMvS4cYBr9S3vqsbCVkh9o+UEpaBI9N7OeG4IiyYA0sN+cgvM3MoRXs1A==

Release Date: 18.12.2020

Support End Date: 22.03.2021

Added a new map option styleZoom. This option allows you to set the same zoom that is used in the style settings. The styleZoom and zoom options set the same map scale but in different projections.
Added a new method setLanguage to change the desired map language. The map will try to set the language if it possible.
Added a new method getLanguage, which returns the desired map language.
Fixed a bug with touch events that leads to the exception with undefined.

v1.5.0

URL: https://mapgl.2gis.com/api/js/v1.5.0

SRI: sha512-/Hw2egQaYHHPB1n0gd5bjYW+nJVHPWL4jgtlxe9XPpmPTmHlM8+MuoW2zDkujS4T/Ws1R1+DNfSYpxedHy/peA==

Release Date: 10.12.2020

Support End Date: 18.03.2021

Added a new method setStyleById to change the map style by its ID. 🎉
Added a new map option defaultBackgroundColor. This option allows you to set the default background color while style is loading.
Added a new map option style that takes a style ID. The map will be initialized with the specified style.

v1.4.3

URL: https://mapgl.2gis.com/api/js/v1.4.3

SRI: sha512-Uxyq5h4XINWzyyVRQJryWKJKTDPSyufCgMicxI0WWBxOcck8LdwOh0/Rq77iOdHuSip09XrnHU5cTleVQxEL8A==

Release Date: 1.12.2020

Support End Date: 10.03.2021

Internal changes that do not affect the operation of the map engine

v1.4.2

URL: https://mapgl.2gis.com/api/js/v1.4.2

SRI: sha512-OOipC0yturhRcjT5OE2y+xYc8w3qAiE4iR9kr6tYw1sTQD3Xm8iXED18EwDYA/kJVZtdQVOcrYRWn+jWpOGlew==

Release Date: 09.11.2020

Support End Date: 1.03.2021

Internal changes that do not affect the operation of the map engine

v1.4.0

URL: https://mapgl.2gis.com/api/js/v1.4.0

SRI: sha512-osMewflim+spxdlIWkAjWLTMf+xBLIOjQhpqYokSVctjLJh5gNW6hYl3OPNSAS2lcmPd5Xz/Xp5o+NTmXafoXQ==

Release Date: 22.10.2020

Support End Date: 09.02.2021

Added a new method setStyleZoom. It sets the map style zoom.
Added a new map option maxBounds. It restricts map to specified bounding box.

v1.3.2

URL: https://mapgl.2gis.com/api/js/v1.3.2

SRI: sha512-tz6H4FpSamGsGRnoMOejtLQscum0RGJcVZlBtTaQBZuemD71Jz1kXvFsXhzggRXB+EprMhiFPPvBh7qDdJrzPA==

Release Date: 07.10.2020

Support End Date: 22.01.2021

Added stable fix for missing rerender (IOS 14 and other)

v1.3.1

URL: https://mapgl.2gis.com/api/js/v1.3.1

SRI: sha512-Zqr8S1rWWTKcC4f+kqllqpahA0l7XCdPj1Hs3h/KJBUx+6bQWI4+yPuaUrmNNayFMaXG0AzjJY77Cn/873Ssgg==

Release Date: 22.09.2020

Support End Date: 07.01.2021

Added patch for missing rerender on IOS 14

v1.3.0

Release Date: 18.09.2020

Support End Date: 22.12.2020

Added disableRotationByUserInteraction and disablePitchByUserInteraction to the MapOptions. disableRotationByUserInteraction blocks rotation by any user interaction (from keyboard, mouse and etc). disablePitchByUserInteraction prevents users from pitching the map by any interaction.
Added a new method getStyleZoom. It returns the current map style zoom.
Added a new method getWebGLContext which returns current WebGLRenderingContext of the map canvas.
Added a new method getCanvas which returns HTMLCanvasElement of the map.

v1.2.0

Release Date: 26.08.2020

Support End Date: 18.12.2020

Added the new relativeAnchor and offset options to the LabelOptions. Use these options for the Label placement instead an anchor option, which is deprecated now.
Supported the new label placement options in the Marker object.

v1.1.0

Release Date: 04.08.2020

Support End Date: 26.11.2020

Added the new map object Label for the independent text labels on the map.
Added the ability to use a stretchable image as background for the marker label.
Added the option autoHideOSMCopyright to the MapOptions. If true, the OSM copyright will be hidden after 5 seconds from the map initialization.

v1.0.0

Release Date: 21.07.2020

Support End Date: 04.11.2020

There are no any release notes. This is the first release with a fixed version.

Old releases

05.06.2020

New option disableZoomOnScroll was added to the Map options. This option disable zoom on scroll, when a mouse cursor is above the map container.

19.05.2020

New method setSelectedObjects was added to the Map. This method allows to select any object on the map.