# mapsgl-apple

> 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 SDK for Apple platforms (the MapsGL iOS/iPadOS/macCatalyst/visionOS SDK) — installing it via Swift Package Manager, CocoaPods, Carthage or xcframeworks, creating a MapboxMapController or MapLibreMapController, and adding, removing, styling, animating or inspecting MapsGL weather layers in Swift. Use it whenever a task mentions MapsGL on iOS or Apple platforms, mapsgl-apple-sdk, MapsGLMaps, MapsGLMapbox, MapsGLMapLibre, XweatherAccount, WeatherService.LayerCode, addWeatherLayer in Swift, or a native weather map in SwiftUI or UIKit. Also use it for questions about MapsGL session usage or cost in an Apple app — sessions, the 5-minute clock intervals, the access multiplier, and which view and app lifecycle events should attach and detach weather layers. 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-apple ~/.claude/skills/mapsgl-apple
```

## From README

MapsGL for Apple platforms The Xweather MapsGL SDK for Apple platforms renders weather and custom map data client-side with Metal, layered on top of Mapbox Maps or MapLibre Native. It requires an active Xweather account with Weather API + Maps access (client id + secret). Platform support comes from the package manifest: iOS 16+, macCatalyst 16+, visionOS 1+. There is no native macOS (AppKit) target — a "macOS" app here means Mac Catalyst. Docs: https://www.xweather.com/docs/mapsgl-apple-sdk/getting-started · Distribution + demo app: https://github.com/vaisala-xweather/mapsgl-apple-sdk Ask which map provider unless the context tells you The map provider is not a stylistic preference that can be defaulted: Mapbox and MapLibre resolve different Swift Package branches, different transitive SDKs, and different map-view types. Getting it wrong means the code doesn't compile and the package graph has to be redone. So infer it when the context actually says, and ask when it doesn't.

## Links

- HTML page: https://omgskills.com/library/vaisala-xweather/xweather-agent-skills/plugins/xweather/skills/mapsgl-apple/
- 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-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
- [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