Basemap & STAC Inspector Explorer

An interactive mapping exercise centered on GUI panels for switching basemaps, previewing STAC assets, and inspecting map content.

Capabilities

Basemap selection panel

• Presents the provided basemap options in a control panel and switches the visible basemap immediately when a different option is picked. @test
• Defaults to the first basemap in the provided list and shows the active basemap label in the panel. @test

STAC search and preview panel

• Runs a STAC search using a user-supplied time range and bounding box, then overlays a preview of the first returned asset from a chosen collection while zooming to its bounds. @test
• Replaces any existing preview overlay when a new search is performed so only the latest result remains on the map. @test

Inspection panel for active layers

• Provides an inspector panel that, when clicking on the active preview layer, reports the clicked coordinates and a representative value/feature summary from that location. @test
• Shows a clear message in the inspector panel when no preview layer is active instead of failing or returning empty data. @test

Implementation

@generates

API

from typing import Any, Sequence

def build_explorer(
    basemap_choices: Sequence[str],
    stac_endpoint: str,
    collections: Sequence[str],
    default_bbox: Sequence[float] | None = None,
    initial_time_range: tuple[str, str] | None = None,
) -> Any:
    """
    Construct an interactive map widget with GUI panels for basemap switching, STAC discovery/preview, and pixel/feature inspection.

    Returns a widget object suitable for display in notebook or web contexts that exposes the GUI panels on load.
    """

Dependencies { .dependencies }

leafmap { .dependency }

Provides interactive mapping widgets, GUI panels for basemap selection, STAC search, and map inspection tools needed by the explorer.