Packages

mapbox-gl

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

Your version

197 stable releases, newest first, by release line. Notes are quoted as the maintainers published them.

  1. 0.25.x
  2. 0.25.1

    30 Sep 2016
    • Fix bug causing attribution to not be shown #3278

    • Fix bug causing exceptions when symbol text has a trailing newline #3281

  3. 0.25.0

    29 Sep 2016
    • breaking

      Change webpack build process (#3235) :warning: warning:

    • Consolidate undocumented data lifecycle events into data and dataloading events

    • Add auto value for style spec properties

  4. 0.24.x
  5. 0.24.0

    20 Sep 2016
    • Allow querystrings in mapbox:// URLs #3113

    • Allow "drag rotate" interaction to control pitch #3105

    • Improve performance by decreasing Worker script Blob size #3158

  6. 0.23.x
  7. 0.23.0

    25 Aug 2016
    • breaking

      Make LngLatBounds obey its documented argument order (southwest, northeast), allowing bounds across the dateline #2414 :warning: warning:

    • Add support for line-color property functions #2938

    • Add Scale control #2940 #3042

  8. 0.22.x
  9. 0.22.1

    18 Aug 2016
    • Reduce library size by using minified version of style specification #2998

    • Add a warning when rendering artifacts occur due to too many symbols or glyphs being rendered in a tile #2966

    • Fix bug causing exception to be thrown by Map#querySourceFeatures #3022

  10. 0.22.0

    12 Aug 2016
    • breaking

      The GeoJSONSource, VideoSource, ImageSource constructors are now private. Please use map.addSource({...}) to create sources and map.getSource(...).setData(...) to update GeoJSON sources. #2667

    • breaking

      Map#onError has been removed. You may catch errors by listening for the error event. If no listeners are bound to error, error messages will be printed to the console. #2852

    • Increase max glyph atlas size to accomodate alphabets with large numbers of characters #2930

  11. 0.21.x
  12. 0.21.0

    13 Jul 2016
    • Add text-pitch-alignment style property #2668

    • Allow query parameters on mapbox:// URLs #2702

    • Add icon-text-fit and icon-text-fit-padding style properties #2720

  13. 0.20.x
  14. 0.20.1

    21 Jun 2016
    • Fixed exception thrown when changing *-translate properties via setPaintProperty

  15. 0.20.0

    10 Jun 2016
    • Add limited WMS support #2612

    • Add workerCount constructor option #2666

    • Improve performance of locationPoint and pointLocation #2690

  16. 0.19.x
  17. 0.19.1

    3 Jun 2016
    • Fix rendering of multipolygons that have polygons with more than 500 rings #2657

  18. 0.19.0

    31 May 2016
    • Significantly improve rendering performance for fill layers #1606

    • Add data driven styling support for fill-color and fill-outline-color #2629

    • Allow use of special characters in property field names #2547

  19. 0.18.x
  20. 0.18.0

    28 Apr 2016
    • Implement zoom-and-property functions for circle-color and circle-size #2454

    • Dedupe attributions that are substrings of others #2453

    • Misc performance improvements #2483 #2488

  21. 0.17.x
  22. 0.17.0

    13 Apr 2016
    • breaking

      Remove map.batch in favor of automatically batching style mutations (i.e. calls to Map#setLayoutProperty, Map#setPaintProperty, Map#setFilter, Map#setClasses, etc.) and applying them once per frame, significantly improving performance when updating the style frequently #2355 #2380

    • breaking

      Remove util.throttle #2345

    • Improve performance of all style mutation methods by only recalculating affected properties #2339

  23. 0.16.x
  24. 0.16.0

    24 Mar 2016
    • breaking

      Replace Map#featuresAt and Map#featuresIn with Map#queryRenderedFeatures and map.querySourceFeatures

    • breaking

      Map#debug is renamed to Map#showTileBoundaries

    • breaking

      Map#collisionDebug is renamed to Map#showCollisionBoxes

  25. 0.15.x
  26. 0.15.0

    2 Mar 2016

    Add ImageSource#setCoordinates and VideoSource#setCoordinates (#2184)

  27. 0.14.x
  28. 0.14.3

    26 Feb 2016

    Improve responsiveness of zooming out by using cached parent tiles (#2168)
    Improve contextual clues on style API validation (#2170)
    Improve performance of setFilter, setLayoutProperty and setLayerZoomRange methods (#2174)

  29. 0.14.2

    20 Feb 2016

    Look for loaded parent tiles in cache
    Set tile cache size based on viewport size (#2137)
    Fix tile render order for layer-by-layer
    Remove source update throttling (#2139)
    Make panning while zooming more linear (#2070)
    Round points created during bucket creation (#2067)
    Correct bounds for a rotated or tilted map (#1842)
    Fix overscaled featuresAt (#2103)
    Allow using tileSize: 512 as a switch to trade retina support for 512px raster tiles
    Fix the serialization of paint classes (#2107)
    Fixed bug where unsetting style properties could mutate the value of other style properties (#2105)
    Less slanted dashed lines near sharp corners (#967)
    Fire map#load if no initial style is set (#2042)

  30. 0.14.1

    10 Feb 2016

    Fix incorrectly rotated symbols along lines near tile boundries (#2062)
    Fix broken rendering when a fill layer follows certain symbol layers (#2092)

  31. 0.14.0

    9 Feb 2016

    Switch GeoJSONSource clustering options from being measured in extent-units to pixels (#2026)

  32. 0.13.x
  33. 0.13.1

    28 Jan 2016

    Fixed broken npm package due to outdated bundled modules

  34. 0.13.0

    27 Jan 2016

    Fixed easeTo pan, zoom, and rotate when initial rotation != 0 (#1950)
    Fixed rendering of tiles with an extent != 4096 (#1952)
    Fixed missing icon collision boxes (#1978)
    Fixed null Tile#buffers errors (#1987)

  35. 0.12.x
  36. 0.12.4

    19 Jan 2016

    Fix elementGroups null value errors (#1933)
    Fix some glyph atlas overflow cases (#1923)

  37. 0.12.3

    14 Jan 2016

    Support inline attribution options in map options (#1865)
    Improve flyTo options (#1854, #1429)

  38. 0.12.2

    22 Dec 2015
    • Support LngLat.convert([w, s, e, n])

    • Invalid GeoJSON is now handled better

    • Fixed Popup#addTo when the popup is already open

  39. 0.12.1

    8 Dec 2015
    • breaking

      Reversed the direction of line-offset

    • breaking

      Renamed Pinch interaction handler to TouchZoomRotate

    • breaking

      Made Map#update and Map#render private methods

  40. 0.12.0

    3 Dec 2015
    • Added line-offset style property

  41. 0.11.x
  42. 0.11.5

    1 Dec 2015
    • Fixed unstable symbol layer render order when adding / removing layers

    • Fire map loaded event even if raster tiles have errors

    • Fix panning animation during easeTo with zoom change

  43. 0.11.4

    16 Nov 2015
    • Fix alpha blending of alpha layers

  44. 0.11.3

    10 Nov 2015
    • Fix GeoJSON rendering and performance

    • Use SVG assets for UI controls

    • Zoom out with shift + dblclick

  45. 0.11.2

    29 Oct 2015
    • Misc performance improvements

    • Fix sprites on systems with non-integer devicePixelRatios (#1029 #1475 #1476)

    • Fix layer minZoom being ignored if not less than source maxZoom

  46. 0.11.1

    30 Sep 2015
    • Add statistics and checkboxes to debug page

    • Fix Map#featuresAt for non-4096 vector sources

    • Don't fire mousemove on drag-pan

  47. 0.11.0

    14 Sep 2015
    • Add Map#featuresIn: a bounding-box feature query

    • Emit stylesheet validation errors

    • Handle v8 style center, zoom, bearing, pitch

  48. 0.10.x
  49. 0.10.0

    21 Aug 2015
    • 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:

      The following APIs now expect array coordinates in [longitude, latitude] 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 format mapbox://styles/:username/:style. The :style portion of the URL no longer contains a username. For font URLs, you should now use the format mapbox://fonts/:username/{fontstack}/{range}.pbf.

  50. 0.9.x
  51. 0.9.0

    29 Jul 2015
    • glyphs URL now normalizes without the /v4/ prefix for mapbox:// urls. Legacy behavior for mapbox://fontstacks is still maintained

    • Expose geojson-vt options for GeoJSON sources

    • Bearing snaps to "North" within a tolerance of 7 degrees

  52. 0.8.x
  53. 0.8.2

    29 Jul 2015
  54. 0.8.1

    22 Jun 2015
    • No code changes; released only to correct a build issue in 0.8.0.

  55. 0.8.0

    15 Jun 2015
    • breaking

      map.setView(latlng, zoom, bearing) has been removed. Use map.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.easeTo and map.flyTo now 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.Source is no longer exported. Use map.addSource() instead. See the GeoJSON line or GeoJSON markers examples.

  56. 0.7.x
  57. 0.7.0

    4 Mar 2015
    • breaking

      Rename Map hover event to mousemove.

    • breaking

      Change featuresAt to return GeoJSON objects, including geometry

    • breaking

      Remove Map canvas and container properties, add getCanvas and getContainer methods instead

  58. 0.6.x
  59. 0.6.0

    10 Feb 2015
    • breaking

      Updated to mapbox-gl-style-spec v7.0.0 (Changelog). Styles are now expected to be version 7. You can use the gl-style-migrate utility to update existing styles.

    • breaking

      HTTP_URL and HTTPS_URL config options must no longer include a /v4 path prefix.

    • breaking

      addClass, removeClass, setClasses, hasClass, and getClasses are now methods on Map.

  60. 0.5.x
  61. 0.5.2

    8 Jan 2015
    • Remove tiles for unused sources

    • Fix fill pattern alignment

    • Add GeoJSONSource maxzoom option

  62. 0.5.1

    19 Dec 2014
    • Fix race conditions with style loading/rendering

    • Fix race conditions with setStyle

    • Fix map.remove()

  63. 0.5.0

    18 Dec 2014
    • breaking

      Results format for featuresAt changed

    • Fix multiple calls to setStyle

    • featuresAt now returns additional information

  64. 0.4.x
  65. 0.4.2

    14 Nov 2014
    • Ensure only one easing is active at a time

    • Don't require style to perform easings

    • Fix raster tiles sometimes not showing up

  66. 0.4.1

    10 Nov 2014
    • Interpolate to the closest bearing when doing rotation animations

  67. 0.4.0

    4 Nov 2014
    • breaking

      Updated to mapbox-gl-style-spec v6.0.0 (Changelog). Styles are now expected to be version 6. You can use the gl-style-migrate utility to update existing styles.

  68. 0.3.x
  69. 0.3.2

    23 Oct 2014
    • Fix worker initialization with deferred or async scripts

    • Added map.remove()

    • CDN assets are now served with gzip compression

  70. 0.3.1

    6 Oct 2014
    • Fixed iteration over arrays with for/in

    • Made browserify deps non-dev