mapbox-gl
3.34.2 · 3 Nov 2026SEE LICENSE IN LICENSE.txt6M / weekRepositoryHomepagenpmAtom feed
0.54.1 is the newest release of 0.16.x.
In short
3 breaking10 new12 fixed
- breaking
Replace
Map#featuresAtandMap#featuresInwithMap#queryRenderedFeaturesandmap.querySourceFeatures - breaking
Map#debugis renamed toMap#showTileBoundaries - breaking
Map#collisionDebugis renamed toMap#showCollisionBoxes
Release note
Breaking Changes
- breaking
Replace
Map#featuresAtandMap#featuresInwithMap#queryRenderedFeaturesandmap.querySourceFeaturesReplace
featuresAtandfeaturesInwithqueryRenderedFeaturesMake
queryRenderedFeaturessynchronous, remove the callback and use the return value.Rename
layerparameter tolayersand make it an array of layer names.Remove the
radiusparameter.radiuswas used withfeaturesAtto account for style properties likeline-widthandcircle-radius.queryRenderedFeaturesaccounts for these style properties. If you need to query a larger area, use a bounding box query instead of a point query.Remove the
includeGeometryparameter becausequeryRenderedFeaturesalways includes geometries.
- breaking
Map#debugis renamed toMap#showTileBoundaries - breaking
Map#collisionDebugis renamed toMap#showCollisionBoxes
New Features & Improvements
Improve overall rendering performance.
Improve performance of
GeoJSONSource#setData.Add
Map#setMaxBoundsmethodAdd
isActiveandisEnabledmethods to interaction handlersAdd
Map#setZoomBoundsmethodAdd touch events
Add
map.queryRenderedFeaturesto query the styled and rendered representations of featuresAdd
map.querySourceFeaturesto get features directly from vector tiles, independent of the styleAdd
mapboxgl.GeolocatecontrolMake background patterns render seamlessly across tile boundaries
Bugfixes
Fix calls to
setFilter,setLayoutProperty, andsetLayerZoomRangeon ref childrenFix
undefinedbucket errors aftersetFiltercallsFix bugs causing hidden symbols to be rendered (#2246, #2276)
Fix raster flickering
Fix
queryRenderedFeaturesprecision at high zoom levelsFix holes in GeoJSON data caused by unexpected winding order
Fix bug causing deleted features to be returned by
queryRenderedFeaturesFix bug causing unexpected fill patterns to be rendered
Fix popup location with preceding sibling elements
Fix polygon anti-aliasing
Fix slivers between non-adjacent polygons
Fix keyboard shortcuts causing page to scroll