Mapbox GL JS v3 enables the Mapbox Standard Style, a new realistic 3D lighting system, building shadows and many other visual enhancements, and an ergonomic API for using a new kind of rich, evolving, configurable map styles and seamless integration with custom data. You can get more information about the new features in the Mapbox GL JS v3 migration guide.

Changes since v3.0.0-beta.1:

✨ Features and improvements

• Improve performance of fill extrusion ground flood light & ambient occlusion effect.
• Improve terrain sampling accuracy.
• Add style.import.load event to track loading of imported style fragments and ensure style.load is only called once per style.
• Allow adding symbol layers to styles with imports if they don't have a glyphs endpoint specified (falling back to a default Mapbox endpoint).
• Make sure API methods that return features or layers don't leak internals of imported styles.
• Remove optimizeForTerrain map option (layer rendering on terrain is always optimized now).

Bug fixes 🐞

• Fix accuracy of atmosphere gradient when rendering globe.
• Fix a bug where circle & heatmap layers rendered incorrectly in some situations.
• Fix a bug where model colors weren't always re-evaluated when light properties changed.
• Fix a bug where calling setStyle when using the Standard style failed.
• Fix a bug where map.removeSource didn't work properly with the Standard style.
• Fix a bug with map.setLayoutProperty not working on a custom layer.
• Fix a bug with hillshade rendering on terrain when combined with new light API.
• Fix a bug where fill extrusion flood light effect sometimes caused visible seams between tiles.
• Fix a bug with horizon placement when map padding is used.