Packages

mapbox-gl

3.34.2 · 3 Nov 2026SEE LICENSE IN LICENSE.txt6M / weekRepositoryHomepagenpmAtom feed

Your version

1.7.0

27 Jan 2020Where it was published

1.13.3 is the newest release of 1.x.

In short

9 new8 fixed

Release note

Features

  • Add promoteId option to use a feature property as ID for feature state

  • Add a new constructor option to mapboxgl.Popup, closeOnMove, that closes the popup when the map's position changes

  • Allow creating a map without a style (an empty one will be created automatically) ( h/t @stepankuzmin )

  • map.once() now allows specifying a layer id as a third parameter making it consistent with map.on()

Improvements

  • Improve performance of raster layers on large screens

  • Improve performance for hillshade and raster layers by implementing a progressive enhancement that utilizes ImageBitmap and OffscreenCanvas

  • Improve performance for raster tile rendering by using the stencil buffer

  • Update symbol-avoid-edges documentation to acknowledge the existence of global collision detection

  • Remove reference to in function which has been replaced by the in expression

Bug Fixes

  • Change the type of tile id key to string to prevent hash collisions

  • Prevent changing bearing via URL hash when rotation is disabled

  • Fix URL hash with no bearing causing map to fail to load

  • Fix bug in GeolocateControl where multiple instances of the control on one page may result in the user location not being updated

  • Fix query fill-extrusions made from polygons with coincident points and polygons with less than four points

  • Fix bug where symbol-sort-key was not used for collisions that crossed tile boundaries

  • Fix bug in DragRotateHandler._onMouseUp getting stuck in drag/rotate

  • Fix "Click on Compass" on some mobile devices (add clickTolerance to DragRotateHandler) (#9015) (h/t Yanonix)