All Versions
Latest Version
Avg Release Cycle
8 days
Latest Release
1398 days ago

Changelog History
Page 4

  • v1.6.0-rc.2 Changes

    April 25, 2020

    ๐Ÿฑ โœจ New features

    โšก๏ธ [core] Introduce Source::setMinimumTileUpdateInterval API (#16416)

    โšก๏ธ The Source::setMinimumTileUpdateInterval(Duration) method sets the minimum tile update interval, which is used to throttle the tile update network requests.

    โšก๏ธ The corresponding Source::getMinimumTileUpdateInterval() getter is added too.

    โšก๏ธ Default minimum tile update interval value is Duration::zero().

    [core] Introduce distance expression. (#16397)

    โœ… The distance expression returns the shortest distance between two geometries. The returned value can be consumed as an input into another expression for changing a paint or layout property or filtering features by distance.

    ๐Ÿ‘ Currently, the distance expression supports Point, MultiPoint, LineString, MultiLineString geometry types.

    ๐Ÿ’… [core] Introduce style::Source::setVolatile()/isVolatile() API (#16422)

    The Source::setVolatile(bool) method sets a flag defining whether or not the fetched tiles for the given source should be stored in the local cache.

    The corresponding Source::isVolatile() getter is added too.

    0๏ธโƒฃ By default, the source is not volatile.

    ๐ŸŽ [ios, macos] Allow specifying multiple fonts or font families for local font rendering (#16253)

    0๏ธโƒฃ By default, CJK characters are now set in the font specified by the text-font layout property. If the named font is not installed on the device or bundled with the application, the characters are set in one of the fallback fonts passed into the localFontFamily parameter of mbgl::Renderer::Renderer() and mbgl::MapSnapshotter::MapSnapshotter(). This parameter can now contain a list of font family names, font display names, and font PostScript names, each name separated by a newline.

    ๐Ÿฑ ๐Ÿž Bug fixes

    ๐ŸŽ [ios, macos] Fixed error receiving local file URL response (#16428)

    ๐ŸŽ [ios, macos] Corrected metrics of locally rendered fonts (#16253)

    ๐Ÿ›  CJK characters are now laid out according to the font, so fonts with nonsquare glyphs have the correct kerning. This also fixes an issue where the baseline for CJK characters was too low compared to non-CJK characters.

  • v1.6.0-rc.1 Changes

    April 20, 2020

    ๐Ÿฑ โœจ New features

    ๐Ÿšš [core] Move logging off the main thread (#16325)

    โž• Add source property to limit parent's tile overscale factor (#16347)

    The new property sets a limit for how much parent tile can be overscaled.

    [core][tile mode] Introduce API to collect placed symbols data (#16339)

    The following methods are added to the Renderer class in implemented in the Tile map mode:

    enables or disables collecting of the placed symbols data

    if collecting of the placed symbols data is enabled, returns the reference to the PlacedSymbolData vector holding the collected data.

    [core] Enable circle-sort-key property (#15875)

    โž• Adds support for circle-sort-key property, consistent with symbol-sort-key.

    Sorts drawing order by sort key both within-tile and cross-tile.

    [core] Add LocationIndicator layer (#16340)

    โž• Adds a new layer type, location-indicator, that can be used to add a source-less indicator to the map, comprising raster images and a precision radius in meters.

    โž• Add generic setter for Layer's 'source' property (#16406)

    ๐Ÿฑ ๐Ÿž Bug fixes

    [core][tile mode] Reduce cut-off labels (part 2) (#16369)

    Now, the intersecting symbols are placed across all layers symbol by symbol according to the following rules:

    1. First we look, which of the tile border(s) the symbol intersects and prioritize the the symbol placement accordingly (high priority -> low priority): vertical & horizontal -> vertical -> horizontal
    2. For the symbols that intersect the same tile border(s), assuming the tile border split symbol into several sections, we look at the minimal section length. The symbol with a larger minimal section length is placed first.
    3. For the symbols that intersect the same tile border(s), and have equal minimal section length, we look at the anchor coordinates.

    4. Finally, if all the previous criteria are the same, we look at the symbol key hashes.

    [core][tile mode] Fix variable placement for labels with the icon-text-fit property set (#16382)

    ๐Ÿ‘• The symbolIntersectsTileEdges() util in mbgl::TilePlacement now considers icon shift for the variable symbols with enabled icon-text-fit setting, thus providing more accurate results.

    ๐Ÿšš [core] Correctly log a warning instead of crashing when a non-existent image is attempted to be removed. (#16391)

    [core] Fix segfault resulting from an invalid geometry (#16409)

  • v1.5.2 Changes

    April 27, 2020
    • ๐ŸŽ [macos] Restored support for macOS 10.11โ€“10.14 (#16412)
  • v1.5.1 Changes

    April 03, 2020


    ๐Ÿฑ ๐Ÿž Bug fixes

    [core] Fix assert in gfx resources cleanup (#16349)

    ๐Ÿ›  Fix a resource leak assertion in gl::Context::~Context() that is evaluating false in scenarios where graphics context has been marked as lost.

    Hillshade bucket fix for mapbox-gl-native-ios #240 (#16362)

    โšก๏ธ When dem tiles are loaded, border in neighboring tiles is updated, too leading to bucket re-upload. if std::move moved indices / vertices previously, they are empty and we get crash. Re-upload requires that only DEM texture is re-uploaded, not the quad vertices and indices.

  • v1.5.0 Changes

    March 26, 2020


    ๐Ÿฑ โœจ New features

    [core] Add Renderer::clearData() (#16323)

    The newly added Renderer::clearData() method allows to clear render data and thus save memory and make sure outdated tiles are not shown. It clears data more agressively than Renderer::reduceMemoryUse() does, as it clears not only the cache but all orchestration data, including the data used by the currently rendered frame.

    ๐Ÿ’… [android] Add jni binding for styleable snapshotter (#16286)

    [core] Ability to set generic layer properties using setProperty method (#16324)
    This change enables the following new keys for the mbgl::Layer::setProperty() API:

    • "filter" invokes setFilter()
    • "minzoom" invokes setMinZoom()
    • "maxzoom" invokes setMaxZoom()
    • "source-layer" invokes setSourceLayer()

    ๐Ÿ’… The newly-added API is used in the style-conversion code, which made this code much simpler.

    [android] Expose getLayer, getSource and Observer interface for snapshotter (#16338)

    ๐Ÿฑ ๐Ÿž Bug fixes

    [core] Use TileCoordinates instead of LngLat for within expression calculation (#16319)

    ๐Ÿ›  Fix the issue that within expression evaluates point features inconsistently across zoom levels if the point lies near the boundary of a GeoJSON object (#16301)

    [core][tile mode] Reduce cut-off labels (#16336)

    Place tile intersecting labels first, across all the layers. Thus we reduce the amount of label cut-offs in Tile mode.

    Before, labels were arranged within one symbol layer (one bucket),which was not enough for several symbol layers being placed at the same time.

    [core] Fix issue that within expression returns incorrect results for geometries crossing the anti-meridian (#16330)

  • v1.4.1 Changes

    March 16, 2020


    ๐Ÿฑ ๐Ÿž Bug fixes

    [android] Fix wrong method call in map_snapshotter (#16308)

    ๐Ÿ’… In map_snapshotter, a wrong method call will cause Sanpshotter not works with a style url in Android. This change makes it call the right method to let Snapshotter works.

  • v1.4.0 Changes

    March 13, 2020


    ๐Ÿฑ โœจ New features

    [android] Add jni binding for line-sort-key and fill-sort-key (#16256)

    With this change, android sdk will be able to get sort key for LineLayer and FillLayer.

    ๐Ÿ’… Styleable MapSnapshotter (#16268)

    ๐Ÿ†• New feature provides means of modifying style of a MapSnapshotter. The new API enables several use-cases, such as: adding route overlays, removing extra information (layers) from a base style, adding custom images that are missing from a style.

    [core] Improve stability of symbol placement when the map is tilted (#16287)

    ๐ŸŽ These changes improve performance and bring more stability to the symbol placement for the tilted view, which is mainly used for navigation scenarios.

    ๐Ÿฑ ๐Ÿž Bug fixes

    [core] Fix iterators in addRegularDash() (#16249)

    ๐Ÿ›  Fixes possible crashes when using styles with line patterns.

    0๏ธโƒฃ [default] Fix possible crash at RunLoop::wake() (#16255)

    โšก๏ธ [android] Update toGeoJSON in android_conversion.hpp (#16243)

    Before this chage, toGeoJSON method in android_conversion.hpp could not convert an Object (Map in android) to GeoJSON object.

    But within expression needs to accept an Object and then convert it to the GeoJSON object, now toGeoJSON method can convert both string and Object to GeoJSON.

    [core] Fix within expression algorithm so that false value will be returned when point is on the boundary. Allow using different GeoJSON formats as arguments of within expression.(#16232)

    A valid GeoJSON argument should contain one of the following types: "Feature", "FeatureCollection","Polygon" or "MultiPolygon".

    [core] [tile mode] placement algorithm must consider icons bounding boxes (#16277)

    Tile mode placement algorithm now checks if bounding boxes for both label text and icon are intersecting the edges of the tiles.

    Before, it checked only text bounding boxes and thus label icons might have got cut off.

    [core] Calculate size of an ambient cache without offline region's resources (#15622)

    Resources that belong to an offline region, should not contribute to the amount of space available in the ambient cache.

    [core][tile mode] Fix assertion at line-center placement handling (#16293)

    The Symbol Intersects Tile Edges placement algorithm should not be applied to the symbols with line-center placement.

    ๐Ÿ›  Fixed using of the in expression as a layer filter (#16272)

    ๐Ÿ’… The bug was caused by mbgl::style::conversion::isExpression() always returning false for the in expression.

    ๐Ÿงฉ Architectural changes

    ๐Ÿ”„ Changes to MapSnapshotter threading model (#16268)

    ๐Ÿ’… Snapshotter's threading model has been changed. Previously, Map and HeadlessFrontend that is responsible for rendering snapshot, were running on a dedicated thread. After #16268, Map object lives on client thread, so that the client can access Style object, while HeadlessFrontend lives on a dedicated Snapshotter thread.

    ๐Ÿฑ โš ๏ธ Breaking changes
    • Signature of a MapSnapshotter's constructor has been changed
    • Signature for a MapSnapshotter::snapshot method has been changed
    • Size of an offline regions do not affect ambient cache size (#15622)
    ๐Ÿฑ ๐Ÿ“Œ Known issues
    • When feature is exactly on the geometry boundary, within expression returns inconsistent values for different zoom levels (#16301)
  • v1.3.1 Changes

    March 02, 2020

    ๐Ÿš€ maps-v1.3.1 (2020.02-release-vanillashake)

    ๐Ÿฑ ๐Ÿž Bug fixes

    [core] Fix iterators in addRegularDash() (#16249)

    ๐Ÿ›  Fixes possible crashes when using styles with line patterns.

    0๏ธโƒฃ [default] Fix possible crash at RunLoop::wake() (#16255)

  • v1.3.0 Changes

    February 28, 2020

    ๐Ÿš€ maps-v1.3.0 (2020.02-release-vanillashake)

    ๐Ÿฑ ๐Ÿž Bug fixes

    [core] Fix offline region download freezing (#16230)

    Downloaded resources are put in the buffer and inserted in the database in batches.

    Before this change, the buffer was flushed only at the network response callback and thus it never got flushed if the last required resources were present locally and did not initiate network requests - it caused freezing.

    Now the buffer is flushed every time the remaining resources container gets empty.

    ๐Ÿฑ โœจ New features

    [core] Add Layer::serialize() method (#16231)

    ๐Ÿ†• New method allows serialization of a layer into a Value type, including all modifications done via runtime style API. New method is also an enabler for Style object serialization (sources, layers, etc).

    [android] Add jni binding for min and max pitch (#16236)

    [offline] Offline tool does not hang on 404 error (#16240)

    The missing resource gets skipped and teh offline region download continues.

    ๐Ÿฑ โš ๏ธ Breaking changes

    ๐Ÿ”„ Changes to mbgl::FileSourceManager::getFileSource() (#16238)

    It returns now mbgl::PassRefPtr<FileSource> (previously was std::shared_ptr<FileSource>) in order to enforce keeping the strong reference to the returned object.

    ๐Ÿ’ฅ Breaking code example:
    auto fs = FileSourceManager::getFileSource(); fs->..

    Posible fix:
    std::shared_ptr<FileSource> fs =;

    The mbgl::OnlineFileSource class cannot be used directly (#16238)

    Clients must use the parent mbgl::FileSource interface instead.

    ๐Ÿ’ฅ Breaking code example:
    std::shared_ptr<OnlineFileSource> onlineSource = std::static_pointer_cast<OnlineFileSource>(FileSourceManager::get()->getFileSource(..));

    Possible fix:
    std::shared_ptr<FileSource> onlineSource = FileSourceManager::get()->getFileSource(..);

  • v1.2.2 Changes

    March 02, 2020

    ๐Ÿš€ maps-v1.2.2 (2020.02-release-vanillashake)

    ๐Ÿฑ ๐Ÿž Bug fixes

    [core] Fix iterators in addRegularDash() (#16249)

    ๐Ÿ›  Fixes possible crashes when using styles with line patterns.