Super Map

Geographic data can be hard to interpret when presented in raw tables or charts, making it difficult to discern trends or disparities. Traditional visualizations, like bar charts or tables, often overwhelm users with too much information, leaving critical patterns hidden. Without geographic context, the data becomes unclear and abstract, slowing down decision-making.

With the Super Map, complex datasets become easy to understand through visually rich choropleth maps. Using color gradients tied directly to data values easily highlights variations, and users can spot patterns and trends more quickly. This powerful, intuitive tool makes geographic data both accessible and actionable, enabling users to make informed decisions faster.

The Super Map plugin can be installed by an Admin, following the directions in Installing QBeeQ Plugins.

Operating system and version support:

The Super Map utilizes an API token to retrieve data from Mapbox. As of Q2025.10.27, the Super Map reads the Mapbox API token stored in Sisense and automatically applies it to the Super Map.

If you are bringing your own Mapbox token (not required), the apiToken: parameter must be updated in the config.js file. You can find it by navigating to: File Management > Plugins > QBeeQGeojsonMap > js > config.js

As the level of granularity increases (for example, moving from state to zip code or census tract), the volume of data grows rapidly. Larger datasets can have a noticeable impact on performance, so it’s a best practice to evaluate your use case carefully and include only the data needed to support it.

While Super Map is designed to work with extremely large datasets, overall performance is influenced by the amount of data being processed and by the capabilities of the underlying Sisense environment. For optimal results, we recommend balancing data granularity with performance requirements.

If you have questions about data volume or performance considerations, please reach out to support@qbeeq.io

Mapbox uses GEOID values to match your dataset to geographic shapes on a map. A GEOID is an identifier used by the U.S. Census Bureau to identify unique geographic boundaries, such as:

When adding data to the geoid it needs a column that contains the correct GEOID so that it can join your data to the correct geospatial polygons.

Here is the list of the data required to values to support the display of polygons on the different native layers offered in the super map

For points to be plotted on the map, each point must have a defined longitude and latitude.

The Super Map (and Mapbox) requires using the Decimal Degrees (DD) format:

This section provides the steps to create a basic map visualization, without any customizations:

Base Map

The base map defines the background layer that displays underneath the plotted points and polygons. The base map can change the visual style of the map background to match the desired look and context.

The Super Map offers the following base maps:

Geoid identification (Map Layers)

The Geoid identification (or map layer) defines the geographic granularity of the data. It determines how data is matched and rendered, and controls the visual context of the map.

The Super Map offers the following map layers, out of the box with no additional steps:

To create a map displaying polygons, in the data panel:

The display points setting is off by default. When enabled, the data panel will update to display point-related options.

To create a map displaying points, in the design panel:

The Super Map allows for the display of points and polygons simultaneously across different map layers. Designers can allow Viewers to change the combination between points and areas (polygons).

The Super allows for a Designer to select multiple layers. The order in which the layers are selected determines two things:

The Super Map allows users to add additional map layers beyond what is natively provided to address expanded use cases. The guide for adding custom layers can be found here.

This section controls which data layers (points and/or polygons) are visible on the map, and whether users can interactively switch between different KPIs.

This section defines how points are styled, colored, and displayed on the map. You can choose how to assign colors, enable clustering, and control tooltip visibility and appearance.

This section allows you to customize the appearance and behavior of the polygon layer on the map. You can define the default KPI, adjust border styling, control opacity, and choose whether to hide empty regions for a cleaner visual display.

This section allows you to configure the title and subtitle displayed at the top of the map widget.

This section allows you to control the initial zoom level and center position of the map when it first loads, ensuring that the default view aligns with your data or region of interest.

As of Q2026.01.21, Designers can control the mouse controls and UI controls related to zooming and panning. The same behavior will persist across both the widget editor for the designer and the dashboard for the Viewer.

This section controls optional map overlays such as a distance scale and legend, providing additional context for map viewers.

The Super Map lets designers add extra data that appears in a tooltip when a Viewer hovers over a polygon or a point on the map.

Select data for tooltips

Points tooltips

Polygon tooltips

To assign tooltips to the polygon layers:

The Super Map allows users to display labels on the polygons from the Polygon Tooltip section. See the guide Super Map Polygon Labels for more information.

This section enables interactive navigation from the map to other dashboards. You can configure Jump To Dashboard (JTD) behavior and apply filters based on selected map elements.

Jump To Dashboard (JTD)

Filters