MapsGL Android - Changelog

1.6.0

May 27, 2026

✨ Features

Add maritime gridded direction layers (for example wave-dir, swell-dir, and related codes) with instanced wind-style arrows, smoother timeline scrubbing, denser grids and shorter arrow tails, and corrected land-mask stacking so encoded layers stay below the mask when layers are added or removed.
```
val config = mapController.getConfigForCode(LayerCode.WAVE_DIR)
mapController.addWeatherLayer(config)
```
Expose MapLoadProgress fields (total, completed, failed, cancelled) on a public top-level type so host apps keep stable ProGuard or R8 mappings when observing MapController.onLoadProgress.
```
mapController.onLoadProgress.observe(this) { progress ->
    val label = "${progress.completed} / ${progress.total}"
}
```

🐞 Bug Fixes

Fix the data inspector so taps on empty map areas clear the panel, and so repeated taps do not accumulate stale hits across layers (issue #31 ).
Align precipitation data inspector values and legend presentation with the JavaScript SDK.
Align load progress behavior with the JavaScript and iOS SDKs.
Fix the alerts vector layer sometimes stopping updates after the layer is removed and added again.
Fix a stuck loading state when a gridded layer is removed while tiles are still downloading, and adjust Kotlin coroutine usage for broader runtime compatibility.
Fix encoded-tile missing-value handling, visible banding, and radar legend alignment, bar labels, and background threading.
Scale instanced gridded icons using device density and keep default layer metadata aligned with the JavaScript SDK.
Fix map camera misalignment at low pitch, dateline and anti-meridian drift, duplicate downloads, and gridded animation across multiple world copies.

🛠 Improvements

Drive gridded timeline blending (dataMeld) from elapsed wall-clock time between updates for smoother playback instead of assuming a fixed frame-rate step.
Decode PNG atlas imagery and apply cell padding in native code to reduce pressure on the Java heap.
Make download-queue progress and the on-map loading indicator more consistent, including time spent binding textures before the indicator clears.

1.5.1

April 13, 2026

🐞 Bug Fixes

Fix issue where results of MapController.query(…) includes features from previous clicks and other layers. (fixes #31 )

1.5.0

March 27, 2026

✨ Features

Add contour layer support including pre-configured layer definitions for mean sea level pressure, temperature, and wind speed.
Add the option to preload animated tile data prior to starting playback. Preloading can be performed automatically by seting MapController.animationOptions.shouldPreloadData or triggered once manually by calling the MapController.preloadAnimationData function.

🛠 Improvements

Improved blending between neighboring encoded tiles.

1.4.0

March 3, 2026

✨ Features

Add legends support for MapController, allowing a configurable legend view to be displayed along with the MapsGL map content. See the Legend documentation for more information.
Add preconfigured legend configurations for all supported weather layers so that active layers automatically display an associated legend when active.

🐞 Bug Fixes

Fix issue where loading indicator would show indefinitely. (fixes #27 )

1.3.1

January 15, 2026

🐞 Bug Fixes

Fix glitchy display of particle layers after adjusting the timeline. (fixes #24 )
Fix incorrect colors for Precipitation layer.

1.3.0

December 10, 2025

✨ Features

Add data inspector control support for MapController, allowing users to tap on the map and view detailed information about the weather data at that location. See the data inspector control documentation for more information.
Add preconfigured data presentations for all supported weather layers to use when formatting their data values shown in a data inspector control.
Add map feature querying support via MapController#query(coord:layerIds:).

🐞 Bug Fixes

Fix particle layers sometimes disappearing at certain zoom levels
Fix missing data in Fire layer

1.2.5

November 20, 2025

🐞 Bug Fixes

Fix layers sometimes not appearing when added to MapController.
Fix for issue where MapController could get stuck in a loading state.

1.2.4

September 24, 2025

🛠 Improvements

Add land mask to maritime layers. This land mask layer will automatically inherit the background color from the current Mapbox map style being used, which currently has limitations when using one of the “satellite” Mapbox styles.
Improve memory management

🐞 Bug Fixes

Increased Stability during timeline animation
Vector Layers no longer disappear after Mapbox style changes at runtime.
Fixed issue where radar could lose snow colors after being removed and added again.

1.2.3

July 31, 2025

🛠 Improvements

Better texture memory management.
Directionally oriented rectangular particles for wave and swell particle layers.
Increased stability during timeline animation.

🐞 Bug Fixes

Fix for a crash that can occur when repeatedly adding and removing layers.
Vector layers no longer disappear after Mapbox style changes at runtime.
Fixed issue where radar could lose snow colors after being removed and added again.

⚠️ Known Issues

To accommodate rectangular particles for wave and swell layers, particle size is now represented by size: Size(width: Int, height: Int) instead of size: Double.

1.2.2

July 11, 2025

🐞 Bug Fixes

Fix for crash that can occur with no internet connection at startup.
Fix for errors when using a time zone with a positive offset.

1.2.1

July 10, 2025

🐞 Bug Fixes

Fix for WorkerThreadException that can occur when adding layers at startup.

1.2.0

June 27, 2025

✨ Features

All vector layers are now supported, including most fill, line, circle, heatmap, symbol, and text weather layers.
Add support for vector paint types and style expressions for data-driven styling of vector layers.
Add support for Admin layers.

🛠 Improvements

Support providing a GeoJSON string as the data for a GeoJSON data source in addition to the existing remote URL or Turf feature collection methods.

⚠️ Known Issues

Built-in layers under the “Roads” categories are not yet supported. Road weather layers are planned for a future release.

🐞 Bug Fixes

Radar now displays rain and mix precipitation, in addtion to rain.

1.2.0-beta.1

June 18, 2025

✨ Features

Add initial support for vector layers from vector tile and GeoJSON data sources. This includes support for most fill, line, circle, heatmap, symbol, and text weather layers.
Add support for vector paint types and style expressions for data-driven styling of vector layers.

🛠 Improvements

Added over 80 new weather layers.
Improved rendering quality and appearance of encoded layers to better align with the MapsGL Javascript SDK.

⚠️ Known Issues

Built-in layers under the “Admin” or “Roads” categories are not yet supported. Admin layers are planned for the final release of 1.2.0, while road weather layers are planned for a future release.

1.1.0

May 23, 2025

✨ Features

Added animation and timeline support to MapController. All currently supported weather layers support animation and timeline functionality.

🛠 Improvements

Better multithreading for faster tile downloads.
Improved rendering quality and appearance of particle layers to better align with the MapsGL Javascript SDK.
Particle visualizations (like wind or currents) now maintain a natural and consistent density whether you’re zoomed way in or zoomed far out.
Large Particles now have a rounder, more refined appearance.

🐞 Bug Fixes

Fix an issue where session tokens were not being re-requested when they expired during an active session.

1.1.0-beta.2

April 30th, 2025

🛠 Improvements

Optimized graphics rendering for smoother map panning, zooming, and overall responsiveness, especially with complex data layers.
Enhanced particle rendering to only process visible particles, leading to smoother performance and reduced battery usage when viewing particle data.
Fixed an issue that could cause choppiness during timeline playback for animated data layers.
Particle visualizations (like wind or currents) now maintain a natural and consistent density whether you’re zoomed way in or zoomed far out.
Removed limitations on how much particle data can be shown at once, allowing for more complete visuals across multiple world copies.
Particles in visualizations now have a rounder, more refined appearance.

🐞 Bug Fixes

Fixed an issue preventing historical data intervals from displaying correctly for Snow Depth and Air Quality layers.
Fixed an issue preventing historical data intervals from displaying correctly for Snow Depth and Air Quality layers.

1.1.0-beta.1

April 16, 2025

✨ Features

Add support for map timeline and layer animation. All supported weather layers are now animatable.

🛠 Improvements

Better multithreading for faster tile downloads.
Particle layers now use compute shaders for improved performance.
Particle layers now more closely match the JavaScript version.

1.0.1

November 22, 2024

🛠 Improvements

Update WeatherService.Radar to use separate color bands for rain, snow, and mixed precipitation.

🐞 Bug Fixes

Fix an issue where WeatherService.WavePeriods returned WeatherService.WaveHeights instead.
Fix an issue where WeatherService.AirQualityIndexCategories returned WeatherService.AirQualityIndex instead.
Fix an issue where WeatherService.SwellPeriods3 returned WeatherService.SwellHeights3 instead.

⚠️ Known Issues

Due to the way that earlier versions of Mapbox handle mutliple world copies, please use Mapbox version 11.3.0+.

1.0.0

October 29, 2024

✨ Features

Add support for fully stylable particle layers.
Improve handling for screen and device rotation.

🛠 Improvements

Improve rendering performance when scrolling and zooming.
Update colors scales for WeatherService.Precipitation, WeatherService.OceanCurrents, and WeatherService.SnowDepth.
Fix particle transitions across tile boundaries.

🐞 Bug Fixes

Fix an issue where the maximum number of world copies being rendered when zoomed out in landscape mode was clamped at 2.
Fix issue with sporadic screen flashing at high zoom levels.
Fix an issue where tiles across the anti-meridian from the center would be rendered at lower detail levels.
Fix render lag for encoded raster data rendering relative to the underlying map layer during fast scrolling.

⚠️ Known Issues

Due to the way that earlier versions of Mapbox handle mutliple world copies, please use Mapbox version 11.3.0+.
WeatherService.Radar layer does not currently depict precipitation types (mix, snow).

1.0.0-beta.2

Aug 20, 2024

✨ Features

Add particle WindParticles layer.
Add Maritime and Air Quality layer categories as well as Snow Depth and Wind Gust layers.
Better support in-app screen rotation.

🛠 Improvements

Improve image download and caching and overall performance.
Update color scales to better align with the MapsGL Javascript SDK.

🐞 Bug Fixes

Fix an issue where tiles would not load until map movement when the map was initialized at a zoom level past the max data zoom.

⚠️ Known Issues

Particle trail rendering and size configuration are not yet supported.
Tile partials currently make use of ancestors, but not decendants.
Displays a maximum of 2 world copies. This can cause visual issues when zoomed out in landscape mode and three world copies should be visible.

1.0.0-beta.1

Jul 1, 2024

Initial beta release with support for raster and encoded raster weather layers using Mapbox GL.