Skip to Content
Changelog

MapsGL Android - Changelog

1.8.0

Nov 9, 2026

Data query text layers, 1 of 1

✨ Features

  • Add data-query text layers. A *-text layer prints a weather value at each city, with the city name below it. Built-in codes include temperatures-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; set MapController.showTextLabelUnits = true to add the unit, such as 14°C instead of 14. Use DataQueryLayerDescriptor to 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.units is the metric or imperial set for legends and data-query labels. Assigning it reformats both, and onUnitsChange fires 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, and wind-gusts-max. Each frame shows the total, maximum, or minimum up to that time. Import addOperationLayer from com.xweather.mapsgl.weather. See Time-series operation layers.

    mapController.addOperationLayer(OperationLayerCode.PRECIP_ACCUM)
  • MapController.setPaintProperty changes sample and particle paint on a layer that is already on the map: sample.colorscale (or sample.colorScale), particle.density, particle.count, particle.size, particle.speed, particle.trails, and particle.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. setPaintProperty accepts sample.drawRange, sample.drawRange.min, or sample.drawRange.max. On a sample layer, set drawRange before adding the layer. BoundedRange.atLeast and BoundedRange.atMost leave 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 no LayerCode entry. To adjust the paint first, build the source and layer with WeatherService.makeRasterLayer and 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, and weather layer codes.

  • MapController.setLayerFilter changes a vector layer’s filter on the map. Pass null to draw every feature again. See the filter alerts example.

  • GeoJSONSourceDescriptor.data takes inline GeoJSON when you create the source. Setting data on the source after addSource still works.

  • MapController.onLayerError reports 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.shouldPauseWhileLoading holds playback while the map is loading data, and shouldResumeAfterLoading (default true) resumes it when the load finishes.

  • BarLegend.equalWidth gives every color cell the same width (default true on Android). BarLegendLabels.centered centers each label on its color cell, and BarLegendLabels.allowOverlap draws labels that would otherwise be dropped.

  • DataInspectorControl.showCoordinates hides or shows the coordinate row.

  • Add Expression builders for now, toDate, toTime, toLocaleString, toUnit, regex, typeOf, and properties. More of the MapsGL JS operator set evaluates on Android, including coalesce, in, index-of, to-boolean, typeof, downcase / upcase, and rounding, trigonometry, and logarithm math. format is 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, and System.err.println calls.
  • WeatherSource, SortDirection, the unit helpers in com.xweather.mapsgl.utils (FtoC, mphToMs, and others), and the legend Point classes can be used again. GlCapabilities.supportsParticleLayers no longer throws NoSuchMethodError.
  • 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 drawRange are 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 = false keeps a hard edge between stops, a stop below the layer’s data range keeps its color, and an interval with interpolation on draws bands of that width.
  • A fill layer’s filter decides 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.color overrides the COLOR property on features such as alerts, and fill.opacity is 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 *-text layer 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 es run 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 GlCapabilities and the tile geometry types (LatLonBounds, TileCoord, and others) again, and MapController has its class description.

⚠️ Breaking Changes

  • UnitPressure.Millibars now converts with a factor of 1 (it was 20), and UnitPressure.InchesOfMercury converts by the real millibars-per-inch-of-mercury factor. Pressure values you convert through these units change.
  • Expression.time is deprecated. Use Expression.mapTime.
  • TileRequestOptions.params is deprecated. It was never read; set params on 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.onLayerError as MapsGLLayerError.Reason.RENDER_FAILED, and the SDK retries the fetch. A later pan or zoom tries again. addWeatherLayer and addLayer are 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 addWeatherLayer and addLayer calls 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, and places.

  • Custom symbol icons can use a GLSL fragment shader on IconPaint.shader. Declare precision highp float. After changing icon paint on a layer that is already on the map, call MapController.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.meld is 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-tile is no longer required. Remove that dependency and the https://maven.ecc.no/releases repository if you added them. Also remove any protobuf-java exclusion or -dontwarn rules you added for it.
  • If you read raw vector-tile features from VectorData.rawFeatures or MapboxVectorFeature.from, import com.xweather.mapsgl.mvt instead of no.ecc.vectortile and JTS. Property names such as coordinates and exteriorRing are unchanged. addWeatherLayer and addLayer are unaffected.

1.6.1

Jul 30, 2026

✨ Features

  • Mask a layer to land, water, or to other layers on the map. LayerMasks.land() and LayerMasks.water() are the shorthands. The useGlStencilMask switch 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 drawRange match 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-dir and swell-dir, with arrows that stay on the water and play smoothly on the timeline.

    mapController.addWeatherLayer(mapController.getConfigForCode(LayerCode.WAVE_DIR))
  • MapController.onLoadProgress reports total, completed, failed, and cancelled in 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.shouldPreloadData does 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 size is a Size, not a Double. 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, and WeatherService.SwellPeriods3 return 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.
© 2026 Xweather (opens in a new tab)Terms of Service (opens in a new tab)Privacy Policy (opens in a new tab)