mapbox-gl
3.34.2 · 3 Nov 2026SEE LICENSE IN LICENSE.txt6M / weekRepositoryHomepagenpmAtom feed
0.54.1 is the newest release of 0.10.x.
In short
7 breaking2 new2 fixed
- breaking
Switched to [longitude, latitude] coordinate order, matching GeoJSON. We anticipate that mapbox-gl-js will be widely used with GeoJSON, and in the long term having a coordinate order that is consistent with GeoJSON will lead to less confusion and impedance mismatch than will a [latitude, longitude] order.
- breaking
Updated to mapbox-gl-style-spec v8.0.0 (Changelog). Styles are now expected to be version 8. You can use the gl-style-migrate utility to update existing styles.
- breaking
The format for
mapbox://style and glyphs URLs has changed. For style URLs, you should now use the formatmapbox://styles/:username/:style. The:styleportion of the URL no longer contains a username. For font URLs, you should now use the formatmapbox://fonts/:username/{fontstack}/{range}.pbf. - breaking
Mapbox default styles are now hosted via the Styles API rather than mapbox.com. You can make use of the Styles API with a
mapbox://style URL pointing to a v8 style, e.g.mapbox://styles/mapbox/streets-v8. - breaking
The v8 satellite style (
mapbox://styles/mapbox/satellite-v8) is now a plain satellite style, and not longer supports labels or contour lines via classes. For a labeled satellite style, usemapbox://styles/mapbox/satellite-hybrid. - breaking
Removed
mbgl.config.HTTP_URLandmbgl.config.FORCE_HTTPS; https is always used when connecting to the Mapbox API. - breaking
Renamed
mbgl.config.HTTPS_URLtombgl.config.API_URL.
Release note
Breaking changes
- breaking
Switched to [longitude, latitude] coordinate order, matching GeoJSON. We anticipate that mapbox-gl-js will be widely used
with GeoJSON, and in the long term having a coordinate order that is consistent with GeoJSON will lead to less confusion
and impedance mismatch than will a [latitude, longitude] order.The following APIs were renamed:
LatLngwas renamed toLngLatLatLngBoundswas renamed toLngLatBoundsPopup#setLatLngwas renamed toPopup#setLngLatPopup#getLatLngwas renamed toPopup#getLngLatThe
latLngproperty of Map events was renamedlngLat
The following APIs now expect array coordinates in [longitude, latitude] order:
LngLat.convertLngLatBounds.convertPopup#setLngLatThe
centerandmaxBoundsoptions of theMapconstructorThe arguments to
Map#setCenter,Map#fitBounds,Map#panTo, andMap#projectThe
centeroption ofMap#jumpTo,Map#easeTo, andMap#flyToThe
aroundoption ofMap#zoomTo,Map#rotateTo, andMap#easeToThe
coordinatesproperties of video and image sources
- breaking
Updated to mapbox-gl-style-spec v8.0.0 (Changelog). Styles are
now expected to be version 8. You can use the gl-style-migrate
utility to update existing styles. - breaking
The format for
mapbox://style and glyphs URLs has changed. For style URLs, you should now use the formatmapbox://styles/:username/:style. The:styleportion of the URL no longer contains a username. For font URLs, you
should now use the formatmapbox://fonts/:username/{fontstack}/{range}.pbf. - breaking
Mapbox default styles are now hosted via the Styles API rather than mapbox.com. You can make use of the Styles API
with amapbox://style URL pointing to a v8 style, e.g.mapbox://styles/mapbox/streets-v8. - breaking
The v8 satellite style (
mapbox://styles/mapbox/satellite-v8) is now a plain satellite style, and not longer supports labels
or contour lines via classes. For a labeled satellite style, usemapbox://styles/mapbox/satellite-hybrid. - breaking
Removed
mbgl.config.HTTP_URLandmbgl.config.FORCE_HTTPS; https is always used when connecting to the Mapbox API. - breaking
Renamed
mbgl.config.HTTPS_URLtombgl.config.API_URL.
Bugfixes
Don't draw halo when halo-width is 0
Reverted shader changes that degraded performance on IE
API Improvements
You can now unset layout and paint properties via the
setLayoutPropertyandsetPaintPropertyAPIs
by passingundefinedas a property value.The
layeroption offeaturesAtnow supports an array of layers.