Skip to main content

Bounding Box & Analysis Overview

The Bounding Box tool lets you define a geographic analysis region on the Cesium map. Once a region is created and activated, you can run up to 7 simultaneous analytical filters that fetch and visualize data within that area.

The Bounding Box Panel

The Bounding Box panel is always visible at the bottom of the sidebar. It contains:

ButtonDescription
CreateOpens a sub-menu to choose a creation method
EditEnters handle-drag editing mode (enabled only when a box exists)
ActivateRuns the selected analysis filters on the region
DeletePermanently removes the bounding box

The (info) button opens a controls guide popup. The Σ (stats) button (visible when a box is active) opens the region statistics popup.

State Machine

The bounding box operates on a simple state machine:

initial

├── Create → Box → creating-box
├── Create → Draw → drawing-shape
└── Create → Boundary → (boundary dialog opens)

region selected

┌────▼────┐
│ active │◄── Edit → editing → Save/Cancel
└─────────┘

Delete

initial

All UI button states are driven by the current boundingBoxState value.

Region Statistics

When a bounding box is active, the Σ button shows:

StatDescription
AreaSurface area in km²
PerimeterTotal boundary length in km
CenterDecimal degree coordinates of the centroid

All three values have copy-to-clipboard buttons for easy export.

Running Analysis

Once a region is drawn, click Activate to open the filter dialog. Select one or more filters and click Activate in the dialog. The app will:

  1. Query each active filter's data source within the bounding box
  2. Render results on the map (entity pins, heatmap layers, polygon overlays)
  3. Display summary statistics in the results panel

See Analysis Filters for a full description of each filter.

Deactivating

Click Deactivate (the button label changes from Activate once active) to clear all filter results and return the box to an idle state. The box itself remains on the map.

Click Delete to remove the box entirely and reset to the initial state.