Widgets

In Builder, widgets empower users to dynamically explore data, leading to rich visualizations. They also serve to filter data based on the map viewport and interconnected widgets.

Below are the current type of Widgets available to customize your visualization and enable a richer interaction with your data:

  • Formula Widget: Shows aggregated numerical data as a single metric.

  • Category Widget: Segments data into distinct categories displaying aggregated metrics.

  • Pie Widget: Visualizes categorical data by displaying the proportion of each category relative to the whole data set.

  • Histogram Widget: Shows the frequency distribution across equal bins in the data range.

  • Range Widget: Shows a specific range of numerical data adjustable via slider or input values.

  • Time Series Widget: Shows the frequency distribution aggregated by a temporal period. It also allows to create animated maps.

  • Table Widget: Displays tabular data for easy viewing and interaction.

Adding a Widget

Add a widget to Builder by clicking "New Widget" and select your data source.

Then, select a widget type from the menu: Formula, Category, Histogram, Range, Time Series or Table.

Configuring a Widget

Once you have selected the widget type of your preference, you are ready to configure your Widget.

Widget Data

In the Data section of the Widget configuration, choose an aggregation operation COUNT, AVG, MAX, MIN or SUM and, if relevant, specify the column on which to perform the aggregation.

Selecting an operation

When working with pre-generated tilesets, please ensure your data have a unique identifier named geoid for correct Widgets calculations.

Widget Display

Using the Formatting option, you can auto-format data, ensuring enhanced clarity. For instance, you can apply automatic rounding, comma-separations, or percentage displays.

Formatting selector on Widget configuration

You can use Notes to supplement your Widgets with descriptive annotations which support Markdown syntax, allowing to add text formatting, ordered lists, links, etc.

Adding a rich note using markdown

Widget Behavior

Widgets offer two distinct modes of operation: "Global" and "Viewport".

Global Mode

By default widgets are calculated in global mode where information is displayed for the full data source. This option does not take into account the viewport extent of the data.

Viewport Mode

You can configure widgets to work in viewport mode, meaning the data gets updated when the viewport extent changes.

For dynamic tiling sources, viewport widgets get the data by performing a SQL query to the data warehouse; whereas, if you are working with pre-generated tilesets, viewport widgets work with the data that has been downloaded for visualization which is available locally in the browser.

Please be aware that global mode is not supported for pre-generated tileset sources. In such scenarios, the functionality defaults to viewport mode. This means that all calculations are based on the extent of the map's current viewport.

Cross-filtering

Some widgets support cross-filtering, allowing them to filter not only themselves but also other components on the map. When enabled, the widget can apply filters across:

  • A single source (default behavior), affecting all layers and widgets connected to that source.

  • Multiple sources, as long as they share the same filtering property (e.g., region, category, or timestamp).

When cross-filtering is disabled for a widget, it becomes read-only: it still displays aggregated data but cannot trigger any filtering actions on the widget itself or related components. This behavior can be toggled on or off per widget using the cross-filtering toggle in the widget configuration panel.

Limitations

The Time Series widget supports cross-filtering across multiple sources only over the temporal property. Split by property is not supported.

Only one Range widget per map using a specific property can be configured to cross-filter across multiple sources.

Collapsing widgets

In the Behavior section of Builder, you have the option to make Widgets collapsible, allowing them to be hidden when needed. Additionally, widgets can be set to automatically collapse when their associated layers are not visible.

As Widget settings differ between widget types, please visit the individual widget's documentation page for more detailed information.

Last updated

Was this helpful?