mapbox-gl

Features

• Add image expression operator to determine image availability

• Enable text-offset with variable label placement

Improvements

• Faster loading and better look of raster terrain

• Improved code documentation aroud resizing and *RenderedWorldCopies and more (#8748, #8754)

• Improve single vs. multi-touch zoom & pan interaction

Bug fixes

• Fix rendering of collisionBox when text-translate or icon-translate is enabled

• Fix TypeError when reloading a source and immediately removing the map

• Adding tooltip to the geolocation control button (#8735) (h/t BAByrne)

• Add originalEvent property to NavigationControl events (#8693) (h/t stepankuzmin)

• Don't cancel follow mode in the GeolocateControl when resizing the map or rotating the screen

• Fix error when calling Popup#trackPointer before setting its content or location (#8757) (h/t zxwandrew)

• Respect newline characters when text-max-width is set to zero

• Update earcut to v2.2.0 to fix polygon tesselation errors

• Fix icon-fit with variable label placement

• Icons stretched with icon-text-fit are now sized correctly

• Collision detection for icons with icon-text-fit now works correctly

Features

• Introduce text-writing-mode symbol layer property to allow placing point labels vertically. #8399

• Extend variable text placement to work when text/icon-allow-overlap is set to true. #8620

• Allow text-color to be used in formatted expressions to be able to draw different parts of a label in different colors. #8068

Improvements

• Improve tile loading logic to cancel requests more aggressively, improving performance when zooming or panning quickly. #8633

• Display outline on control buttons when focused (e.g. with a tab key) for better accessibility. #8520

• Improve the shape of line round joins. #8275

• Improve performance of processing line layers. #8303

• Improve legibility of info displayed with map.showTileBoundaries = true. #8380 (h/t @andrewharvey)

• Add MercatorCoordinate.meterInMercatorCoordinateUnits method to make it easier to convert from meter units to coordinate values used in custom layers. #8524 (h/t @andrewharvey)

• Improve conversion of legacy filters with duplicate values. #8542

• Move out documentation & examples website source to a separate mapbox-gl-js-docs repo. #8582

Bug Fixes

• Fix a bug where local CJK fonts would switch to server-generated ones in overzoomed tiles. #8657

• Fix precision issues in deck.gl-powered custom layers. #8502

• Fix a bug where fill and line layers wouldn't render correctly over fill extrusions when coming from the same source. #8661

• Fix map loading for documents loaded from Blob URLs. #8612

• Fix classification of relative file:// URLs when in documents loaded from a file URL. #8612

• Remove esm from package dependencies (so that it's not installed on npm install mapbox-gl). #8586 (h/t @DatGreekChick)

Features and improvements

• Add *-sort-key layout property for circle, fill, and line layers, to dictate which features appear above others within a single layer

• Add ability to instantiate maps with specific access tokens

• Accommodate prefers-reduced-motion settings in browser

• Add Map visualizePitch option that tilts the compass as the map pitches (#8208, fixed by #8296) (h/t pakastin)

• Make source options take precedence over TileJSON (#8232) (h/t jingsam)

• Make requirements for text offset properties more precise

• Expose convertFilter API in the style specification (#8493

Bug fixes

• breaking

  Fix changes to text-variable-anchor, such that previous anchor positions would take precedence only if they are present in the updated array (considered a bug fix, but is technically a breaking change from previous behavior)

• Fix rendering of opaque pass layers over heatmap and fill-extrusion layers

• Fix rendering of extraneous vertical line in vector tiles (#8477, fixed by #8479)

• Turn off 'move' event listeners when removing a marker

• Fix class toggling on navigation control for IE (#8495) (h/t cs09g)

• Fix background rotation hovering on geolocate control (#8367) (h/t GuillaumeGomez)

• Fix error in click events on markers where startPos is not defined (#8462) (h/t @msbarry)

• Fix malformed urls when using custom baseAPIURL of a certain form

Minor features and improvements

• Improve line rendering performance by using a more compact line attributes layout

• Improve data-driven symbol layers rendering performance

• Add the ability to disable validation during queryRenderedFeatures and querySourceFeatures calls, as a performance optimization (#8211) (h/t gorshkov-leonid)

• Improve setFilter performance by caching keys in groupByLayout routine (#8122) (h/t vallendm)

• Improve rendering of symbol layers with symbol-z-order: viewport-y, when icons are allowed to overlap but not text

• Prefer breaking lines at a zero width space to allow better break point suggestions for Japanese labels

• Add a WebGLRenderingContext argument to onRemove function of CustomLayerInterface, to allow direct cleanup of related context (#8156) (h/t ogiermaitre)

• Allow zoom speed customization by adding setZoomRate and setWheelZoomRate methods to ScrollZoomHandler (#7863) (h/t sf31)

• Add trackPointer method to Popup API that continuously repositions the popup to the mouse cursor when the cursor is within the map

• Add getElement method to Popup to retrieve the popup's HTML element (#8123) (h/t bravecow)

• Add fill-pattern example to the documentation (#8022) (h/t flawyte)

• Update script detection for Unicode 12.1

• Add nofollow to Mapbox logo & "Improve this map" links (#8106) (h/t viniciuskneves)

• Include source name in invalid GeoJSON error (#8113) (h/t Zirak)

Bug fixes

• Fix updateImage not working as expected in Chrome

• Fix issues with double-tap zoom on touch devices

• Fix duplication of movestart events when zooming (#8259) (h/t bambielli-flex)

• Fix validation of "format" expression failing when options are provided

• Fix setPaintProperty not working on line-pattern property

• Fix the GL context being left in unpredictable states when using custom layers

• Fix unnecessary updates to attribution control string (#8082) (h/t poletani)

• Fix bugs in findStopLessThanOrEqualTo algorithm (#8134) (h/t Mike96Angelo)

• Fix map not displaying properly when inside an element with text-align: center (#8227) (h/t mc100s)

• Clarify in documentation that Popup#maxWidth accepts all max-width CSS values (#8312) (h/t viniciuskneves)

• Fix location dot shadow not displaying (#8119) (h/t bravecow)

• Fix docs dev dependencies being mistakenly installed as package dependencies (#8121) (h/t bravecow)

• Fix geolocate button CSS (#8367, h/t GuillaumeGomez)

• Fix caching for Mapbox tiles

Breaking changes

This release replaces the existing “map views” pricing model in favor of a “map load” model. Learn more in a recent blog post about these changes.

By upgrading to this release, you are opting in to the new map loads pricing.

Why is this change being made?

This change allows us to implement a more standardized and predictable method of billing GL JS map usage. You’ll be charged whenever your website or web application loads, not by when users pan and zoom around the map, incentivizing developers to create highly interactive map experiences. The new pricing structure also creates a significantly larger free tier to help developers get started building their applications with Mapbox tools while pay-as-you-go pricing and automatic volume discounts help your application scale with Mapbox. Session billing also aligns invoices with metrics web developers already track and makes it easier to compare usage with other mapping providers.

What is changing?

• breaking

  Add SKU token to Mapbox API requests #8276

When (and only when) loading tiles from a Mapbox API with a Mapbox access token set (mapboxgl.accessToken), a query parameter named sku will be added to all requests for vector, raster and raster-dem tiles. Every map instance uses a unique sku value, which is refreshed every 12 hours. The token itself is comprised of a token version (always “1”), a sku ID (always “01”) and a random 10-digit base-62 number. The purpose of the token is to allow for metering of map sessions on the server-side. A session lasts from a new map instantiation until the map is destroyed or 12 hours passes, whichever comes first.

For further information on the pricing changes, you can read our blog post and check out our new pricing page, which has a price calculator. As always, you can also contact our team at support.mapbox.com.

Breaking changes

• breaking

  Turned localIdeographFontFamily map option on by default. This may change how CJK labels are rendered, but dramatically improves performance of CJK maps (because the browser no longer needs to download heavy amounts of font data from the server). Add localIdeographFontFamily: false to turn this off. #8008

• breaking

  Added Popup maxWidth option, set to "240px" by default. #7906

Major features

• Added support for updating and animating style images. #7999

• Added support for generating style images dynamically (e.g. for drawing icons based on feature properties). #7987

• Added antialiasing support for custom layers. #7821

• Added a new mapbox-gl-csp.js bundle for strict CSP environments where worker-src: blob is disallowed. #8044

Minor features and improvements

• Improved performance of fill extrusions. #7821

• Improved performance of symbol layers. #7967

• Slightly improved rendering performance in general. #7969

• Slightly improved performance of HTML markers. #8018

• Improved diffing of styles with "visibility": "visible". #8005

• Improved behavior of canvasSource.pause to be more reliable and able to render a single frame. #8130

• Improved zoom buttons to grey out when reaching min/max zoom. #8023

• Added a title to fullscreen control button. #8012

• Added rel="noopener" attributes to links that lead to external websites (such as Mapbox logo and OpenStreetMap edit link) for improved security. #7914

• Added tile size info when map.showTileBoundaries is turned on. #7963

• Significantly improved load times of the benchmark suite. #8066

Bug fixes

• Fixed a bug in Mac Safari 12+ where controls would disappear until you interact with the map. #8193

• Fixed a bug where rapid zooming could produce an Uncaught TypeError: e is not a function error in the console. #7988

• Fixed a bug where removeFeatureState didn't remove the state for tiles on other zoom levels. #8087

• Fixed a bug where removeFeatureState didn't work on features with id equal to 0. #8150

• Fixed a memory leak when calling source.setData(url) many times. #8035

• Fixed a bug where marker lost focus when dragging. #7799

• Fixed a bug where map.getCenter() returned a reference to an internal LngLat object instead of cloning it, leading to potential mutability bugs. #7922

• Fixed a bug where default HTML marker positioning was slightly off. #8074

• Fixed a bug where adding a fill extrusion layer for non-polygon layers would lead to visual artifacts. #7685

• Fixed intermittent Flow failures on CI. #8061

Features and improvements

• Enable fill-extrusion querying with ray picking

• Add clusterProperties option for aggregated cluster properties (#2412, fixed by #7584)

• Allow initial map bounds to be adjusted with fitBounds options. (#7681) (h/t elyobo)

• Remove popups on Map#remove (#7749) (h/t andycalder)

• Add Map#removeFeatureState

• Add number-format expression

• Add symbol-sort-key style property

Bug fixes

• Upgrades Earcut to fix a rare bug in rendering polygons that contain a coincident chain of holes (#7806, fixed by #7878)

• Allow file:// protocol in XHR requests for Cordova/Ionic/etc

• Correctly handle WebP images in Edge 18

• Fix bug which mistakenly requested WebP images in browsers that do not support WebP

• Fix images not being aborted when dequeued

• Fix DEM layer memory leak (#7690, fixed by #7691)

• Set correct color state before rendering custom layer

• Set LngLat.toBounds() default radius to 0 (#7722, fixed by #7723) (h/t cherniavskii)

• Fix race condition in feature-state dependent layers (#7523, fixed by #7790)

• Prevent map.repaint from mistakenly enabling continuous repaints

• Prevent map shaking while zooming in on raster tiles

• Fix query point translation for multi-point geometry (#6833, fixed by #7581)

Breaking changes

• breaking

  Canonicalize tile urls to mapbox:// urls so they can be transformed with config.API_URL

Features and improvements

• Add getter and setter for config.API_URL

• Allow user to define element other than map container for full screen control

• Add validation option to style setters

• Add 'idle' event: fires when no further rendering is expected without further interaction.

Bug fixes

• Fire error when map.getLayoutProperty references missing layer (#7537, fixed by #7539)

• Fix shaky sprites when zooming with scrolling

• Fix layout problems in attribution control (#7608) (h/t lucaswoj)

• Fixes resetting map's pitch to 0 if initial bounds is set (#7617) (h/t stepankuzmin)

• Fix occasional failure to load images after multiple image request abortions #7641

• Update repo url to correct one (#7486) (h/t nicholas-l)

• Fix bug where symbols were sometimes not rendered immediately

• Fix bug where cameraForBounds returns incorrect CameraOptions with asymmetrical padding/offset (#7517, fixed by #7518) (h/t mike-marcacci)

• Use diff+patch approach to map.setStyle when the parameter is a URL (#4025, fixed by #7562)

• Begin touch zoom immediately when rotation disabled (#7582) (h/t msbarry)

• Fix symbol rendering under opaque fill layers

• Fix shaking by aligning raster sources to pixel grid only when map is idle (7426)

• Fix raster layers in Edge 18 by disabling it's incomplete WebP support (7687)

• Fix memory leak in hillshade layer (7691)

• Fix disappearing custom layers (7711)

Features and improvements

• Add initial bounds as map constructor option (#5518) (h/t stepankuzmin)

• Improve performance on machines with > 8 cores (#7407, fixed by #7430)

• Add MercatorCoordinate type

• Allow browser-native contextmenu to be enabled (#2301, fixed by #7369)

• Add an unminified production build to the NPM package

• Add support for LngLat conversion from {lat, lon} (#7507) (h/t bfrengley)

• Add tooltips for navigation controls

• Show attribution only for used sources

• Add telemetry event to log map loads

• Tighten style validation

  • Disallow expressions as stop values

  • Disallow feature-state expressions in filters

Bug fixes

• Fix for GeoJSON geometries not working when coincident with tile boundaries(#7436, fixed by #7448)

• Fix depth buffer-related rendering issues on some Android devices.

• Fix positioning of compact attribution strings (#7444, #7445, and #7391)

• Fix an issue with removing markers in mouse event callbacks (#7442) (h/t vbud)

• Remove controls before destroying a map

• Fix display of Scale control values < 1 (#7469) (h/t MichaelHedman)

• Fix an error when using location hash within iframes in IE11

• Fix depth mode usage in custom layers (#7432) (h/t markusjohnsson)

• Fix an issue with shaky sprite images during scroll zooms

Features and improvements

• 🎉 Add Custom Layers that can be rendered into with user-provided WebGL code

• Add WebGL face culling for increased performance

• Improve speed of expression evaluation

• Automatically coerce to string for concat expression and text-field property (#6190, fixed by #7280)

• Add fill-extrusion-vertical-gradient property for controlling shading of fill extrusions (#5768, fixed by #6841)

• Add update functionality for images provided via ImageSource (#4050, fixed by #7342) (h/t dcervelli)

Bug fixes

• Expressions

  • Fix expressions that use log2 and log10 in IE11 (#7318, fixed by #7320)

  • Fix let expression stripping expected type during parsing (#7300, fixed by #7301)

  • Fix superfluous wrapping of literals in literal expression (#7336, fixed by #7337)

  • Allow calling to-color on values that are already of type Color

  • Fix to-array for empty arrays ((#7261))

  • Fix identity functions for text-field when using formatted text

  • Fix coercion of null to 0 in to-number expression (#7083, fixed by #7274)

• Canvas source

  • Fix missing repeats of CanvasSource when it crosses the antimeridian

  • Fix CanvasSource not respecting alpha values set on canvas element (#7302, fixed by #7309)

• Rendering

  • Fix rendering of fill extrusions with really high heights

  • Fix an error where the map state wouldn't return to loaded after certain runtime styling changes when there were errored tiles in the viewport

  • Fix errors when rendering symbol layers without symbols (#7241, fixed by #7253)

  • Don't fade in symbols with *-allow-overlap: true when panning into the viewport (#7172, fixed by#7244)

• Library

  • Fix disambiguation for mouseover event (#7295, fixed by #7299)

  • Fix silent failure of getImage if an SVG is requested (#7312, fixed by #7313)

  • Fix empty control group box shadow (#7303, fixed by #7304) (h/t Duder-onomy)

  • Fixed an issue where a wrong timestamp was sent for Mapbox turnstile events

  • Fixed a bug that lead to attribution not showing up correctly in Internet Explorer (#3945, fixed by #7391)

September 6, 2018

Breaking changes

• breaking

  Use client{Height/Width} instead of offset{Height/Width} for map canvas sizing (#6848, fixed by #7128)

Bug fixes

• Fix Top Issues list for mapbox-gl-js (#7108, fixed by #7112)

• Fix bug in which symbols with icon-allow-overlap: true, text-allow-overlap: true, text-optional: false would show icons when they shouldn't

• Fix bug where the map would not stop at the exact zoom level requested by Map#FlyTo (#7222) (#7223) (h/t benoitbzl)

• Keep map centered on the center point of a multi-touch gesture when zooming (#6722) (#7191) (h/t pakastin)

• Update the style-spec's old gl-style-migrate script to include conversion of legacy functions and filters to their expression equivalents (#6927, fixed by #7095)

• Fix icon-size for small data-driven values

• Fix bug in the way AJAX requests load local files on iOS web view (#6610) (h/t oscarfonts)

• Fix bug in which canvas sources would not render in world wrapped tiles at the edge of the viewport ([#7271]#7271), fixed by #7273)

Features and improvements

Performance updates:

• Improve time to first render by updating how feature ID maps are transferred to the main thread (#7110, fixed by #7132)

• Reduce size of JSON transmitted from worker thread to main thread

• Improve image/glyph atlas packing algorithm

• Use murmur hash on symbol instance keys to reduce worker transfer costs

• Add GL state management for uniforms

• Add symbol-z-order symbol layout property to style spec

• Implement data-driven styling support for *-pattern properties

• Add Map#fitScreenCoordinates which fits viewport to two points, similar to Map#fitBounds but uses screen coordinates and supports non-zero map bearings

• Re-implement LAB/HSL color space interpolation for expressions (#5326, fixed by #7123)

• Enable benchmark testing for Mapbox styles

• Allow Map#setFeatureState and Map#getFeatureState to accept numeric IDs (#7106) (h/t bfrengley)

Breaking changes

• breaking

  Treat tiles that error with status 404 as empty renderable tiles to prevent rendering duplicate features in some sparse tilesets

Bug fixes

• Fix issue where text-max-angle property was being calculated incorectly internally, causing potential rendering errors when "text-placement": line

• Require feature.id when using Map#setFeatureState

• Fix issue with removing the GeolocateControl when user location is being used (#6977) (h/t sergei-zelinsky)

• Fix memory leak caused by a failure to remove all controls added to the map

• Fix bug where the build would fail when using mapbox-gl webpack 2 and UglifyJSPlugin (#4359, fixed by #6956)

• Fix bug where fitBounds called with coordinates outside the bounds of Web Mercator resulted in uncaught error (#6906, fixed by #6918)

• Fix bug wherein Map#querySourceFeatures was returning bad results on zooms > maxZoom

• Relax typing for equality and order expressions (#6459, fixed by #6961)

• Fix bug where queryPadding for all layers in a source was set by the first layer, causing incorrect querying on other layers and, in some cases, incorrect firing of events associated with individual layers

Features and improvements

• Performance Improvements:

  • Stop unnecessary serialization of symbol source features.

  • Optimize calculation for getting visible tile coordinates

  • Improve performance of creating {Glyph/Image}Atlases

  • Optimize and simplify tile retention logic

• Add a user turnstile event for users accessing Mapbox APIs

• Add support for autogenerating feature ids for GeoJSON sources so they can be used more easily with the Map#setFeatureState API (#7043))

• Add ability to style a symbol layer labels with multple fonts and text sizes via "format" expression

• Add customAttribution option to AttributionControl (#7033) (h/t mklopets)

• Publish Flow type definitions alongside compiled bundle

• Introduce symbol cross fading when crossing integer zoom levels to prevent labels from disappearing before newly loaded tiles' labels can be rendered

• Improvements in label collision detection (#6925))

Features and improvements

• Add configurable drag pan threshold (#6809) (h/t msbarry)

• Add raster-resampling raster paint property (#6411) (h/t andrewharvey)

• Add symbol-placement: line-center

• Add methods for inspecting GeoJSON clusters (#3318, fixed by #6829)

• Add warning to geolocate control when unsupported (#6923) (h/t aendrew)

• Include link to license in compiled bundle

Bug fixes

• Use updateData instead of re-creating buffers for repopulated paint arrays

• Fix ScrollZoom handler setting tr.zoom = NaN

  • Failed to invert matrix error (#6486, fixed by #6924)

  • Fixing matrix errors (#6782, fixed by #6924)

• Fix heatmap tile clipping when layers are ordered above it (#6806, fixed by #6807)

• Fix video source in safari (macOS and iOS) (#6443, fixed by #6811)

• Do not reload errored tiles

• Fix send / remove timing bug in Dispatcher (#6756, fixed by #6826)

• Fix flyTo not zooming to exact given zoom

• Don't stop animation on map resize

• Fix map.getBounds() with rotated map (#6875) (h/t zoltan-mihalyi)

• Support collators in feature filter expressions.

• Fix Webpack production mode compatibility

Breaking changes

• breaking

  Align implicit type casting behavior of match expressions with with case/==

Features and improvements

• :tada: Add Map#setFeatureState and feature-state expression to support interactive styling

• Create draggable Marker with setDraggable

• Add Map#listImages for listing all currently active sprites/images

• Add "crossSourceCollisions" option to disable cross-source collision detection

• Handle text/icon-rotate for symbols with symbol-placement: point

• Automatically compact Mapbox wordmark on narrow maps. (#4282) (h/t andrewharvey)

• Only show compacted AttributionControl on interactive displays (#6506) (h/t andrewharvey)

• Use postcss to inline svg files into css, reduce size of mapbox-gl.css (#6513) (h/t andrewharvey)

• Add support for GeoJSON attribution (#6364) (h/t andrewharvey)

• Add instructions for running individual unit and render tests

• Make Map constructor fail if WebGL init fails. (#6744) (h/t uforic)

• Add browser fallback code for collectResourceTiming: true in web workers

• Remove ignored usage of gl.lineWidth

• Split new bounds calculation out of fitBounds into new method

• Make "Missing Mapbox GL JS CSS" a console warning

• Add rel="noopener" to Mapbox attribution link. (#6729) (h/t gorbypark)

• Update to deep equality check in example code (#6599) (h/t jonsadka)

• Upgrades!

  • Upgrade ESM dependency to ^3.0.39

  • Ditch gl-matrix fork in favor of the original package

  • Update to latest sinon

  • Upgrade to Flow 0.69

  • Update to mapbox-gl-supported 1.4.0

Bug fixes

• collectResourceTiming: true generates error on iOS9 Safari, IE 11

• Fix PopupOptions flow type declarations (#6670) (h/t TimPetricola)

• Add className option to Popup constructor (#6502) (h/t Ashot-KR)

• GeoJSON MultiLineStrings with lineMetrics=true only rendered first line

• Provide target property for mouseenter/over/leave/out events

• Don't break on sources whose name contains "."

• Rotate and pitch with navigationControl broke in v0.45

• Zero-width lines remained visible

• Heatmaps inappropriately clipped at tile boundaries

• Use named exports for style-spec entrypoint module (#6601

• Don't fire click event if default is prevented on mousedown for a drag event (#6697, fixes #6642)

• Double clicking to zoom in breaks map dragging/panning in Edge (#6740) (h/t GUI)

• *-transition properties cannot be set with setPaintProperty()

• Marker with a element does not open the url when clicked

• setRTLTextPlugin fails with relative URLs

• Collision detection incorrect for symbol layers that share the same layout properties

• Fix a possible crash when calling queryRenderedFeatures after querySourceFeatures

• Fix a collision detection issue that could cause labels to temporarily be placed too densely during rapid panning

Breaking changes

• breaking

  Evented#fire and Evented#listens are now marked as private. Though Evented is still exported, and fire and listens are still functional, we encourage you to seek alternatives; a future version may remove their API accessibility or change its behavior. If you are writing a class that needs event emitting functionality, consider using EventEmitter or similar libraries instead.

• breaking

  The "to-string" expression operator now converts null to an empty string rather than to "null". #6534

Features and improvements

• :rainbow: Add line-gradient property #6303

• Add abs, round, floor, and ceil expression operators #6496

• Add collator expression for controlling case and diacritic sensitivity in string comparisons #6270

• Add CSS linting to test suite (h/t @jasonbarry) #6071

• Add support for configurable maxzoom in raster-dem tilesets #6103

• Add Map#isZooming and Map#isRotating methods #6128, #6183

• Add support for Mapzen Terrarium tiles in raster-dem sources #6110

• Add preventDefault method on mousedown, touchstart, and dblclick events #6218

• Add originalEvent property on zoomend and moveend for user-initiated scroll events (h/t @stepankuzmin) #6175

• Accept arguments of type value in "length" expressions #6244

• Introduce MapWheelEvent#6237

• Add setter for ScaleControl units (h/t @ryanhamley) #6138, #6274

• Add open event for Popup #6311

• Explicit "object" type assertions are no longer required when using expressions #6235

• Add anchor option to Marker #6350

• HTMLElement is now passed to Marker as part of the options object, but the old function signature is still supported for backwards compatibility #6356

• Add support for custom colors when using the default Marker SVG element (h/t @andrewharvey) #6416

• Allow CanvasSource initialization from HTMLElement #6424

• Add is-supported-script expression 6260

Bug fixes

• Align raster-dem tiles to pixel grid to eliminate blurry rendering on some devices #6059

• Fix label collision circle debug drawing on overzoomed tiles #6073

• Improve error reporting for some failed requests #6126, #6032

• Fix several Map#queryRenderedFeatures bugs:

  • account for {text, icon}-offset when querying#6135

  • correctly query features that extend across tile boundaries #5756

  • fix querying of circle layer features with -pitch-scaling: 'viewport' or -pitch-alignment: 'map' #6036

  • eliminate flicker effects when using query results to set a hover effect by switching from tile-based to viewport-based symbol querying #6497

• Preserve browser history state when updating the Map hash #6140

• Fix undefined behavior when Map#addLayer is invoked with an id of a preexisting layer #6147

• Fix bug where icon-image would not be rendered if text-field is an empty string #6164

• Ensure all camera methods fire rotatestart and rotateend events #6187

• Always hide duplicate labels #6166

• Fix DragHandler bugs where a left-button mouse click would end a right-button drag rotate and a drag gesture would not end if the control key is down on mouseup #6193

• Add support for calling {DragPanHandler, DragRotateHandler}#disable while a gesture is in progress #6232

• Fix GeolocateControl user location dot sizing when Map's <div> inherits box-sizing: border-box; (h/t @andrewharvey) #6227

• Fix bug causing an off-by-one error in array expression error messages (h/t @drewbo) #6269

• Improve error message when an invalid access token triggers a 401 error #6283

• Fix bug where lines with line-width larger than the sprite height of the line-pattern property would render other sprite images #6246

• Fix broken touch events for DragPanHandler on mobile using Edge (note that zoom/rotate/pitch handlers still do not support Edge touch events #1928) #6325

• Fix race condition in VectorTileWorkerSource#reloadTile causing a rendering timeout #6308

• Fix bug causing redundant gl.stencilFunc calls due to incorrect state checking (h/t @yangdonglai) #6330

• Fix bug where mousedown or touchstart would cancel camera animations in non-interactive maps #6338

• Fix bug causing a full-screen flicker when the map is pitched and a symbol layer uses non-zero text-translate #6365

• Fix bug in to-rgba expression causing division by zero 6388

• Fix bug in cross-fading for *-pattern properties with non-integer zoom stops #6430

• Fix bug where calling Map#remove on a map with constructor option hash: true throws an error (h/t @allthesignals) #6490

• Fix bug causing flickering when panning across the anti-meridian #6438

• Fix error when using tiles of non-power-of-two size #6444

• Fix bug causing Map#moveLayer(layerId, beforeId) to remove the layer when layerId === beforeId #6542

• Fix bug causing Map#querySourceFeatures to throw an Uncaught TypeError(#6555)

• Fix issue where label collision detection was inaccurate for some symbol layers that shared layout properties with another layer #6558

Breaking changes

• breaking

  Due to bug fixes #6005 and #6029, DragPanHandler, DragRotateHandler, and ScrollZoomHandler now fire map movement events (move, rotate, zoom, pitch) only once per render frame, rather than once per mouse/touch event. (See also issue #6047.)

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

• Coalesce GeoJSON "loadData" requests. This prevents high-frequency calls to setData from building up a backlog. #5902

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

• 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

• Fix bug that could cause incorrect collisions for labels placed very near to each other at low zoom levels

• Fix bug causing move events to be fired out of sync with actual map movements

• Fix bug wherein Map did not fire mouseover events (#6000] (h/t @jay-manday)

• Fix bug causing blurry rendering of raster tiles

• Fix potential memory leak caused by removing layers

• Fix bug causing attribution icon to appear incorrectly in compact maps not using Mapbox data

• Fix positioning of default marker element (#6012) (h/t @andrewharvey)

Breaking changes

• breaking

  It is now an error to attempt to remove a source that is in use #5562

• breaking

  It is now an error if the layer specified by the before parameter to moveLayer does not exist #5679

• breaking

  "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

Bug fixes

• Fix an issue with the scale control being too wide #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

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

Breaking changes

• breaking

  Require that heatmap-color use expressions instead of stop functions #5624

• breaking

  Remove support for validating and migrating v6 styles

• breaking

  Remove support for validating v7 styles #5604

• breaking

  Remove support for including {tokens} in expressions for text-field and icon-image #5599

• breaking

  Split curve expression into step and interpolate expressions #5542

• breaking

  Disallow interpolation in expressions for line-dasharray #5519

• breaking

  Map#getLight no longer returns default values; it only returns values explicitly set in the style or at runtime #5682

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

:warning: Breaking changes

• breaking

  Removed support for paint classes #3643. Instead, use runtime styling APIs or Map#setStyle.

• breaking

  Reverted the canvas source contextType option added in 0.40.0 #5449

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

:sparkles: 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.
  !(cdn-images-1.medium.com/max/1600/1*Dme5MAgdA3pY…)

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

:wrench: Development workflow improvements

• Made the performance benchmarking runner more informative and statistically robust

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

• removed

  Remove upper limit on fill-extrusion-height property #5320

:warning: Breaking changes

• breaking

  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.

• breaking

  canvas sources now require a contextType option specifying the drawing context associated with the source canvas. #5155

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

Breaking changes

• breaking

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

• breaking

  Anchor Markers at their center by default #4751 @andrewharvey

• breaking

  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 💖

New features :sparkles

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

Bug fixes :beetle

• Skip rendering for patterned layers when pattern is missing #4687

• Fix bug with map failing to rerender after webglcontextlost event #4725

• 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 :warning: but considered a bugfix]

• Prevent exceptions thrown by empty GeoJSON tiles 4803

Accessibility improvements :sound

• Add aria-label to popup close button #4799

Development workflow + testing improvements :wrench

• Fix equality assertion bug in tests #4731

• Benchmark results page improvements #4746

• breaking

  Require node version >=6.4.0, enabling the use of more ES6 features #4752

• Document missing pitchWithRotate option #4800

• Move Github-specific Markdown files into subdirectory #4806

0.37.0 (May 2nd, 2017)

:warning: Breaking changes

• breaking

  Removed LngLat#wrapToBestWorld

New features :rocket

• Improve popup/marker positioning #4577

• Add Map#isStyleLoaded and Map#areTilesLoaded events #4321

• Support offline sprites using file: protocol #4649 @oscarfonts

Bug fixes :bug

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

• Add flowtype interfaces and definitions @vicapow

• Add stylelinting to ensure mapboxgl- prefix on all classes #4584 @asantos3026

New features :sparkles

• Replace LogoControl logo with the new Mapbox logo #4598

Bug fixes :bug

• 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

• Fix easeTo to cross anti-meridian if the path will be closer, like flyTo #4602

• Fix flyTo/easeTo not to cross anti-meridian if maxBounds is set #4602

• Fix issues with categorical zoom-and-property functions #4614

Development workflow improvements :nerd_face

• 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

Bug fixes :bug

• Add .json extension to style-spec require statements for webpack compatibility #4563 @orangemug

• Fix documentation type for Map#fitBounds #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 a non-integer id field. #4581

New features :rocket

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

• 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

New features :rocket

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

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

• Improve test coverage across several core modules #4432 #4431 #4422 #4244 :bowing_man:

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

• removed

  Remove double options.easing description from the Map#fitBounds documentation #4402

Breaking changes

• breaking

  Automatically add Mapbox wordmark when required by Mapbox TOS #3933

• breaking

  Increase default maxZoom from 20 to 22 #4333

• deprecated

  Deprecate tiledata and tiledataloading events in favor of sourcedata and sourcedataloading. #4347

• breaking

  mapboxgl.util is no longer exported. #4241

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

• Fix an issue where tiles in the source cache were prematurely deleted, resulting in tiles flickering when zooming in and out #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).

Deprecation Notices

• deprecated

  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

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

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

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

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

Breaking changes

• breaking

  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. #554

• breaking

  Change the units for extrusion height properties (fill-extrusion-height, fill-extrusion-base) from "magic numbers" to meters. #3509

• breaking

  Remove mapboxgl.Control class and change the way custom controls should be implemented. #3497

• breaking

  Remove mapboxgl.util functions: inherit, extendAll, debounce, coalesce, startsWith, supportsGeolocation. #3441 #3571

• breaking

  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

New Features & Improvements

• Add fill-extrude-height and fill-extrude-base style properties (3d buildings) :cityscape

• 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

• breaking

  Add Control suffix to all controls :warning: warning

• breaking

  Calculate style layer refs automatically and get rid of user-specified refs :warning: warning

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