v0.44.2

Compare Source

🐛 Bug fixes

• Workaround a breaking change in Safari causing page to scroll/zoom in response to user actions intended to pan/zoom the map #​6095. (N.B., not to be confused with the workaround from April 2017 dealing with the same breaking change in Chrome #​4259. See also https://github.com/WICG/interventions/issues/18, https://bugs.webkit.org/show_bug.cgi?id=182521, https://bugs.chromium.org/p/chromium/issues/detail?id=639227 .)

v0.44.1

Compare Source

🐛 Bug fixes

• Fix bug causing features from symbol layers to be omitted from map.queryRenderedFeatures() #​6074
• Fix error triggered by simultaneous scroll-zooming and drag-panning. #​6106
• Fix bug wherein drag-panning failed to resume after a brief pause #​6063

v0.44.0

Compare Source

✨ Features and improvements

• The CSP policy of a page using mapbox-gl-js no longer needs to include script-src 'unsafe-eval' #​559
• Add LngLatBounds#isEmpty() method #​5917
• Updated to flow 0.62.0 #​5923
• Make compass and zoom controls optional (#​5348) (h/t @​matijs)
• Add collectResourceTiming option to the enable collection of Resource Timing data for requests that are made from Web Workers. (#​5948)
• Improve user location dot appearance across browsers (#​5498) (h/t @​jasonbarry)

🐛 Bug fixes

• Fix error triggered by == and != expressions #​5947
• Image sources honor renderWorldCopies #​5932
• Fix transitions to default fill-outline-color #​5953
• Fix transitions for light properties #​5982
• Fix minor symbol collisions on pitched maps #​5913
• Fix memory leaks after Map#remove() #​5943, #​5951
• Fix bug wherein GeoJSONSource#setData() caused labels to fade out and back in (#​6002)
• Fix bug that could cause incorrect collisions for labels placed very near to each other at low zoom levels (#​5993)
• Fix bug causing move events to be fired out of sync with actual map movements (#​6005)
• Fix bug wherein Map did not fire mouseover events (#​6000] (h/t @​jay-manday)
• Fix bug causing blurry rendering of raster tiles (#​4552)
• Fix potential memory leak caused by removing layers (#​5995)
• Fix bug causing attribution icon to appear incorrectly in compact maps not using Mapbox data (#​6042)
• Fix positioning of default marker element (#​6012) (h/t @​andrewharvey)

v0.43.0

Compare Source

⚠️ Breaking changes

• It is now an error to attempt to remove a source that is in use #​5562
• It is now an error if the layer specified by the before parameter to moveLayer does not exist #​5679
• "colorSpace": "hcl" now uses shortest-path interpolation for hue #​5811

✨ Features and improvements

• Introduce client-side hillshading with raster-dem source type and hillshade layer type #​5286
• GeoJSON sources take 2x less memory and generate tiles 20%–100% faster #​5799
• Enable data-driven values for text-font #​5698
• Enable data-driven values for heatmap-radius #​5898
• Add getter and setter for offset on marker #​5759
• Add Map#hasImage #​5775
• Improve typing for == and != expressions #​5840
• Made coalesce expressions more useful #​5755
• Enable implicit type assertions for array types #​5738
• Improve hash control precision #​5767
• supported() now returns false on old IE 11 versions that don't support Web Worker blob URLs #​5801
• Remove flow globals TileJSON and Transferable #​5668
• Improve performance of image, video, and canvas sources #​5845

🐛 Bug fixes

• Fix popups and markers lag during pan animation #​4670
• Fix fading of symbol layers caused by setData #​5716
• Fix behavior of to-rgba and rgba expressions #​5778, #​5866
• Fix cross-fading of *-pattern and line-dasharray #​5791
• Fix colorSpace function property #​5843
• Fix style diffing when changing GeoJSON source properties #​5731
• Fix missing labels when zooming out from overzoomed tile #​5827
• Fix missing labels when zooming out and quickly using setData #​5837
• Handle NaN as input to step and interpolate expressions #​5757
• Clone property values on input and output #​5806
• Bump geojson-rewind dependency #​5769
• Allow setting Marker's popup before LngLat #​5893

v0.42.2

Compare Source

🐛 Bug fixes

• Add box-sizing to the "mapboxgl-ctrl-scale"-class #​5715
• Fix rendering in Safari #​5712
• Fix "Cannot read property 'hasTransition' of undefined" error #​5714
• Fix misplaced raster tiles #​5713
• Fix raster tile fading #​5722
• Ensure that an unset filter is undefined rather than null #​5727
• Restore pitch-with-rotate to nav control #​5725
• Validate container option in map constructor #​5695
• Fix queryRenderedFeatures behavior for features displayed in multiple layers #​5172

v0.42.1

Compare Source

🐛 Bug fixes

• Workaround for map flashing bug on Chrome 62+ with Intel Iris Graphics 6100 cards #​5704
• Rerender map when map.showCollisionBoxes is set to false #​5673
• Fix transitions from property default values #​5682
• Fix runtime updating of heatmap-color #​5682
• Fix mobile Safari history.replaceState error #​5613

✨ Features and improvements

• Provide default element for Marker class #​5661

v0.42.0

Compare Source

⚠️ Breaking changes

• Require that heatmap-color use expressions instead of stop functions #​5624
• Remove support for validating and migrating v6 styles
• Remove support for validating v7 styles #​5604
• Remove support for including {tokens} in expressions for text-field and icon-image #​5599
• Split curve expression into step and interpolate expressions #​5542
• Disallow interpolation in expressions for line-dasharray #​5519

✨ Features and improvements

• Improve label collision detection #​5150
  • Labels from different sources will now collide with each other
  • Collisions caused by rotation and pitch are now smoothly transitioned with a fade
  • Improved algorithm for fewer erroneous collisions, denser label placement, and greater label stability during rotation
• Add sqrt expression #​5493

🐛 Bug fixes and error reporting improvements

• Fix viewport calculations for fitBounds when both zooming and padding change #​4846
• Fix WebGL "range out of bounds for buffer" error caused by sorted symbol layers #​5620
• Fix symbol fading across tile reloads #​5491
• Change tile rendering order to better match GL Native #​5601
• Ensure no errors are triggered when calling queryRenderedFeatures on a heatmap layer #​5594
• Fix bug causing queryRenderedSymbols to return results from different sources #​5554
• Fix CJK rendering issues #​5544, #​5546
• Account for circle-stroke-width in queryRenderedFeatures #​5514
• Fix rendering of fill layers atop raster layers #​5513
• Fix rendering of circle layers with a circle-stroke-opacity of 0 #​5496
• Fix memory leak caused by actor callbacks #​5443
• Fix source cache size for raster sources with tile sizes other than 512px #​4313
• Validate that zoom expressions only appear at the top level of an expression #​5609
• Validate that step and interpolate expressions don't have any duplicate stops #​5605
• Fix rendering for icon-text-fit with a data-driven text-size #​5632
• Improve validation to catch uses of deprecated function syntax #​5667
• Permit altitude coordinates in position field in GeoJSON #​5608

0.41.0 (October 11, 2017)

⚠️ Breaking changes

• Removed support for paint classes #​3643. Instead, use runtime styling APIs or Map#setStyle.
• Reverted the canvas source contextType option added in 0.40.0 #​5449

🐛 Bug fixes

• Clip raster tiles to avoid tile overlap #​5105
• Guard for offset edgecase in flyTo #​5331
• Ensure the map is updated after the sprite loads #​5367
• Limit animation duration on flyTo with maxDuration option #​5349
• Make double-tapping on make zoom in by a factor of 2 on iOS #​5274
• Fix rendering error with translucent raster tiles #​5380
• Error if invalid 'before' argument is passed to Map#addLayer #​5401
• Revert CanvasSource intermediary image buffer fix #​5449

✨ Features and improvements

• Use setData operation when diffing geojson sources #​5332

• Return early from draw calls on layers where opacity=0 #​5429

• A heatmap layer type is now available. This layer type allows you to visualize and explore massive datasets of points, reflecting the shape and density of data well while also looking beautiful. See the blog post for further details.
  

• The value of a style property or filter can now be an expression. Expressions are a way of doing data-driven and zoom-driven styling that provides more flexibility and control, and unifies property and filter syntax.

  Previously, data-driven and zoom-driven styling relied on stop functions: you specify a feature property and a set of input-output pairs that essentially define a “scale” for how the style should be calculated based on the feature property. For example, the following would set circle colors on a green-to-red scale based on the value of feature.properties.population:

  "circle-color": {
    "property": "population",
    "stops": [
      [0, "green"],
      [1000000, "red"]
    ]
  }
  

  This approach is powerful, but we’ve seen a number of use cases that stop functions don't satisfy. Expressions provide the flexibility to address use cases like these:

  Multiple feature properties
  Using more than one feature property to calculate a given style property. E.g., styling land polygon colors based on both feature.properties.land_use_category and feature.properties.elevation.

  Arithmetic
  For some use cases it’s necessary to do some arithmetic on the input data. One example is sizing circles to represent quantitative data. Since a circle’s visual size on the screen is really its area (and A=πr^2), the right way to scale circle-radius is square_root(feature.properties.input_data_value). Another example is unit conversions: feature data may include properties that are in some particular unit. Displaying such data in units appropriate to, say, a user’s preference or location, requires being able to do simple arithmetic (multiplication, division) on whatever value is in the data.

  Conditional logic
  This is a big one: basic if-then logic, for example to decide exactly what text to display for a label based on which properties are available in the feature or even the length of the name. A key example of this is properly supporting bilingual labels, where we have to decide whether to show local + English, local-only, or English-only, based on the data that’s available for each feature.

  String manipulation
  More dynamic control over label text with things like uppercase/lowercase/title case transforms, localized number formatting, etc. Without this functionality, crafting and iterating on label content entails a large data-prep burden.

  Filters
  Style layer filters had similar limitations. Moreover, they use a different syntax, even though their job is very similar to that of data-driven styling functions: filters say, “here’s how to look at a feature and decide whether to draw it,” and data-driven style functions say, “here’s how to look at a feature and decide how to size/color/place it.” Expressions provide a unified syntax for defining parts of a style that need to be calculated dynamically from feature data.

  For information on the syntax and behavior of expressions, please see the documentation.

🔧 Development workflow improvements

• Made the performance benchmarking runner more informative and statistically robust

0.40.1 (September 18, 2017)

🐛 Bug fixes

• Fix bug causing flicker when zooming in on overzoomed tiles #​5295
• Remove erroneous call to Tile#redoPlacement for zoom-only or low pitch camera changes #​5284
• Fix bug where CanvasSource coordinates were flipped and improve performance for non-animated CanvasSources #​5303
• Fix bug causing map not to render on some cases on Internet Explorer 11 #​5321
• Remove upper limit on fill-extrusion-height property #​5320

0.40.0 (September 13, 2017)

⚠️ Breaking changes

• Map#addImage now requires the image as an HTMLImageElement, ImageData, or object with width, height, and
  data properties with the same format as ImageData. It no longer accepts a raw ArrayBufferView in the second
  argument and width and height options in the third argument.
• canvas sources now require a contextType option specifying the drawing context associated with the source canvas. #​5155

✨ Features and improvements

• Correct rendering for multiple fill-extrusion layers on the same map #​5101
• Add an icon-anchor property to symbol layers #​5183
• Add a per-map transformRequest option, allowing users to provide a callback that transforms resource request URLs #​5021
• Add data-driven styling support for
  • text-max-width #​5067
  • text-letter-spacing #​5071
  • line-join #​5020
• Add support for SDF icons in Map#addImage() #​5181
• Added nautical miles unit to ScaleControl #​5238 (h/t @​fmairesse)
• Eliminate the map-wide limit on the number of glyphs and sprites that may be used in a style #​141. (Fixed by #​5190, see also mapbox-gl-native#​9213
• Numerous performance optimizations (including #​5108 h/t @​pirxpilot)

🐛 Bug fixes

• Add missing documentation for mouseenter, mouseover, mouseleave events #​4772
• Add missing documentation for Marker#getElement() method #​5242
• Fix bug wherein removing canvas source with animate=true leaves map in render loop #​5097
• Fix fullscreen detection on Firefox #​5272
• Fix z-fighting on overlapping fills within the same layer #​3320
• Fix handling of fractional values for layer.minzoom #​2929
• Clarify coordinate ordering in documentation for center option #​5042 (h/t @​karthikb351)
• Fix output of stop functions where two stops have the same input value #​5020 (h/t @​edpop )
• Fix bug wherein using Map#addLayer() with an inline source would mutate its input #​4040
• Fix invalid css keyframes selector #​5075 (h/t @​aar0nr)
• Fix GPU-specific bug wherein canvas sources caused an error #​4262
• Fix a race condition in symbol layer handling that caused sporadic uncaught errors #​5185
• Fix bug causing line labels to render incorrectly on overzoomed tiles #​5120
• Fix bug wherein NavigationControl triggered mouse events unexpectedly #​5148
• Fix bug wherein clicking on the NavigationControl compass caused an error in IE 11 #​4784
• Remove dependency on GPL-3-licensed fast-stable-stringify module #​5152
• Fix bug wherein layer-specific an event listener produced an error after its target layer was removed from the map #​5145
• Fix Marker#togglePopup() failing to return the marker instance #​5116
• Fix bug wherein a marker's position failed to adapt to the marker element's size changing #​5133
• Fix rendering bug affecting Broadcom GPUs #​5073

🔧 Development workflow improvements

• Add (and now require) Flow type annotations throughout the majority of the codebase.
• Migrate to CircleCI 2.0 #​4939

0.39.1 (July 24, 2017)

🐛 Bug fixes

• Fix packaging issue in 0.39.0 #​5025
• Correctly evaluate enum-based identity functions #​5023

0.39.0 (July 21, 2017)

⚠️ Breaking changes

• GeolocateControl breaking changes #​4479
  • The option watchPosition has been replaced with trackUserLocation
  • The camera operation has changed from jumpTo (not animated) to fitBounds (animated). An effect of this is the map pitch is no longer reset, although the bearing is still reset to 0.
  • The accuracy of the geolocation provided by the device is used to set the view (previously it was fixed at zoom level 17). The maxZoom can be controlled via the new fitBoundsOptions option (defaults to 15).
• Anchor Markers at their center by default #​5019 @​andrewharvey
• Increase significantRotateThreshold for the TouchZoomRotateHandler #​4971, @​dagjomar

✨ Features and improvements

• Improve performance of updating GeoJSON sources #​4069, @​ezheidtmann
• Improve rendering speed of extrusion layers #​4818
• Improve line label legibility in pitched views #​4781
• Improve line label legibility on curved lines #​4853
• Add user location tracking capability to GeolocateControl #​4479, @​andrewharvey
  • New option showUserLocation to draw a "dot" as a Marker on the map at the user's location
  • An active lock and background state are introduced with trackUserLocation. When in active lock the camera will update to follow the user location, however if the camera is changed by the API or UI then the control will enter the background state where it won't update the camera to follow the user location.
  • New option fitBoundsOptions to control the camera operation
  • New trackuserlocationstart and trackuserlocationend events
  • New LngLat.toBounds method to extend a point location by a given radius to a LngLatBounds object
• Include main CSS file in package.json #​4809, @​tomscholz
• Add property function (data-driven styling) support for line-width #​4773
• Add property function (data-driven styling) support for text-anchor #​4997
• Add property function (data-driven styling) support for text-justify #​5000
• Add maxTileCacheSize option #​4778, @​jczaplew
• Add new icon-pitch-alignment and circle-pitch-alignment properties #​4869 #​4871
• Add Map#getMaxBounds method #​4890, @​andrewharvey @​lamuertepeluda
• Add option (localIdeographFontFamily) to use TinySDF to avoid loading expensive CJK glyphs #​4895
• If config.API_URL includes a path prepend it to the request URL #​4995
• Bump supercluster version to expose cluster_id property on clustered sources #​5002

🐛 Bug fixes

• Do not display FullscreenControl on unsupported devices #​4838, @​stepankuzmin
• Fix yarn build on Windows machines #​4887
• Prevent potential memory leaks by dispatching loadData to the same worker every time #​4877
• Fix bug preventing the rtlTextPlugin from loading before the initial style load #​4870
• Fix bug causing runtime-stying to not take effect in some situations #​4893
• Prevent requests of vertical glyphs for labels that can't be verticalized #​4720
• Fix character detection for Zanabazar Square #​4940
• Fix LogoControl logic to update correctly, and hide the <div> instead of removing it from the DOM when it is not needed #​4842
• Fix GeoJSONSource#serialize to include all options
• Fix error handling in GlyphSource#getSimpleGlyphs#​4992
• Fix bug causing setStyle to reload raster tiles #​4852
• Fix bug causing symbol layers not to render on devices with non-integer device pixel ratios #​4989
• Fix bug where Map#queryRenderedFeatures would error when returning no results #​4993
• Fix bug where Map#areTilesLoaded would always be false on sourcedata events for reloading tiles #​4987
• Fix bug causing categorical property functions to error on non-ascending order stops #​4996

🛠️ Development workflow changes

• Use flow to type much of the code base #​4629 #​4903 #​4909 #​4910 #​4911 #​4913 #​4915 #​4918 #​4932 #​4933 #​4948 #​4949 #​4955 #​4966 #​4967 #​4973 💪 @​jfirebaugh @​vicapow
• Use style specification to generate flow type #​4958
• Explicitly list which files to publish in package.json #​4819 @​tomscholz
• Move render test ignores to a separate file #​4977
• Add code of conduct #​5015 💖

0.38.0 (June 9, 2017)

New features ✨

• Attenuate label size scaling with distance, improving readability of pitched maps #​4547

Bug fixes 🪲

• Skip rendering for patterned layers when pattern is missing #​4687
• Fix bug with map failing to rerender after webglcontextlost event #​4725 @​cdawi
• Clamp zoom level in flyTo to within the map's specified min- and maxzoom to prevent undefined behavior #​4726 @​ IvanSanchez
• Fix wordmark rendering in IE #​4741
• Fix slight pixelwise symbol rendering bugs caused by incorrect sprite calculations #​4737
• Prevent exceptions thrown by certain flyTo calls #​4761
• Fix "Improve this map" link #​4685
• Tweak queryRenderedSymbols logic to better account for pitch scaling #​4792
• Fix for symbol layers sometimes failing to render, most frequently in Safari #​4795
• Apply text-keep-upright after text-offset to keep labels upright when intended #​4779 [Potentially breaking ⚠️ but considered a bugfix]
• Prevent exceptions thrown by empty GeoJSON tiles 4803

Accessibility improvements 🔉

• Add aria-label to popup close button #​4799 @​andrewharvey

Development workflow + testing improvements 🔧

• Fix equality assertion bug in tests #​4731 @​IvanSanchez
• Benchmark results page improvements #​4746
• Require node version >=6.4.0, enabling the use of more ES6 features #​4752
• Document missing pitchWithRotate option #​4800 @​simast
• Move Github-specific Markdown files into subdirectory #​4806 @​tomscholz

0.37.0 (May 2nd, 2017)

⚠️ Breaking changes

• Removed LngLat#wrapToBestWorld

New features 🚀

• Improve popup/marker positioning #​4577
• Add Map#isStyleLoaded and Map#areTilesLoaded events #​4321
• Support offline sprites using file: protocol #​4649 @​oscarfonts

Bug fixes 🐛

• Fix fullscreen control in Firefox #​4666
• Fix rendering artifacts that caused tile boundaries to be visible in some cases #​4636
• Fix default calculation for categorical zoom-and-property functions #​4657
• Fix scaling of images on retina screens #​4645
• Rendering error when a transparent image is added via Map#addImage #​4644
• Fix an issue with rendering lines with duplicate points #​4634
• Fix error when switching from data-driven styles to a constant paint value #​4611
• Add check to make sure invalid bounds on tilejson don't error out #​4641

Development workflow improvements 💻

• Add flowtype interfaces and definitions @​vicapow
• Add stylelinting to ensure mapboxgl- prefix on all classes #​4584 @​asantos3026

0.36.0 (April 19, 2017)

New features ✨

• Replace LogoControl logo with the new Mapbox logo #​4598

Bug fixes 🐛

• Fix bug with the BoxZoomHandler that made it glitchy if it is enabled after the DragPanHandler #​4528
• Fix undefined behavior in fill_outline shaders #​4600
• Fix Camera#easeTo interpolation on pitched maps #​4540
• Choose property function interpolation method by the property's type #​4614

Development workflow improvements 🤓

• Fix crash on missing style.json in integration tests
• gl-style-composite is now executable in line with the other tools @​andrewharvey #​4595
• gl-style-composite utility now throws an error if a name conflict would occur between layers @​andrewharvey #​4595

0.35.1 (April 12, 2017)

Bug fixes 🐛

• Add .json extension to style-spec require statements for webpack compatibility #​4563 @​orangemug
• Fix documentation type for Map#fitBounde #​4569 @​andrewharvey
• Fix bug causing {Image,Video,Canvas}Source to throw exception if latitude is outside of +/-85.05113 #​4574
• Fix bug causing overzoomed raster tiles to disappear from map #​4567
• Fix bug causing queryRenderedFeatures to crash on polygon features that have an id field. #​4581

0.35.0 (April 7, 2017)

New features 🚀

• Use anisotropic filtering to improve rendering of raster tiles on pitched maps #​1064
• Add pitchstart and pitchend events #​2449
• Add an optional layers parameter to Map#on #​1002
• Add data-driven styling support for text-offset #​4495
• Add data-driven styling support for text-rotate #​3516
• Add data-driven styling support for icon-image #​4304
• Add data-driven styling support for {text,icon}-size #​4455

Bug fixes 🐛

• Suppress error messages in JS console due to missing tiles #​1800
• Fix bug wherein GeoJSONSource#setData() could cause unnecessary DOM updates #​4447
• Fix bug wherein Map#flyTo did not respect the renderWorldCopies setting #​4449
• Fix regression in browserify support # 4453
• Fix bug causing poor touch event behavior on mobile devices #​4259
• Fix bug wherein duplicate stops in property functions could cause an infinite loop #​4498
• Respect image height/width in addImage api #​4531
• Fix bug preventing correct behavior of shift+zoom #​3334
• Fix bug preventing image source from rendering when coordinate area is too large #​4550
• Show image source on horizontally wrapped worlds #​4555
• Fix bug in the handling of refreshedExpiredTiles option #​4549
• Support the TileJSON bounds property #​1775

Development workflow improvements 💻

• Upgrade flow to 0.42.0 (#​4500)

0.34.0 (March 17, 2017)

New features 🚀

• Add Map#addImage and Map#removeImage API to allow adding icon images at runtime #​4404
• Simplify non-browserify bundler usage by making the distribution build the main entrypoint #​4423

Bug fixes 🐛

• Fix issue where coincident start/end points of LineStrings were incorrectly rendered as joined #​4413
• Fix bug causing queryRenderedFeatures to fail in cases where both multiple sources and data-driven paint properties were present #​4417
• Fix bug where tile request errors caused map.loaded() to incorrectly return false #​4425

Testing improvements ✅

• Improve test coverage across several core modules #​4432 #​4431 #​4422 #​4244 🙇‍♂️

0.33.1 (March 10, 2017)

Bug fixes 🐛

• Prevent Mapbox logo from being added to the map more than once #​4386
• Add type='button' to FullscreenControl to prevent button from acting as a form submit #​4397
• Fix issue where map would continue to rotate if Ctrl key is released before the click during a DragRotate event #​4389
• Remove double options.easing description from the Map#fitBounds documentation #​4402

0.33.0 (March 8, 2017)

⚠️ Breaking changes

• Automatically add Mapbox wordmark when required by Mapbox TOS #​3933
• Increase default maxZoom from 20 to 22 #​4333
• Deprecate tiledata and tiledataloading events in favor of sourcedata and sourcedataloading. #​4347
• mapboxgl.util is no longer exported #​1408
• "type": "categorical" is now required for all categorical functions. Previously, some forms of "implicitly" categorical functions worked, and others did not. #​3717

✅ New features

• Add property functions support for most symbol paint properties #​4074, #​4186, #​4226
• Add ability to specify default property value for undefined or invalid property values used in property functions. #​4175
• Improve Map#fitBounds to accept different values for top, bottom, left, and right padding #​3890
• Add a FullscreenControl for displaying a fullscreen map #​3977

🪲 Bug fixes

• Fix validation error on categorical zoom-and-property functions #​4220
• Fix bug causing expired resources to be re-requested causing an infinite loop #​4255
• Fix problem where MapDataEvent#isSourceLoaded always returned false #​4254
• Resolve an issue where tiles in the source cache were prematurely deleted, resulting in tiles flickering when zooming in and out and #​4311
• Make sure MapEventData is passed through on calls Map#flyTo #​4342
• Fix incorrect returned values for Map#isMoving #​4350
• Fix categorical functions not allowing boolean stop domain values #​4195
• Fix piecewise-constant functions to allow non-integer zoom levels. #​4196
• Fix issues with $id in filters #​4236 #​4237
• Fix a race condition with polygon centroid algorithm causing tiles not to load in some cases. #​4273
• Throw a meaningful error when giving non-array layers parameter to queryRenderedFeatures #​4331
• Throw a meaningful error when supplying invalid minZoom and maxZoom values #​4324
• Fix a memory leak when using the RTL Text plugin #​4248

Dev workflow changes

• Merged the Mapbox GL style specification repo to this one (now under src/style-spec and test/unit/style-spec).

0.32.1 (Jan 26, 2017)

Bug Fixes

• Fix bug causing mapbox-gl-rtl-text plugin to not work #​4055

0.32.0 (Jan 26, 2017)

Deprecation Notices

• Style classes are deprecated and will be removed in an upcoming release of Mapbox GL JS.

New Features

• Add Map#isSourceLoaded method #​4033
• Automatically reload tiles based on their Expires and Cache-Control HTTP headers #​3944
• Add around=center option to scrollZoom and touchZoomRotate interaction handlers #​3876
• Add support for mapbox-gl-rtl-text plugin to support right-to-left scripts #​3758
• Add canvas source type #​3765
• Add Map#isMoving method #​2792

Bug Fixes

• Fix bug causing garbled text on zoom #​3962
• Fix bug causing crash in Firefox and Mobile Safari when rendering a large map #​4037
• Fix bug causing raster tiles to flicker during zoom #​2467
• Fix bug causing exception when unsetting and resetting fill-outline-color #​3657
• Fix memory leak when removing raster sources #​3951
• Fix bug causing exception when when zooming in / out on empty GeoJSON tile #​3985
• Fix line join artifacts at very sharp angles #​4008

0.31.0 (Jan 10 2017)

New Features

• Add renderWorldCopies option to the Map constructor to give users control over whether multiple worlds are rendered in a map #​3885

Bug Fixes

• Fix performance regression triggered when Map pitch or bearing is changed #​3938
• Fix null pointer exception caused by trying to clear an undefined source #​3903

Miscellaneous

• Incorporate integration tests formerly at mapbox-gl-test-suite into this repository #​3834

0.30.0 (Jan 5 2017)

New Features

• Fire an error when map canvas is larger than allowed by gl.MAX_RENDERBUFFER_SIZE #​2893
• Improve error messages when referencing a nonexistent layer id #​2597
• Fire an error when layer uses a geojson source and specifies a source-layer #​3896
• Add inline source declaration syntax #​3857
• Improve line breaking behavior #​3887

Performance Improvements

• Improve Map#setStyle performance in some cases #​3853

Bug Fixes

• Fix unexpected popup positioning when some offsets are unspecified #​3367
• Fix incorrect interpolation in functions #​3838
• Fix incorrect opacity when multiple backgrounds are rendered #​3819
• Fix exception thrown when instantiating geolocation control in Safari #​3844
• Fix exception thrown when setting showTileBoundaries with no sources #​3849
• Fix incorrect rendering of transparent parts of raster layers in some cases #​3723
• Fix non-terminating render loop when zooming in in some cases #​3399

0.29.0 (December 20 2016)

New Features

• Add support for property functions for many style properties on line layers #​3033
• Make Map#setStyle smoothly transition to the new style #​3621
• Add styledata, sourcedata, styledataloading, and sourcedataloading events
• Add isSourceLoaded and source properties to MapDataEvent #​3590
• Remove "max zoom" cap of 20 #​3683
• Add circle-stroke-* style properties #​3672
• Add a more helpful error message when the specified container element doesn't exist #​3719
• Add watchPosition option to GeolocateControl #​3739
• Add positionOptions option to GeolocateControl #​3739
• Add aria-label to map canvas #​3782
• Adjust multipoint symbol rendering behavior #​3763
• Add support for property functions for icon-offset #​3791
• Improved antialiasing on pitched lines #​3790
• Allow attribution control to collapse to an ⓘ button on smaller screens #​3783
• Improve line breaking algorithm #​3743

Performance Improvements

• Fix memory leak when calling Map#removeSource #​3602
• Reduce bundle size by adding custom build of gl-matrix #​3734
• Improve performance of projection code #​3721
• Improve performance of style function evaluation #​3816

Bug fixes

• Fix exception thrown when using line-color property functions #​3639
• Fix exception thrown when removing a layer and then adding another layer with the same id but different type #​3655
• Fix exception thrown when passing a single point to Map#fitBounds #​3655
• Fix exception thrown occasionally during rapid map mutations #​3681
• Fix rendering defects on pitch=0 on some systems #​3740
• Fix unnecessary CPU usage when displaying a raster layer #​3764
• Fix bug causing sprite after Map#setStyle #​3829
• Fix bug preventing Map from emitting a contextmenu event on Windows browsers #​3822

0.28.0 (November 17 2016)

New features and improvements

• Performance improvements for Map#addLayer and Map#removeLayer #​3584
• Add method for changing layer order at runtime - Map#moveLayer #​3584
• Update vertical punctuation logic to Unicode 9.0 standard #​3608

Bug fixes

• Fix data-driven fill-opacity rendering when using a fill-pattern #​3598
• Fix line rendering artifacts #​3627
• Fix incorrect rendering of opaque fills on top of transparent fills #​2628
• Prevent AssertionErrors from pitching raster layers by only calling Worker#redoPlacement on vector and GeoJSON sources #​3624
• Restore IE11 compatability #​3635
• Fix symbol placement for cached tiles #​3637

0.27.0 (November 11 2016)

⚠️ Breaking changes ⚠️

• Replace fill-extrude-height and fill-extrude-base properties of fill render type with a separate fill-extrusion type (with corresponding fill-extrusion-height and fill-extrusion-base properties), solving problems with render parity and runtime switching between flat and extruded fills. https://github.com/mapbox/mapbox-gl-style-spec/issues/554
• Change the units for extrusion height properties (fill-extrusion-height, fill-extrusion-base) from "magic numbers" to meters. #​3509
• Remove mapboxgl.Control class and change the way custom controls should be implemented. #​3497
• Remove mapboxgl.util functions: inherit, extendAll, debounce, coalesce, startsWith, supportsGeolocation. #​3441 #​3571
• mapboxgl.util is deprecated and will be removed in the next release. #​1408

New features and improvements

• Tons of performance improvements that combined make rendering up to 3 times faster, especially for complex styles. #​3485 #​3489 #​3490 #​3491 #​3498 #​3499 #​3501 #​3510 #​3514 #​3515 #​3486 #​3527 #​3574 ⚡️⚡️⚡️
• 🈯 Added vertical text writing mode for languages that support it. #​3438
• 🈯 Improved line breaking of Chinese and Japanese text in point-placed labels. #​3420
• Reduce the default number of worker threads (mapboxgl.workerCount) for better performance. #​3565
• Automatically use categorical style function type when input values are strings. #​3384
• Improve control buttons accessibility. #​3492
• Remove geolocation button if geolocation is disabled (e.g. the page is not served through https). #​3571
• Added Map#getMaxZoom and Map#getMinZoom methods #​3592

Bugfixes

• Fix several line dash rendering bugs. #​3451
• Fix intermittent map flicker when using image sources. #​3522
• Fix incorrect rendering of semitransparent background layers. #​3521
• Fix broken raster-fade-duration property. #​3532
• Fix handling of extrusion heights with negative values (by clamping to 0). #​3463
• Fix GeoJSON sources not placing labels/icons correctly after map rotation. #​3366
• Fix icon/label placement not respecting order for layers with numeric names. #​3404
• Fix queryRenderedFeatures working incorrectly on colliding labels. #​3459
• Fix a bug where changing extrusion properties at runtime sometimes threw an error. #​3487 #​3468
• Fix a bug where map.loaded() always returned true when using raster tile sources. #​3302
• Fix a bug where moving the map out of bounds sometimes threw failed to invert matrix error. #​3518
• Fixed queryRenderedFeatures throwing an error if no parameters provided. #​3542
• Fixed a bug where using multiple \n in a text field resulted in an error. #​3570

Misc

• 🐞 Fix npm install mapbox-gl pulling in all devDependencies, leading to an extremely slow install. #​3377
• Switch the codebase to ES6. #​3388 #​3408 #​3415 #​3421
• A lot of internal refactoring to make the codebase simpler and more maintainable.
• Various documentation fixes. #​3440

0.26.0 (October 13 2016)

New Features & Improvements

• Add fill-extrude-height and fill-extrude-base style properties (3d buildings) 🏙️ #​3223
• Add customizable colorSpace interpolation to functions #​3245
• Add identity function type #​3274
• Add depth testing for symbols with 'pitch-alignment': 'map' #​3243
• Add dataloading events for styles and sources #​3306
• Add Control suffix to all controls ⚠️ BREAKING CHANGE ⚠️ #​3355
• Calculate style layer refs automatically and get rid of user-specified refs ⚠️ BREAKING CHANGE ⚠️ #​3486

Performance Improvements

• Ensure removing style or source releases all tile resources #​3359

Bugfixes

• Fix bug causing an error when Marker#setLngLat is called #​3294
• Fix bug causing incorrect coordinates in touchend on Android Chrome #​3319
• Fix bug causing incorrect popup positioning at top of screen #​3333
• Restore tile property to data events fired when a tile is removed #​3328
• Fix bug causing "Improve this map" link to not preload map location #​3356

0.25.1 (September 30 2016)

Bugfixes

• Fix bug causing attribution to not be shown #​3278
• Fix bug causing exceptions when symbol text has a trailing newline #​3281

0.25.0 (September 29 2016)

Breaking Changes

• Evented#off now require two arguments; omitting the second argument in order to unbind all listeners for an event
  type is no longer supported, as it could cause unintended unbinding of internal listeners.

New Features & Improvements

• Consolidate undocumented data lifecycle events into data and dataloading events (#​3255)
• Add auto value for style spec properties (#​3203)

Bugfixes

• Fix bug causing "Map#queryRenderedFeatures" to return no features after map rotation or filter change (#​3233)
• Change webpack build process (#​3235) ⚠️ BREAKING CHANGE ⚠️
• Improved error messages for LngLat#convert (#​3232)
• Fix bug where the tiles field is omitted from the RasterTileSource#serialize method (#​3259)
• Comply with HTML spec by replacing the div within the Navigation control <button> with a span element (#​3268)
• Fix bug causing Marker instances to be translated to non-whole pixel coordinates that caused blurriness (#​3270)

Performance Improvements

• Avoid unnecessary style validation (#​3224)
• Share a single blob URL between all workers (#​3239)

0.24.0 (September 19 2016)

New Features & Improvements

• Allow querystrings in mapbox:// URLs #​3113
• Allow "drag rotate" interaction to control pitch #​3105
• Improve performance by decreasing Worker script Blob size #​3158
• Improve vector tile performance #​3067
• Decrease size of distributed library by removing package.json #​3174
• Add support for new lines in text-field #​3179
• Make keyboard navigation smoother #​3190
• Make mouse wheel zooming smoother #​3189
• Add better error message when calling Map#queryRenderedFeatures on nonexistent layer #​3196
• Add support for imperial units on Scale control #​3160
• Add map's pitch to URL hash #​3218

Bugfixes

• Fix exception thrown when using box zoom handler #​3078
• Ensure style filters cannot be mutated by reference #​3093
• Fix exceptions thrown when opening marker-bound popup by click #​3104
• Fix bug causing fills with transparent colors and patterns to not render #​3107
• Fix order of latitudes in Map#getBounds #​3081
• Fix incorrect evaluation of zoom-and-property functions #​2827 #​3155
• Fix incorrect evaluation of property functions #​2828 #​3155
• Fix bug causing garbled text rendering when multiple maps are rendered on the page #​3086
• Fix rendering defects caused by Map#setFilter and map rotation on iOS 10 #​3207
• Fix bug causing image and video sources to disappear when zooming in #​3010

0.23.0 (August 25 2016)

New Features & Improvements

• Add support for line-color property functions #​2938
• Add Scale control #​2940 #​3042
• Improve polygon label placement by rendering labels at the pole of inaccessability #​3038
• Add Popup offset option #​1962
• Add Marker#bindPopup method #​3056

Performance Improvements

• Improve performance of pages with multiple maps using a shared WebWorker pool #​2952

Bugfixes

• Make LatLngBounds obey its documented argument order (southwest, northeast), allowing bounds across the dateline #​2414 ⚠️ BREAKING CHANGE ⚠️
• Fix bug causing fill-opacity property functions to not render as expected #​3061

0.22.1 (August 18 2016)

New Features & Improvements

• 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

Bugfixes

• Fix bug causing exception to be thrown by Map#querySourceFeatures #​3022
• Fix bug causing Map#loaded to return true while there are outstanding tile updates #​2847

0.22.0 (August 11 2016)

Breaking Changes

• The GeoJSONSource, VideoSource, ImageSource constructors are now private. Please use map.addSource({...}) to create sources and map.getSource(...).setData(...) to update GeoJSON sources. #​2667
• 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

New Features & Improvements

• Increase max glyph atlas size to accomodate alphabets with large numbers of characters #​2930
• Add support for filtering features on GeoJSON / vector tile $id #​2888
• Update geolocate icon #​2973
• Add a close event to Popups #​2953
• Add a offset option to Marker #​2885
• Print error events without any listeners to the console #​2852
• Refactored Source interface to prepare for custom source types #​2667

Bugfixes

• Fix opacity property-functions for fill layers #​2971
• Fix DataCloneError in Firefox and IE11 #​2559
• Fix bug preventing camera animations from being triggered in moveend listeners #​2944
• Fix bug preventing fill-outline-color from being unset #​2964
• Fix webpack support #​2887
• Prevent buttons in controls from acting like form submit buttons #​2935
• Fix bug preventing map interactions near two controls in the same corner #​2932
• Fix crash resulting for large style batch queue #​2926

0.21.0 (July 13 2016)

Breaking Changes

• GeoJSON polygon inner rings are now rewound for compliance with the v2 vector tile. This may affect some uses of line-offset, reversing the direction of the offset. #​2889

New Features & Improvements

• 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
• Enable property functions for icon-rotate #​2738
• Enable property functions for fill-opacity #​2733
• Fire Map#mouseout events #​2777
• Allow query parameters on all sprite URLs #​2772
• Increase sprite atlas size to 1024px square, allowing more and larger sprites #​2802
• Add Marker class #​2725 #​2810
• Add {quadkey} URL parameter #​2805
• Add circle-pitch-scale style property #​2821

Bugfixes

• Fix rendering of layers with large numbers of features #​2794
• Fix exceptions thrown during drag-rotate interactions #​2840
• Fix error when adding and removing a layer within the same update cycle #​2845
• Fix false "Geometry exceeds allowed extent" warnings #​2568
• Fix Map#loaded returning true while there are outstanding tile updates #​2847
• Fix style validation error thrown while removing a filter #​2847
• Fix event data object not being passed for double click events #​2814
• Fix multipolygons disappearing from map at certain zoom levels #​2704
• Fix exceptions caused by queryRenderedFeatures in Safari and Firefox #​2822
• Fix mapboxgl#supported() returning true in old versions of IE11 mapbox/mapbox-gl-supported#​1

0.20.1 (June 21 2016)

Bugfixes

• Fixed exception thrown when changing *-translate properties via setPaintProperty (#​2762)

0.20.0 (June 10 2016)

New Features & Improvements

• Add limited WMS support #​2612
• Add workerCount constructor option #​2666
• Improve performance of locationPoint and pointLocation #​2690
• Remove "Not using VertexArrayObject extension" warning messages #​2707
• Add version property to mapboxgl #​2660
• Support property functions in circle-opacity and circle-blur #​2693

Bugfixes

• Fix exception thrown by "drag rotate" handler #​2680
• Return an empty array instead of an empty object from queryRenderedFeatures #​2694
• Fix bug causing map to not render in IE

0.19.1 (June 2 2016)

Bugfixes

• Fix rendering of polygons with more than 35k vertices #​2657

0.19.0 (May 31 2016)

New Features & Improvements

• Allow use of special characters in property field names #​2547
• Improve rendering speeds on fill layers #​1606
• Add data driven styling support for fill-color and fill-outline-color #​2629
• Add has and !has filter operators mapbox/feature-filter#​15
• Improve keyboard handlers with held-down keys #​2530
• Support 'tms' tile scheme #​2565
• Add trackResize option to Map #​2591

Bugfixes

• Scale circles when map is displayed at a pitch #​2541
• Fix background pattern rendering bug #​2557
• Fix bug that prevented removal of a fill-pattern from a fill layer #​2534
• Fix line-pattern and fill-patternrendering #​2596
• Fix some platform specific rendering bugs #​2553
• Return empty object from queryRenderedFeatures before the map is loaded #​2621
• Fix "there is no texture bound to the unit 1" warnings #​2509
• Allow transitioned values to be unset #​2561

0.18.0 (April 13 2016)

New Features & Improvements

• 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

Bugfixes

• Fix errors when unsetting and resetting a style property #​2464
• Fix errors when updating paint properties while using classes #​2496
• Fix errors caused by race condition in unserializeBuckets #​2497
• Fix overzoomed tiles in wrapped worlds #​2482
• Fix errors caused by mutating a filter object after calling Map#setFilter #​2495

0.17.0 (April 13 2016)

Breaking Changes

• 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
• Remove util.throttle #​2345

New Features & Improvements

• Improve performance of all style mutation methods by only recalculating affected properties #​2339
• Improve fading of labels and icons #​2376
• Improve rendering performance by reducing work done on the main thread #​2394
• Validate filters passed to Map#queryRenderedFeatures and Map#querySourceFeatures #​2349
• Display a warning if a vector tile's geometry extent is larger than supported #​2383
• Implement property functions (i.e. data-driven styling) for circle-color and circle-size #​1932
• Add Popup#setDOMContent method #​2436

Bugfixes

• Fix a performance regression caused by using 1 WebWorker instead of # cpus - 1 WebWorkers, slowing down tile loading times #​2408
• Fix a bug in which Map#queryRenderedFeatures would sometimes return features that had been removed #​2353
• Fix clusterMaxZoom option on GeoJSONSource not working as expected #​2374
• Fix anti-aliased rendering for pattern fills #​2372
• Fix exception caused by calling Map#queryRenderedFeatures or Map#querySourceFeatures with no arguments
• Fix exception caused by calling Map#setLayoutProperty for text-field or icon-image #​2407

0.16.0 (March 24 2016)

Breaking Changes

• Replace Map#featuresAt and Map#featuresIn with Map#queryRenderedFeatures and map.querySourceFeatures (#​2224)
  • Replace featuresAt and featuresIn with queryRenderedFeatures
  • Make queryRenderedFeatures synchronous, remove the callback and use the return value.
  • Rename layer parameter to layers and make it an array of layer names.
  • Remove the radius parameter. radius was used with featuresAt to account for style properties like line-width and circle-radius. queryRenderedFeatures accounts for these style properties. If you need to query a larger area, use a bounding box query instead of a point query.
  • Remove the includeGeometry parameter because queryRenderedFeatures always includes geometries.
• Map#debug is renamed to Map#showTileBoundaries (#​2284)
• Map#collisionDebug is renamed to Map#showCollisionBoxes (#​2284)

New Features & Improvements

• Improve overall rendering performance. (#​2221)
• Improve performance of GeoJSONSource#setData. (#​2222)
• Add Map#setMaxBounds method (#​2234)
• Add isActive and isEnabled methods to interaction handlers (#​2238)
• Add Map#setZoomBounds method (#​2243)
• Add touch events (#​2195)
• Add map.queryRenderedFeatures to query the styled and rendered representations of features (#​2224)
• Add map.querySourceFeatures to get features directly from vector tiles, independent of the style (#​2224)
• Add mapboxgl.Geolocate control (#​1939)
• Make background patterns render seamlessly across tile boundaries (#​2305)

Bugfixes

• Fix calls to setFilter, setLayoutProperty, and setLayerZoomRange on ref children (#​2228)
• Fix undefined bucket errors after setFilter calls (#​2244)
• Fix bugs causing hidden symbols to be rendered (#​2246, #​2276)
• Fix raster flickering (#​2236)
• Fix queryRenderedFeatures precision at high zoom levels (#​2292)
• Fix holes in GeoJSON data caused by unexpected winding order (#​2285)
• Fix bug causing deleted features to be returned by queryRenderedFeatures (#​2306)
• Fix bug causing unexpected fill patterns to be rendered (#​2307)
• Fix popup location with preceding sibling elements (#​2311)
• Fix polygon anti-aliasing (#​2319)
• Fix slivers between non-adjacent polygons (#​2319)
• Fix keyboard shortcuts causing page to scroll (#​2312)

0.15.0 (March 1 2016)

New Features & Improvements

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

Bugfixes

• Fix flickering on raster layers (#​2211)
• Fix browser hang when zooming quickly on raster layers (#​2211)

0.14.3 (Feb 25 2016)

New Features & Improvements

• Improve responsiveness of zooming out by using cached parent tiles (#​2168)
• Improve contextual clues on style API validation (#​2170)
• Improve performance of methods including setData (#​2174)

Bugfixes

• Fix incorrectly sized line dashes (#​2099)
• Fix bug in which in feature filter drops features (#​2166)
• Fix bug preventing Map#load from firing when tile "Not Found" errors occured (#​2176)
• Fix rendering artifacts on mobile GPUs (#​2117)

0.14.2 (Feb 19 2016)

Bugfixes

• 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)

0.14.1 (Feb 10 2016)

Bugfixes

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

0.14.0 (Feb 8 2016)

Breaking Changes

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

New Features & Improvements

• Improved error message for invalid colors (#​2006)
• Added support for tiles with variable extents (#​2010)
• Improved filter performance and maximum size (#​2024)
• Changed circle rendering such that all geometry nodes are drawn, not just the geometry's outer ring (#​2027)
• Added Map#getStyle method (#​1982)

Bugfixes

• Fixed bug causing WebGL contexts to be "used up" by calling mapboxgl.supported() (#​2018)
• Fixed non-deterministic symbol z-order sorting (#​2023)
• Fixed garbled labels while zooming (#​2012)
• Fixed icon jumping when touching trackpad with two fingers (#​1990)
• Fixed overzoomed collision debug labels (#​2033)
• Fixed dashes sliding along their line during zooming (#​2039)
• Fixed overscaled minzoom setting for GeoJSON sources (#​1651)
• Fixed overly-strict function validation for duplicate stops (#​2075)
• Fixed crash due to performance.now not being present on some browsers (#​2056)
• Fixed the unsetting of paint properties (#​2037)
• Fixed bug causing multiple interaction handler event listeners to be attached (#​2069)
• Fixed bug causing only a single debug box to be drawn (#​2034)

0.13.1 (Jan 27 2016)

Bugfixes

• Fixed broken npm package due to outdated bundled modules

0.13.0 (Jan 27 2016)

Bugfixes

• 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)

New Features & Improvements

• Added symbol-avoid-edges style property (#​1951)
• Improved symbol-max-angle check algorithm (#​1959)
• Added marker clustering! (#​1931)
• Added zoomstart, zoom, and zoomend events (#​1958)
• Disabled drag on mousedown when using boxzoom (#​1907)

0.12.4 (Jan 19 2016)

Bugfixes

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

0.12.3 (Jan 14 2016)

API Improvements

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

Bugfixes

• Fix flickering with overscaled tiles (#​1921)
• Remove Node.remove calls for IE browser compatibility (#​1900)
• Match patterns at tile boundaries (#​1908)
• Fix Tile#positionAt, fix query tests (#​1899)
• Fix flickering on streets (#​1875)
• Fix text-max-angle property (#​1870)
• Fix overscaled line patterns (#​1856)
• Fix patterns and icons for mismatched pixelRatios (#​1851)
• Fix missing labels when text size 0 at max zoom (#​1809)
• Use linear interp when pixel ratios don't match (#​1601)
• Fix blank areas, flickering in raster layers (#​1876, #​675)
• Fix labels slipping/cropping at tile bounds (#​757)

UX Improvements

• Improve touch handler perceived performance (#​1844)

0.12.2 (Dec 22 2015)

API Improvements

• Support LngLat.convert([w, s, e, n]) (#​1812)
• Invalid GeoJSON is now handled better

Bugfixes

• Fixed Popup#addTo when the popup is already open (#​1811)
• Fixed warping when rotating / zooming really fast
• Map#flyTo now flies across the antimeridan if shorter (#​1853)

0.12.1 (Dec 8 2015)

Breaking changes

• Reversed the direction of line-offset (#​1808)
• Renamed Pinch interaction handler to TouchZoomRotate (#​1777)
• Made Map#update and Map#render private methods (#​1798)
• Made Map#remove remove created DOM elements (#​1789)

API Improvements

• Added an method to disable touch rotation (#​1777)
• Added a position option for Attribution (#​1689)

Bugfixes

• Ensure tile loading errors are properly reported (#​1799)
• Ensure re-adding a previously removed pop-up works (#​1477)

UX Improvements

• Don't round zoom level during double-click interaction (#​1640)

0.12.0 (Dec 2 2015)

API Improvements

• Added line-offset style property (#​1778)

0.11.5 (Dec 1 2015)

Bugfixes

• Fixed unstable symbol layer render order when adding / removing layers (#​1558)
• Fire map loaded event even if raster tiles have errors
• Fix panning animation during easeTo with zoom change
• Fix pitching animation during flyTo
• Fix pitching animation during easeTo
• Prevent rotation from firing mouseend events (#​1104)

API Improvements

• Fire mousedown and mouseup events (#​1411)
• Fire movestart and moveend when panning (#​1658)
• Added drag events (#​1442)
• Request webp images for mapbox:// raster tiles in chrome (#​1725)

UX Improvements

• Added inertia to map rotation (#​620)

0.11.4 (Nov 16 2015)

Bugfixes

• Fix alpha blending of alpha layers (#​1684)

0.11.3 (Nov 10 2015)

Bugfixes

• Fix GeoJSON rendering and performance (#​1685)

UX Improvements

• Use SVG assets for UI controls (#​1657)
• Zoom out with shift + dblclick (#​1666)

0.11.2 (Oct 29 2015)

• Misc performance improvements

Bugfixes

• Fix sprites on systems with non-integer devicePixelRatios (#​1029 #​1475 #​1476)
• Fix layer minZoom being ignored if not less than source maxZoom
• Fix symbol placement at the start of a line (#​1461)
• Fix raster-opacity on non-tile sources (#​1270)
• Ignore boxzoom on shift-click (#​1655)

UX Improvements

• Enable line breaks on common punctuation (#​1115)

API Improvements

• Add toString and toArray methods to LngLat, LngLatBounds (#​1571)
• Add Transform#resize method
• Add Map#getLayer method (#​1183)
• Add Transform#unmodified property (#​1452)
• Propagate WebGL context events (#​1612)

0.11.1 (Sep 30 2015)

Bugfixes

• Add statistics and checkboxes to debug page
• Fix Map#featuresAt for non-4096 vector sources (#​1529)
• Don't fire mousemove on drag-pan
• Fix maxBounds constrains (#​1539)
• Fix maxBounds infinite loop (#​1538)
• Fix memory leak in worker
• Assert valid TileCoord, fix wrap calculation in TileCoord#cover (#​1483)
• Abort raster tile load if not in viewport (#​1490)

API Improvements

• Add Map event listeners for mouseup, contextmenu (right click) (#​1532)

0.11.0 (Sep 11 2015)

API Improvements

• Add Map#featuresIn: a bounding-box feature query
• Emit stylesheet validation errors (#​1436)

UX Improvements

• Handle v8 style center, zoom, bearing, pitch (#​1452)
• Improve circle type styling (#​1446)
• Improve dashed and patterned line antialiasing

Bugfixes

• Load images in a way that respects Cache-Control headers
• Filter for rtree matches to those crossing bbox
• Log errors by default (#​1463)
• Fixed modification of text-size via setLayoutProperty (#​1451)
• Throw on lat > 90 || < -90. (#​1443)
• Fix circle clipping bug (#​1457)

0.10.0 (Aug 21 2015)

Breaking changes

• 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:

  • LatLng was renamed to LngLat
  • LatLngBounds was renamed to LngLatBounds
  • Popup#setLatLng was renamed to Popup#setLngLat
  • Popup#getLatLng was renamed to Popup#getLngLat
  • The latLng property of Map events was renamed lngLat

  The following APIs now expect array coordinates in [longitude, latitude] order:

  • LngLat.convert
  • LngLatBounds.convert
  • Popup#setLngLat
  • The center and maxBounds options of the Map constructor
  • The arguments to Map#setCenter, Map#fitBounds, Map#panTo, and Map#project
  • The center option of Map#jumpTo, Map#easeTo, and Map#flyTo
  • The around option of Map#zoomTo, Map#rotateTo, and Map#easeTo
  • The coordinates properties of video and image sources

• 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.

• 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.

• Mapbox default styles are now hosted via the Styles API rather than www.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.

• 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, use mapbox://styles/mapbox/satellite-hybrid.

• Removed mbgl.config.HTTP_URL and mbgl.config.FORCE_HTTPS; https is always used when connecting to the Mapbox API.

• Renamed mbgl.config.HTTPS_URL to mbgl.config.API_URL.

Bugfixes

• Don't draw halo when halo-width is 0 (#​1381)
• Reverted shader changes that degraded performance on IE

API Improvements

• You can now unset layout and paint properties via the setLayoutProperty and setPaintProperty APIs
  by passing undefined as a property value.
• The layer option of featuresAt now supports an array of layers.

0.9.0 (Jul 29 2015)

• glyphs URL now normalizes without the /v4/ prefix for mapbox:// urls. Legacy behavior for mapbox://fontstacks is still maintained (#​1385)

• Expose geojson-vt options for GeoJSON sources (#​1271)

• bearing snaps to "North" within a tolerance of 7 degrees (#​1059)

• Now you can directly mutate the minzoom and maxzoom layer properties with map.setLayerZoomRange(layerId, minzoom, maxzoom)

• Exposed mapboxgl.Control, a base class used by all UI controls

• Refactored handlers to be individually included in Map options, or enable/disable them individually at runtime, e.g. map.scrollZoom.disable().

• New feature: Batch operations can now be done at once, improving performance for calling multiple style functions: (#​1352)

  style.batch(function(s) {
      s.addLayer({ id: 'first', type: 'symbol', source: 'streets' });
      s.addLayer({ id: 'second', type: 'symbol', source: 'streets' });
      s.addLayer({ id: 'third', type: 'symbol', source: 'terrain' });
      s.setPaintProperty('first', 'text-color', 'black');
      s.setPaintProperty('first', 'text-halo-color', 'white');
  });

• Improved documentation

• featuresAt performance improvements by exposing includeGeometry option

• Better label placement along lines (#​1283)

• Improvements to round linejoins on semi-transparent lines (mapbox/mapbox-gl-native#​1771)

• Round zoom levels for raster tile loading (2a2aec)

• Source#reload cannot be called if source is not loaded (#​1198)

• Events bubble to the canvas container for custom overlays (#​1301)

• Move handlers are now bound on mousedown and touchstart events

• map.featuresAt() now works across the dateline

0.8.1 (Jun 16 2015)

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

0.8.0 (Jun 15 2015)

Breaking changes

• 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

• 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

• mapboxgl.Source is no longer exported. Use map.addSource() instead. See the
  GeoJSON line or
  GeoJSON markers
  examples.

• mapboxgl.util.supported() moved to mapboxgl.supported().

UX improvements

• Add perspective rendering (#​1049)
• Better and faster labelling (#​1079)
• Add touch interactions support on mobile devices (#​949)
• Viewport-relative popup arrows (#​1065)
• Normalize mousewheel zooming speed (#​1060)
• Add proper handling of GeoJSON features that cross the date line (#​1275)
• Sort overlapping symbols in the y direction (#​470)
• Control buttons are now on a 30 pixel grid (#​1143)
• Improve GeoJSON processing performance

API Improvements

• Switch to JSDoc for documentation
• Bundling with browserify is now supported
• Validate incoming map styles (#​1054)
• Add Map setPitch getPitch
• Add Map dblclick event. (#​1168)
• Add Map getSource (660a8c1)
• Add Map setFilter and getFilter (#​985)
• Add Map failIfMajorPerformanceCaveat option (#​1082)
• Add Map preserveDrawingBuffer option (#​1232)
• Add VideoSource getVideo() (#​1162)
• Support vector tiles with extents other than 4096 (#​1227)
• Use a DOM hierarchy that supports evented overlays (#​1217)
• Pass latLng to the event object (#​1068)

UX Bugfixes

• Fix rendering glitch on iOS 8 (#​750)
• Fix line triangulation errors (#​1120, #​992)
• Support unicode range 65280-65535 (#​1108)
• Fix cracks between fill patterns (#​972)
• Fix angle of icons aligned with lines (37a498a)
• Fix dashed line bug for overscaled tiles (#​1132)
• Fix icon artifacts caused by sprite neighbors (#​1195)

API Bugfixes

• Don't fire spurious moveend events on mouseup (#​1107)
• Fix a race condition in featuresAt (#​1220)
• Fix for brittle fontstack name convention (#​1070)
• Fix broken Popup setHTML (#​1272)
• Fix an issue with cross-origin image requests (#​1269)

0.7.0 (Mar 3 2015)

Breaking

• Rename Map hover event to mousemove.
• Change featuresAt to return GeoJSON objects, including geometry (#​1010)
• Remove Map canvas and container properties, add getCanvas and getContainer methods instead

UX Improvements

• Improve line label density
• Add boxzoom interaction (#​1038)
• Add keyboard interaction (#​1034)
• Faster GeoJSONSource setData without flickering (#​973)

API Improvements

• Add Popup component (#​325)
• Add layer API (#​1022)
• Add filter API (#​985)
• More efficient filter API (#​1018)
• Accept plain old JS object for addSource (#​1021)
• Reparse overscaled tiles

Bugfixes

• Fix featuresAt for LineStrings (#​1006)
• Fix tileSize argument to GeoJSON worker (#​987)
• Remove extraneous files from the npm package (#​1024)
• Hide "improve map" link in print (#​988)

0.6.0 (Feb 9 2015)

Bugfixes

• Add wrapped padding to sprite for repeating images (#​972)
• Clear color buffers before rendering (#​966)
• Make line-opacity work with line-image (#​970)
• event.toElement fallback for Firefox (#​932)
• skip duplicate vertices at ends of lines (#​776)
• allow characters outside \w to be used in token
• Clear old tiles when new GeoJSON is loaded (#​905)

Improvements

• Added map.setPaintProperty(), map.getPaintProperty(), map.setLayoutProperty(), and map.getLayoutProperty().
• Switch to ESLint and more strict code rules (#​957)
• Grab 2x raster tiles if retina (#​754)
• Support for mapbox:// style URLs (#​875)

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.
• HTTP_URL and HTTPS_URL config options must no longer include a /v4 path prefix.
• addClass, removeClass, setClasses, hasClass, and getClasses are now methods
  on Map.
• Style#cascade is now private, pending a public style mutation API (#​755).
• The format for featuresAt results changed. Instead of result-per-geometry-cross-layer,
  each result has a layers array with all layers that contain the feature. This avoids
  duplication of geometry and properties in the result set.

0.5.2 (Jan 07 2015)

Bugfixes

• Remove tiles for unused sources (#​863)
• Fix fill pattern alignment

Improvements

• Add GeoJSONSource maxzoom option (#​760)
• Return ref layers in featuresAt (#​847)
• Return any extra layer keys provided in the stylesheet in featuresAt
• Faster protobuf parsing

0.5.1 (Dec 19 2014)

Bugfixes

• Fix race conditions with style loading/rendering
• Fix race conditions with setStyle
• Fix map.remove()
• Fix featuresAt properties

0.5.0 (Dec 17 2014)

Bugfixes

• Fix multiple calls to setStyle

Improvements

• featuresAt now returns additional information
• Complete style/source/tile event suite:
  style.load, style.error, style.change,
  source.add, source.remove, source.load, source.error, source.change,
  tile.add, tile.remove, tile.load, tile.error
• Vastly improved performance and correctness for GeoJSON sources
• Map#setStyle accepts a style URL
• Support {prefix} in tile URL templates
• Provide a source map with minified source

Breaking

• Results format for featuresAt changed

0.4.2 (Nov 14 2014)

Bugfixes

• Ensure only one easing is active at a time (#​807)
• Don't require style to perform easings (#​817)
• Fix raster tiles sometimes not showing up (#​761)

Improvements

• Internet Explorer 11 support (experimental)

0.4.1 (Nov 10 2014)

Bugfixes

• Interpolate to the closest bearing when doing rotation animations (#​818)

0.4.0 (Nov 4 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.

0.3.2 (Oct 23 2014)

Bugfixes

• Fix worker initialization with deferred or async scripts

Improvements

• Added map.remove()
• CDN assets are now served with gzip compression

0.3.1 (Oct 06 2014)

Bugfixes

• Fixed iteration over arrays with for/in
• Made browserify deps non-dev (#​752)

0.3.0 (Sep 23 2014)

Breaking

• Updated to mapbox-gl-style-spec v0.0.5 (Changelog). Styles are
  now expected to be version 5. You can use the gl-style-migrate
  utility to update existing styles.
• Removed support for composite layers for performance reasons. #​523
• raster-hue-rotate units are now degrees.

Improvements

• Added LatLng#wrap
• Added support for Mapbox fontstack API.
• Added support for remote, non-Mapbox TileJSON sources and inline TileJSON sources (#​535, #​698).
• Added support for symbol-avoid-edges property to allow labels to be placed across tile edges.
• Fixed mkdir issue on Windows (#​674).
• Fixed drawing beveled line joins without overlap.

Bugfixes

• Fixed performance when underzooming a layer's minzoom.
• Fixed raster-opacity for regular raster layers.
• Fixed various corner cases of easing functions.
• Do not modify original stylesheet (#​728).
• Inherit video source from source (#​699).
• Fixed interactivity for geojson layers.
• Stop dblclick on navigation so the map does not pan (#​715).

0.2.2 (Aug 12 2014)

Breaking

• map.setBearing() no longer supports a second argument. Use map.rotateTo with an offset option and duration 0
  if you need to rotate around a point other than the map center.

Improvements

• Improved GeoJSONSource to also accept URL as data option, eliminating a huge performance bottleneck in case of large GeoJSON files.
  #​669 #​671
• Switched to a different fill outlines rendering approach. #​668
• Made the minified build 12% smaller gzipped (66 KB now).
• Added around option to Map zoomTo/rotateTo.
• Made the permalink hash more compact.
• Bevel linejoins no longer overlap and look much better when drawn with transparency.

Bugfixes

• Fixed the broken minified build. #​679
• Fixed blurry icons rendering. #​666
• Fixed util.supports WebGL detection producing false positives in some cases. #​677
• Fixed invalid font configuration completely blocking tile rendering. #​662
• Fixed Map project/unproject to properly accept array-form values.
• Fixed sprite loading race condition. #​593
• Fixed GeoJSONSource setData not updating the map until zoomed or panned. #​676

0.2.1 (Aug 8 2014)

Breaking

• Changed Navigation control signature: now it doesn't need map in constructor
  and gets added with map.addControl(nav) or nav.addTo(map).
• Updated CSS classes to have consistent naming prefixed with mapboxgl-.

Improvements

• Added attribution control (present by default, disable by passing attributionControl: false in options).
• Added rotation by dragging the compass control.
• Added grabbing cursors for the map by default.
• Added util.inherit and util.debounce functions.
• Changed the default debug page style to OSM Bright.
• Token replacements now support dashes.
• Improved navigation control design.

Bugfixes

• Fixed compass control to rotate its icon with the map.
• Fixed navigation control cursors.
• Fixed inertia going to the wrong direction in a rotated map.
• Fixed inertia race condition where error was sometimes thrown after erratic panning/zooming.

0.2.0 (Aug 6 2014)

• First public release.

v0.41.0

Compare Source

⚠️ Breaking changes

• Removed support for paint classes #​3643. Instead, use runtime styling APIs or Map#setStyle.
• Reverted the canvas source contextType option added in 0.40.0 #​5449

🐛 Bug fixes

• Clip raster tiles to avoid tile overlap #​5105
• Guard for offset edgecase in flyTo #​5331
• Ensure the map is updated after the sprite loads #​5367
• Limit animation duration on flyTo with maxDuration option #​5349
• Make double-tapping on make zoom in by a factor of 2 on iOS #​5274
• Fix rendering error with translucent raster tiles #​5380
• Error if invalid 'before' argument is passed to Map#addLayer #​5401
• Revert CanvasSource intermediary image buffer fix #​5449

✨ Features and improvements

• Use setData operation when diffing geojson sources #​5332

• Return early from draw calls on layers where opacity=0 #​5429

• A heatmap layer type is now available. This layer type allows you to visualize and explore massive datasets of points, reflecting the shape and density of data well while also looking beautiful. See the blog post for further details.
  

• The value of a style property or filter can now be an expression. Expressions are a way of doing data-driven and zoom-driven styling that provides more flexibility and control, and unifies property and filter syntax.

  Previously, data-driven and zoom-driven styling relied on stop functions: you specify a feature property and a set of input-output pairs that essentially define a “scale” for how the style should be calculated based on the feature property. For example, the following would set circle colors on a green-to-red scale based on the value of feature.properties.population:

  "circle-color": {
    "property": "population",
    "stops": [
      [0, "green"],
      [1000000, "red"]
    ]
  }
  

  This approach is powerful, but we’ve seen a number of use cases that stop functions don't satisfy. Expressions provide the flexibility to address use cases like these:

  Multiple feature properties
  Using more than one feature property to calculate a given style property. E.g., styling land polygon colors based on both feature.properties.land_use_category and feature.properties.elevation.

  Arithmetic
  For some use cases it’s necessary to do some arithmetic on the input data. One example is sizing circles to represent quantitative data. Since a circle’s visual size on the screen is really its area (and A=πr^2), the right way to scale circle-radius is square_root(feature.properties.input_data_value). Another example is unit conversions: feature data may include properties that are in some particular unit. Displaying such data in units appropriate to, say, a user’s preference or location, requires being able to do simple arithmetic (multiplication, division) on whatever value is in the data.

  Conditional logic
  This is a big one: basic if-then logic, for example to decide exactly what text to display for a label based on which properties are available in the feature or even the length of the name. A key example of this is properly supporting bilingual labels, where we have to decide whether to show local + English, local-only, or English-only, based on the data that’s available for each feature.

  String manipulation
  More dynamic control over label text with things like uppercase/lowercase/title case transforms, localized number formatting, etc. Without this functionality, crafting and iterating on label content entails a large data-prep burden.

  Filters
  Style layer filters had similar limitations. Moreover, they use a different syntax, even though their job is very similar to that of data-driven styling functions: filters say, “here’s how to look at a feature and decide whether to draw it,” and data-driven style functions say, “here’s how to look at a feature and decide how to size/color/place it.” Expressions provide a unified syntax for defining parts of a style that need to be calculated dynamically from feature data.

  For information on the syntax and behavior of expressions, please see the documentation.

🔧 Development workflow improvements

• Made the performance benchmarking runner more informative and statistically robust