mapbox-gl
3.34.2 · 3 Nov 2026SEE LICENSE IN LICENSE.txt6M / weekRepositoryHomepagenpmAtom feed
0.54.1 is the newest release of 0.8.x.
In short
4 breaking22 new12 fixed
- breaking
map.setView(latlng, zoom, bearing)has been removed. Usemap.jumpTo(options)instead: - breaking
map.easeToandmap.flyTonow accept a single options object rather than positional parameters: - breaking
mapboxgl.Sourceis no longer exported. Usemap.addSource()instead. See the GeoJSON line or GeoJSON markers examples. - breaking
mapboxgl.util.supported()moved tomapboxgl.supported().
Release note
Breaking changes
- breaking
map.setView(latlng, zoom, bearing)has been removed. Usemap.jumpTo(options)instead:map.setView([40, -74.50], 9) // 0.7.0 or earlier map.jumpTo({center: [40, -74.50], zoom: 9}); // now - breaking
map.easeToandmap.flyTonow accept a single
options object rather than positional parameters:map.easeTo([40, -74.50], 9, null, {duration: 400}); // 0.7.0 or earlier map.easeTo({center: [40, -74.50], zoom: 9, duration: 400}); // now - breaking
mapboxgl.Sourceis no longer exported. Usemap.addSource()instead. See the
GeoJSON line or
GeoJSON markers
examples. - breaking
mapboxgl.util.supported()moved tomapboxgl.supported().
UX improvements
Add perspective rendering
Better and faster labelling
Add touch interactions support on mobile devices
Viewport-relative popup arrows
Normalize mousewheel zooming speed
Add proper handling of GeoJSON features that cross the date line
Sort overlapping symbols in the y direction
Control buttons are now on a 30 pixel grid
Improve GeoJSON processing performance
API Improvements
Switch to JSDoc for documentation
Bundling with browserify is now supported
Validate incoming map styles
Add
MapsetPitchgetPitchAdd
Mapdblclickevent.Add
MapgetSourceAdd
MapsetFilterandgetFilterAdd
MapfailIfMajorPerformanceCaveatoptionAdd
MappreserveDrawingBufferoptionAdd
VideoSourcegetVideo()Support vector tiles with extents other than 4096
Use a DOM hierarchy that supports evented overlays
Pass
latLngto the event object
UX Bugfixes
Fix rendering glitch on iOS 8
Support unicode range 65280-65535
Fix cracks between fill patterns
Fix angle of icons aligned with lines
Fix dashed line bug for overscaled tiles
Fix icon artifacts caused by sprite neighbors
API Bugfixes
Don't fire spurious
moveendevents on mouseupFix a race condition in
featuresAtFix for brittle fontstack name convention
Fix broken
PopupsetHTMLFix an issue with cross-origin image requests