# mapsgl

> 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 JavaScript SDK for the web (@xweather/mapsgl) — setting up a MapsGL map controller for Mapbox GL, MapLibre GL, Google Maps, or Leaflet, and adding, removing, styling, filtering, masking, or animating MapsGL weather layers and custom data layers. Use it whenever a task mentions MapsGL, aerisweather.mapsgl, addWeatherLayer, weather map layers, or client-side WebGL weather rendering. Also use it for questions about how MapsGL usage or cost is measured — sessions, the 5-minute clock intervals, the 150x access multiplier, or how many accesses a MapsGL map consumes. Also covers Xweather's attribution requirement — the 'Powered by Vaisala Xweather' credit and logo rules that apply wherever Xweather data or imagery is displayed.

## 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 ~/.claude/skills/mapsgl
```

## From README

MapsGL JavaScript SDK The MapsGL JavaScript SDK (@xweather/mapsgl) renders weather and custom map data client-side in WebGL, layered on top of Mapbox GL, MapLibre GL, Google Maps, or Leaflet. It requires an active Xweather account with Weather API + Maps access (client id + secret). This skill is the web-based JavaScript SDK. For a native Swift app on iOS, iPadOS, Mac Catalyst, or visionOS, use the mapsgl-apple skill instead — a separate SDK with a Swift API (MapboxMapController, WeatherService.LayerCode), its own channels, and a smaller layer set. The concepts below transfer; none of the code does. MapsGL ships for Android as well. Always qualify the name as the MapsGL JavaScript SDK. Xweather ships an unrelated product simply called the JavaScript SDK ( ), so the bare term is ambiguous. Xweather's own naming for the family is MapsGL, MapsGL iOS, and MapsGL Android; "MapsGL JavaScript SDK" is the unambiguous way to name this one.

## Links

- HTML page: https://omgskills.com/library/vaisala-xweather/xweather-agent-skills/plugins/xweather/skills/mapsgl/
- 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-android](https://omgskills.com/library/vaisala-xweather/xweather-agent-skills/plugins/xweather/skills/mapsgl-android/index.md) — This skill should be used when working with the Xweather MapsGL Android SDK (mapsgl-android-sdk / com.xweather.mapsgl)...
   - [@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