# mapsgl-android

> Claude/Codex skill by [@vaisala-xweather](https://omgskills.com/library/vaisala-xweather/index.md) · 5 stars · Updated 2026-10-19

This skill should be used when working with the Xweather MapsGL Android SDK (mapsgl-android-sdk / com.xweather.mapsgl) - setting up MapboxMapController, adding or removing weather layers via LayerCode or WeatherService configs, styling with StyleValue and Expression, custom sources and layers, legends, data inspector presentations, timeline animation, layer masks, or integrating the AAR/JitPack dependency into an Android app. Use it whenever a task mentions MapsGL Android, MapboxMapController, addWeatherLayer, LayerCode, WeatherService, XweatherAccount, or weather overlays on Mapbox Maps SDK for Android. Also covers MapsGL session-based usage/cost (shared with the JS SDK) and common Android gotchas (Mercator, OpenGL ES 3.0, minSdk 28, Mapbox peer dependency). Documents the MapsGL Android 1.6.1 release - every API here is in that published build, with no unreleased or development-branch surface. When docs and SDK disagree, prefer the SDK (source / KDoc / demos) over xweather.com documentation.

## Install

```sh
git clone https://github.com/vaisala-xweather/xweather-agent-skills /tmp/xweather-agent-skills && ln -s /tmp/xweather-agent-skills/plugins/xweather/skills/mapsgl-android ~/.claude/skills/mapsgl-android
```

## From README

MapsGL Android MapsGL Android renders weather and custom map data on top of the Mapbox Maps SDK for Android (encoded grids via OpenGL ES custom layers; many vector weather layers via Mapbox style layers). Requires an Xweather account (Weather API + Maps) and Mapbox access / downloads tokens. Source of truth (read this first) When answering or writing code, resolve conflicts in this order: The MapsGL Android SDK - public Kotlin APIs in mapsglmaps / published AAR, in-repo demos under app/, and generated KDoc This skill (kept to match the SDK) https://www.xweather.com/docs/mapsgl-android-sdk/ - useful for tutorials and recipes, but often lagging (deprecated ctors, wrong removeWeatherLayer args, missing Mapbox peer dep, "coming soon" for shipped features, invented overload shapes) Prefer the SDK to the docs. If a docs snippet disagrees with a real method signature, package, or demo in the SDK, follow the SDK and say so.

## Links

- HTML page: https://omgskills.com/library/vaisala-xweather/xweather-agent-skills/plugins/xweather/skills/mapsgl-android/
- GitHub: https://github.com/vaisala-xweather/xweather-agent-skills
- Author: [@vaisala-xweather](https://omgskills.com/library/vaisala-xweather/index.md)

## More from this repo

- [mapsgl](https://omgskills.com/library/vaisala-xweather/xweather-agent-skills/plugins/xweather/skills/mapsgl/index.md) — This skill should be used when working with the Xweather MapsGL JavaScript SDK for the web (@xweather/mapsgl) — setting...
   - [@vaisala-xweather](https://omgskills.com/library/vaisala-xweather/index.md) · 5 stars
- [mapsgl-apple](https://omgskills.com/library/vaisala-xweather/xweather-agent-skills/plugins/xweather/skills/mapsgl-apple/index.md) — This skill should be used when working with the Xweather MapsGL SDK for Apple platforms (the MapsGL...
   - [@vaisala-xweather](https://omgskills.com/library/vaisala-xweather/index.md) · 5 stars
- [raster-maps](https://omgskills.com/library/vaisala-xweather/xweather-agent-skills/plugins/xweather/skills/raster-maps/index.md) — This skill should be used to build Xweather Raster Maps image URLs (maps.api.xweather.com) — either static map images...
   - [@vaisala-xweather](https://omgskills.com/library/vaisala-xweather/index.md) · 5 stars