GeoSet Multi Map
The GeoSet Multi Map (deck_geoset_multi_map) chart type composes multiple GeoSet Map Layer charts into a single interactive map. Each sub-layer retains its own styling, data source, and legend configuration.
- First create each individual layer as a GeoSet Map Layer chart
- In Superset, go to Charts → + Chart
- Select your dataset (used only for dashboard filters) and choose GeoSet Multi Map as the chart type
- In the Map panel, add your layer charts via GeoSet Layer Charts
Choose the base map style. All layers share the same base map.
When checked, shows the Viewport control for setting a fixed map position. The map will not move when panning or zooming unless you explicitly save a new viewport.
Sets the map center, zoom, pitch, and bearing for the static viewport. See GeoSet Map Layer#Viewport for details on how the controls work.
Select the GeoSet Map Layer charts to include. Only charts of type deck_geoset_map_layer appear in the list.
Each layer has a settings popover (gear icon) with per-layer options:
| Setting | Description |
|---|---|
| Auto Zoom | Automatically zoom the map to fit this layer's features on load. Disabled when Lazy Loading is on or Static Viewport is enabled. |
| Collapse Legend | Start with the legend entry collapsed in the map legend. |
| Hidden by Default | Hide this layer when the map first loads. Toggle it on from the legend. |
| Lazy Loading | Load this layer in the background after other layers have loaded. Lazy layers are fetched in small batches so they don't compete with the initial render. Auto Zoom is automatically disabled for lazy-loaded layers. |
| Lasso Selectable | Include this layer in the lasso tool's layer selection dropdown. Enabled by default. Disable it to hide layers that shouldn't be lasso-selectable (e.g., boundary or reference layers). |
Note: If Enable Static Viewport is off, the viewport selection control is hidden — the map will use the default viewport.
Layers load in three phases to balance fast rendering with a smooth viewport experience:
- Autozoom layers — Layers with Auto Zoom enabled load first, in parallel. The map canvas waits for these to finish so it can calculate the correct viewport before rendering. This prevents a visible "jump" where the map snaps to a new position.
- Eager layers — Remaining non-lazy layers (with Auto Zoom off) load in parallel after the map canvas appears. Each layer is added to the map as it finishes.
- Lazy layers — Layers with Lazy Loading enabled load last, in small batches of 2. Each batch waits for the previous one to finish before starting, which avoids overwhelming the server with many simultaneous requests.
If no layers have Auto Zoom enabled, the map canvas renders immediately after fetching layer metadata, and all non-lazy layers begin loading right away.
When a Multi Map chart is rendered on a dashboard, a unified legend is shown covering all active layers. Each layer's legend entries come from the legend field in its GeoSet Map Layer#legend.
- Toggle visibility — click a legend entry to show/hide that category on the map
- Isolate — double-click a legend entry to hide all other categories
- Layer ordering — drag layer groups in the legend to change their z-order (front to back)
- Collapse/expand — click a group title to collapse its entries
The lasso tool is available on multi-layer maps for selecting and exporting features from a single layer at a time. See GeoSet Map Layer#Lasso Select Tool for full usage details, draw modes, and selection behavior.
On multi-layer maps, the lasso dropdown lists all layers that have the Lasso Selectable setting enabled. Only the selected layer's features are evaluated against the drawn shape. Exported files include the Hover Data and Feature Info columns configured on that layer.
The Filters section (Query panel) applies SQL filters scoped to the Multi Map chart's own dataset. To filter data within individual layer charts, configure filters on those charts directly or use Superset native dashboard filters scoped to the appropriate datasets.
- Layer charts are rendered in the order they appear in the GeoSet Layer Charts list — bottom of the list renders on top
- Each layer chart can have its own zoom visibility range (Min/Max Zoom Slider), useful for showing different levels of detail at different zoom levels
- The Multi Map chart's own dataset only needs to exist for native dashboard filter compatibility — it doesn't need to contain geospatial data itself