MapsGL iOS - Examples

Each example below is a single Swift file from the demo app , which ships in the public repository and runs every one of them. Clone it, add your Xweather API keys, and open the example you want to read alongside the code.

Getting Started

Display a weather mapWire up a map, a controller and two weather layers, with no demo scaffolding.UIKit integrationDrive the same map controller from a UIViewController instead of SwiftUI.

Styling Weather Layers

Recoloring and reshaping the continuous fields the built-in weather layers draw: color scales, draw ranges, and particle motion.

Custom radar colorsSwap between per-precipitation-type radar masks and generic single-value palettes.Custom temperature colorsReplace a sample layer's color scale, as a gradient or in fixed bands.Adjust the draw rangeClip a layer to part of its data range and change it live.Frost and freeze mapClip and band the temperatures layer into agricultural frost categories.Wind speed categoriesShow only notable wind, painted as named categories rather than a gradient.Custom wind particlesTune particle density, speed, trails and color on the wind field.

Features & Filtering

Vector layers, where both the styling and the choice of what to draw are expressions evaluated against each feature’s own properties.

Custom alert stylesColor alert polygons by severity instead of by alert type.Custom lightning stylesFade lightning strikes out as they age, using a step expression.Filter weather alertsDraw a subset of a layer's features with a filter expression.

Animation

Timeline controlsPlay, pause, resume and scrub the timeline, keeping your own UI in step.Change the timeline rangeMove the animation window between history and forecast at runtime.Preload animation dataFetch every frame up front so the first loop plays without stalling.

Legends, Units & Readouts

Reading values back off the map: the legend and data inspector controls, the units those values display in, and labelling your own points with sampled layer values.

Legend and data inspectorAdd the SDK's legend and tap-to-inspect controls, and query values directly.Custom legend labelsRelabel a layer's legend with categories instead of values.Change map unitsChange one quantity's units and watch every layer, legend and readout follow.Values at API placesLabel the largest US cities with temperatures sampled from a weather layer.Values at your own pointsSample wind speeds at points you supply, labelled with their place names.

Your Own Data

Sources MapsGL knows nothing about — your own tiles, geometry and imagery — added alongside the weather layers.

Custom raster layerDraw your own {z}/{x}/{y} image tiles with an ImageSourceDescriptor.Custom vector layerRender a vector tile source, colored from each feature's own properties.Custom GeoJSON layerDraw your own GeoJSON geometry, filled and outlined from one source.Layer maskingClip a raster layer to land or to water with a mask configuration.