MapController

Configuration options that control the behavior of timeline animations and data preloading.

Geographic center of the map in latitude/longitude degrees, kept in sync with the camera.

Pick/inspect weather values at a tap location; enable with addDataInspectorControl.

Internal debounce job for camera move-end handling; managed by MapboxMapController.

Approximate download progress fraction (0f–1f) while tiles are in flight.

All MapsGL map layers currently registered on this controller, keyed by layer id.

Optional UI control for layer legends; install with add.

Observes encoded-tile metadata keys; when a layer id is emitted, that TileLayer refreshes visible tiles. Attach only if you extend encoded sources; normally the controller wires this internally.

Posted when the current load session completes (encoded downloads and bind pipeline idle).

Emits MapLoadProgress while map data loads. Use onLoadProgress.observe(this) { progress -> ... } like other LiveData on this controller. For coroutine / flow access, see onLoadProgressValue.

Same progress as onLoadProgress, exposed as a Signal for coroutine collectors.

Posted when loading begins for any tracked data source (e.g. tile wave started).

Fires with a source id after addSource registers it and the source is ready for layers.

The primary interface for communicating with the Xweather backend.

instance used for managing animation and time-based data.

Library-internal: at least one visible layer is waiting on tile data.

Library-internal: edge detection for post-download refresh.

Library-internal: previous frame had pending tile downloads.

Installs the provided legend control, wiring it to map events and populating initial legends.

Hook for map SDK–specific registration of a custom layer host after MapsGL created the layer.

Activates and initializes the Data Inspector control for the map.

Adds a new layer to the map.

Adds or refreshes the legend defined on forConfig into the current legendControl.

Registers a data source. When the descriptor leaves ImageSourceDescriptor.authenticator / EncodedSourceDescriptor.authenticator / VectorSourceDescriptor.authenticator / GeoJSONSourceDescriptor.authenticator unset, this controller supplies service.authenticator automatically.

Adds a weather layer from a LayerCode preset (source + descriptor + paint from service).

Adds a weather layer from an explicit WeatherConfiguration (use when you built the config from WeatherService factories instead of LayerCode).

Returns the map's current rotational bearing in degrees, if supported. A bearing of 0 orients the map so that north is up.

Visible geographic bounds in latitude/longitude (implementation wraps Mapbox camera).

Returns the map's geographical center coordinate.

Resolves the WeatherConfiguration that would be used for addWeatherLayer with this layerCode.

Returns the map camera's current field-of-view in degrees.

Returns the map's current pitch/tilt in degrees, if supported.

Returns the map's container size.

West/east longitude in degrees for tile enumeration (may lie outside -180, 180 when the camera shows several world copies). Defaults to getBounds; Mapbox uses raw unwrapped bounds so encoded layers can render every visible copy.

Returns A layer given its LayerCode.

Returns the map's current zoom level.

Returns whether the map currently contains a data source with the specified identifier.

Returns whether the map currently contains a weather layer with the specified identifier.

Reorders an existing layer in the host map style.

Removes a previously registered callback for name.

Registers callback for controller-issued events named name (see MapControllerEvents).

Mapbox map click: forwards to the data inspector when it is enabled.

Triggers a manual pre-fetch of tile animation data.

Queries encoded tile layers and Mapbox vector layers at point for the given layer ids.

Recomputes visible tiles for every visible MapsGL layer and marks custom layer hosts dirty.

Deactivates the Data Inspector control and cleans up its associated resources.

Removes a layer by id, detaches consumers, and cleans encoded-grid sidecars when present.

Removes the currently installed legend control and clears any associated observers.

Unregisters a data source from this controller (does not remove layers that still reference it).

Removes the weather layer(s) for code from the map, sources, legends, and mask sidecars as needed.

Sets the map's geographical center coordinate.

Marks the custom layer host for layerId so textures/uniforms are uploaded on the next draw pass.

Toggles visibility of a MapsGL layer by id and triggers a redraw.

Sets a paint-related property on a layer (reserved for future Mapbox style parity; not fully implemented).

Shows or hides every map layer (and optional legend) belonging to code, including composite children.

Sets the map's zoom level.

Dispatches a named event to listeners registered with on for type.