MapsGL Android - Changelog
1.8.0
Nov 9, 2026
Data query text layers, 1 of 1
✨ Features
-
Add data-query text layers. A
*-textlayer prints a weather value at each city, with the city name below it. Built-in codes includetemperatures-text,feels-like-text,humidity-text,cloud-cover-text,precip-rate-text,snow-depth-text,weather-text, and the wind and air-quality variants. Labels show the bare value in the legend’s units, as in MapsGL JS; setMapController.showTextLabelUnits = trueto add the unit, such as14°Cinstead of14. UseDataQueryLayerDescriptorto label your own points, as in the GeoJSON places and custom GeoJSON examples.mapController.addWeatherLayer(LayerCode.TEMPERATURES_TEXT) -
Add a shared display-unit system on the map controller.
MapController.unitsis the metric or imperial set for legends and data-query labels. Assigning it reformats both, andonUnitsChangefires so your own UI can follow. A legend or text layer added after a change comes up in the current set. Tapping a legend toggles metric and imperial through the controller. See Setting map units and Change map units.controller.units = MeasurementUnits.METRIC controller.onUnitsChange.observe(onEach = { units -> // Update any custom UI that displays measured values. }) -
Add time-series operation layers with
addOperationLayer:precip-accum,temperatures-max,temperatures-min, andwind-gusts-max. Each frame shows the total, maximum, or minimum up to that time. ImportaddOperationLayerfromcom.xweather.mapsgl.weather. See Time-series operation layers.mapController.addOperationLayer(OperationLayerCode.PRECIP_ACCUM) -
MapController.setPaintPropertychanges sample and particle paint on a layer that is already on the map:sample.colorscale(orsample.colorScale),particle.density,particle.count,particle.size,particle.speed,particle.trails, andparticle.trailsFade. The legend follows a new color scale.controller.setPaintProperty(layerId, "sample.colorscale", myScale) controller.setPaintProperty(layerId, "particle.density", ParticleDensity.LOW) -
Change a particle layer’s draw range without removing it.
setPaintPropertyacceptssample.drawRange,sample.drawRange.min, orsample.drawRange.max. On a sample layer, setdrawRangebefore adding the layer.BoundedRange.atLeastandBoundedRange.atMostleave one end open; that end comes from the layer’s data range.controller.setPaintProperty(layerId, "sample.drawRange", mphToMs(15.0)..mphToMs(40.0)) -
Add any Xweather Raster Maps product as a layer with
MapController.addRasterLayer, including codes that have noLayerCodeentry. To adjust the paint first, build the source and layer withWeatherService.makeRasterLayerand add them yourself. See the raster layer example.controller.addRasterLayer("radar-hybrid") -
Add the
alerts-short-fuse,power-lines,power-plants,power-generators,power-generator-boundaries,power-generator-centroids,precip-rate, andweatherlayer codes. -
MapController.setLayerFilterchanges a vector layer’s filter on the map. Passnullto draw every feature again. See the filter alerts example. -
GeoJSONSourceDescriptor.datatakes inline GeoJSON when you create the source. Settingdataon the source afteraddSourcestill works. -
MapController.onLayerErrorreports a layer that could not be added or could not draw, with a reason, the layer code, and the driver’s error text when a shader fails to compile. See When a layer fails. -
AnimationOptions.shouldPauseWhileLoadingholds playback while the map is loading data, andshouldResumeAfterLoading(defaulttrue) resumes it when the load finishes. -
BarLegend.equalWidthgives every color cell the same width (defaulttrueon Android).BarLegendLabels.centeredcenters each label on its color cell, andBarLegendLabels.allowOverlapdraws labels that would otherwise be dropped. -
DataInspectorControl.showCoordinateshides or shows the coordinate row. -
Add
Expressionbuilders fornow,toDate,toTime,toLocaleString,toUnit,regex,typeOf, andproperties. More of the MapsGL JS operator set evaluates on Android, includingcoalesce,in,index-of,to-boolean,typeof,downcase/upcase, and rounding, trigonometry, and logarithm math.formatis still not evaluated.
🛠 Improvements
- New example pages for the day/night overlay, layer masking, map units, preloading animation data, temperature and wind-speed labels, draw range, timeline controls, and wind speed categories. The examples page lists every example.
🐞 Bug Fixes
- Minified release builds no longer strip your app’s own
Log,System.out.println, andSystem.err.printlncalls. WeatherSource,SortDirection, the unit helpers incom.xweather.mapsgl.utils(FtoC,mphToMs, and others), and the legendPointclasses can be used again.GlCapabilities.supportsParticleLayersno longer throwsNoSuchMethodError.- A layer that cannot be added or drawn is logged in release builds, including a particle layer refused on a device below OpenGL ES 3.1 (issue #39 ).
- Preloading animation data no longer throws
IndexOutOfBoundsException, and data-query text layers no longer crash the render thread. - Particles outside a particle layer’s
drawRangeare hidden. Previously every particle was drawn and the color scale was stretched across the range. - Particle layers and wave and swell direction arrows honor their masks, so ocean particles and arrows stay on the water.
- A color scale with
interpolate = falsekeeps a hard edge between stops, a stop below the layer’s data range keeps its color, and anintervalwith interpolation on draws bands of that width. - A fill layer’s
filterdecides which features draw, and the data inspector uses that same filter. Two fill layers on one source no longer share geometry. A filter that matches nothing clears the layer. - Road, boundary, and coastline layers draw only the features their filter selects, and layers that share a vector source no longer hide each other.
- Vector fills, lines, and circles draw only inside their own tile, so storm-cell cones and alert fills no longer stack or show ghost copies along tile edges.
- Setting
FillPaint.coloroverrides theCOLORproperty on features such as alerts, andfill.opacityis honored. - Paint changes apply to a particle layer that is already on the map, and removing that layer or changing a color scale frees its GPU memory.
- Layers that share a source no longer re-download each other’s tiles, each tile interval downloads once, and off-screen radar tiles are not downloaded.
- Image raster layers animate with the timeline. Text labels no longer blink during playback, and they follow the timeline when their product is also on the map.
- Pausing or scrubbing the timeline loads the data for the time you land on.
- Adding a product that a
*-textlayer already samples shows its color fill. - Severe alerts disappear once the timeline passes their expiry time.
- Encoded layers draw west of the antimeridian again, and GeoJSON labels show on both sides of it.
- Heatmaps, mean sea-level pressure contours, storm cells, fire icons, and air-quality station colors match MapsGL JS. Contained fires turn gray.
- Custom icon shaders written as
#version 300 esrun on every device. - Wind barbs and arrows keep a constant size and even spacing, and no longer pop in at tile edges.
- The surface-pressure legend shows pressure units, and the radar legend shows one bar when every bar would be the same.
- Running out of room in the text atlas no longer freezes the map.
- Maximum and minimum operation layers no longer flicker during playback.
- The API reference includes
GlCapabilitiesand the tile geometry types (LatLonBounds,TileCoord, and others) again, andMapControllerhas its class description.
⚠️ Breaking Changes
UnitPressure.Millibarsnow converts with a factor of 1 (it was 20), andUnitPressure.InchesOfMercuryconverts by the real millibars-per-inch-of-mercury factor. Pressure values you convert through these units change.Expression.timeis deprecated. UseExpression.mapTime.TileRequestOptions.paramsis deprecated. It was never read; setparamson the source descriptor instead.
1.7.1
Oct 9, 2026
🐞 Bug Fixes
- An encoded weather layer whose metadata cannot load no longer closes the app. That includes a cold start in airplane mode with a layer already enabled, such as wind (issue #40 ). The layer stays on the map without data. The first failure is reported on
MapController.onLayerErrorasMapsGLLayerError.Reason.RENDER_FAILED, and the SDK retries the fetch. A later pan or zoom tries again.addWeatherLayerandaddLayerare unchanged.
1.7.0
Sep 25, 2026
✨ Features
-
Vector weather layers — alerts, lightning, hail, tropical cyclones, fires, earthquakes, and the rest — now animate with the map timeline and draw alongside encoded and particle layers. Existing
addWeatherLayerandaddLayercalls stay the same. -
Filter vector features by the timeline with
Expression.mapTime. Built-in tropical tracks and convective outlooks already do this.layer.filter = Expression.and( listOf( Expression.equals(Expression.get("featureType"), "trackPoint"), Expression.lessThanOrEqual(Expression.get("timestamp"), Expression.mapTime), ) ) -
Add place-name layers:
place-city,place-country,place-state,place-neighborhood, andplaces. -
Custom symbol icons can use a GLSL fragment shader on
IconPaint.shader. Declareprecision highp float. After changing icon paint on a layer that is already on the map, callMapController.refreshGlVectorLayerPaint. -
More of the JavaScript paint and expression set evaluates on Android, including fill and circle sort order, heatmap blur, color interpolation, and
Expression.has.
🐞 Bug Fixes
- A shader that fails to compile no longer closes the app. The layer is turned off and the driver’s message is logged. Particle layers require OpenGL ES 3.1 (issue #39 ).
- The HTML API reference is no longer packaged inside the SDK, so it is no longer copied into your app (issue #38 ).
- Animated symbol shaders and icon spin stay smooth on devices that have been running for a long time.
- Tropical tracks, forecast cones, and icons wrap correctly across the dateline, and forecast-error cones are filled.
- Place labels no longer collide, flicker, drift, or disappear while panning and zooming.
- Vector animation no longer freezes, flashes, or leaves gaps while panning, zooming, or looping.
- Hail-threat polygons stay in the right category as the timeline moves.
- Circle outlines draw in the right order and no longer hide neighboring fills.
- Encoded layers cover both sides of the antimeridian, and
sample.meldis honored during playback. - The loading indicator tracks vector and raster loads, and playback no longer freezes while a vector layer is on the map.
- Radar colors for rain, snow, and mixed precipitation are updated.
- Tropical icons and outlines are closer to the JavaScript SDK.
⚠️ Breaking Changes
no.ecc.vectortile:java-vector-tileis no longer required. Remove that dependency and thehttps://maven.ecc.no/releasesrepository if you added them. Also remove anyprotobuf-javaexclusion or-dontwarnrules you added for it.- If you read raw vector-tile features from
VectorData.rawFeaturesorMapboxVectorFeature.from, importcom.xweather.mapsgl.mvtinstead ofno.ecc.vectortileand JTS. Property names such ascoordinatesandexteriorRingare unchanged.addWeatherLayerandaddLayerare unaffected.
1.6.1
Jul 30, 2026
✨ Features
-
Mask a layer to land, water, or to other layers on the map.
LayerMasks.land()andLayerMasks.water()are the shorthands. TheuseGlStencilMaskswitch has been removed; a mask is applied whenever the layer sets one.val temperature = mapController.getConfigForCode(LayerCode.TEMPERATURES) temperature.layer.layerMask = LayerMasks.land() mapController.addWeatherLayer(temperature) -
On a long timeline, playback starts once about half the frames are ready, then switches to the full set at the next loop. The loading indicator covers the whole download.
-
Weather layers have data ready sooner after you pan or zoom.
-
The data inspector closes when its point scrolls off the map.
🐞 Bug Fixes
- Fix a crash when adding a weather layer (issue #35 ).
- Adding and removing layers no longer leaves the previous tiles on screen.
- Timeline playback resumes after you extend the range, holds the current frame when paused, and does not download extra tiles while paused or scrubbing.
- Wind barbs and arrows no longer jitter between timeline frames.
- Maritime water masks and marine land masks draw correctly.
- The data inspector hides zero precipitation, drops duplicate rows, and stays on screen at the top and bottom edges of the map.
- Vector wind draws again.
- Dark legends, contour spacing, and
drawRangematch the expected scale. - Precipitation and particle layers stay stable while you pan.
1.6.0
Apr 23, 2026
✨ Features
-
Add maritime direction layers such as
wave-dirandswell-dir, with arrows that stay on the water and play smoothly on the timeline.mapController.addWeatherLayer(mapController.getConfigForCode(LayerCode.WAVE_DIR)) -
MapController.onLoadProgressreportstotal,completed,failed, andcancelledin release builds.mapController.onLoadProgress.observe(this) { progress -> val label = "${progress.completed} / ${progress.total}" }
🐞 Bug Fixes
- Tapping empty map clears the data inspector, and repeated taps no longer pile up old results (issue #31 ).
- Precipitation values in the data inspector and legend match the JavaScript SDK.
- The loading indicator matches the JavaScript and iOS SDKs, including while textures are still binding.
- Alerts keep updating after the layer is removed and added again.
- Removing a gridded layer while it is still downloading no longer leaves the loading indicator stuck.
- Encoded tiles and the radar legend handle missing values and bar labels correctly.
- Wind barbs and arrows scale with screen density.
- The camera stays aligned at low pitch, and gridded animation stays correct across the dateline and across multiple world copies.
1.5.0
Mar 27, 2026
✨ Features
- Add contour layers, including mean sea level pressure, temperature, and wind speed.
- Call
MapController.preloadAnimationData()to load the visible animation before playback starts.animationOptions.shouldPreloadDatadoes this automatically.
🐞 Bug Fixes
- Encoded tiles meet cleanly at their edges, including at zoom level 1.
- The data inspector works on contour layers before playback has started.
- Newly active fires use the correct colors.
- Wind-speed contours and their legends use the right range.
1.4.0
Mar 3, 2026
✨ Features
- Add a legend control. Supported weather layers show their legend when they are on the map. See Legends.
🐞 Bug Fixes
- The loading indicator no longer stays on after loading has finished (issue #27 ).
1.3.1
Jan 15, 2026
🐞 Bug Fixes
- Particle layers no longer glitch after you move the timeline (issue #24 ).
- Precipitation colors are corrected.
1.3.0
Dec 10, 2025
✨ Features
- Add the data inspector. Tap the map to read the weather value at that point. Supported layers include a formatted presentation. See Data inspector.
- Query features with
MapController.query.
🐞 Bug Fixes
- Particle layers no longer disappear at some zoom levels.
- The fires layer includes its data.
1.2.5
Nov 7, 2025
🐞 Bug Fixes
- Layers appear reliably when added.
- The map no longer gets stuck in a loading state.
1.2.4
Sep 24, 2025
✨ Features
- Maritime layers include a land mask. The mask uses the Mapbox style’s background color.
🐞 Bug Fixes
- Timeline animation is more stable.
- Vector layers stay on the map after you change the Mapbox style.
- Radar keeps its snow colors after the layer is removed and added again.
1.2.3
Jul 31, 2025
✨ Features
- Wave and swell particles can be drawn as rectangles.
🐞 Bug Fixes
- Fix a crash from repeatedly adding and removing layers.
⚠️ Breaking Changes
- Particle
sizeis aSize, not aDouble. A square particle takes one number:size = Size(4).
1.2.2
Jul 11, 2025
🐞 Bug Fixes
- Fix a crash when the device has no network at startup.
- Time zones with a positive offset no longer produce errors.
1.2.1
Jul 10, 2025
🐞 Bug Fixes
- Fix a crash when adding layers during startup.
1.2.0
Jun 27, 2025
✨ Features
- Add vector layers: fill, line, circle, heatmap, symbol, and text, including admin boundaries.
- Style those layers from feature properties.
- A GeoJSON source can be created from a GeoJSON string.
🐞 Bug Fixes
- Radar shows mixed precipitation as well as rain.
1.2.0-beta.1
Jun 18, 2025
✨ Features
- First support for vector-tile and GeoJSON layers, and for data-driven vector paint.
- More than 80 additional weather layers.
- Encoded layers are closer in appearance to the JavaScript SDK.
1.1.0
May 23, 2025
✨ Features
- Add timeline animation for the supported weather layers.
🐞 Bug Fixes
- Session tokens refresh when they expire during a session.
- Particle layers keep a consistent density as you zoom, and large particles are round.
1.1.0-beta.2
Apr 30, 2025
🐞 Bug Fixes
- Panning, zooming, and timeline playback are smoother.
- Snow depth and air quality show the correct historical intervals.
- Particle layers cover multiple world copies and keep a consistent density as you zoom.
1.1.0-beta.1
Apr 16, 2025
✨ Features
- First support for the map timeline. Supported weather layers can animate.
1.0.1
Nov 22, 2024
🐞 Bug Fixes
- Radar uses separate colors for rain, snow, and mixed precipitation.
WeatherService.WavePeriods,WeatherService.AirQualityIndexCategories, andWeatherService.SwellPeriods3return the layer you asked for.
1.0.0
Oct 29, 2024
✨ Features
- Particle layers can be styled.
- The map handles screen rotation.
🐞 Bug Fixes
- Scrolling and zooming are smoother, including across the antimeridian and in landscape with several world copies.
- Use Mapbox Maps SDK 11.3.0 or newer.
- Colors for precipitation, ocean currents, and snow depth are updated.
1.0.0-beta.2
Aug 20, 2024
✨ Features
- Add wind particles, maritime and air-quality layers, snow depth, and wind gusts.
- The map handles screen rotation.
🐞 Bug Fixes
- Tiles load when the map opens past the maximum data zoom.
- Color scales are closer to the JavaScript SDK.
1.0.0-beta.1
Jul 1, 2024
- First beta. Raster and encoded weather layers on Mapbox.
