3D Spinning Globe – QBeeQ

The 3D Spinning Globe is an interactive, animated chart that displays country-level data on a three-dimensional globe. Countries with data are highlighted in configurable colors, with optional point markers at their centers and a tooltip showing your configured measures. Clicking a country filters the entire dashboard, making it easy to explore regional breakdowns in context. It's ideal for executive presentations, global KPI overviews, and any use case where geographic reach needs to be communicated at a glance.

📄

Release Notes for 3D Spinning Globe can be found here.

Installation and configuration

The 3D Spinning Globe plugin can be installed by an Admin, following the directions in Installing QBeeQ Plugins.

Operating system and version support:

Linux - Latest

Windows - Latest

Creating a 3D Spinning Globe

To create a new 3D Spinning Globe:

Choose QBeeQ Globe from the widget dropdown list

Select data for Category, Point Value, and Values

Configure settings

Configure additional settings using config.js (optional)

Select data

Use the data panel to select data to display on the chart:

Panel	Type	Description	Behavior
Category	Dimension	The geographic dimension values matched by country name against ISO codes.	Countries that exist on the globe but have no matching row in your data are shown in the Countries without data color. ⚠️ Rows in your data that cannot be matched to a known ISO country code are silently ignored and do not appear on the globe.
Point Value	Measure	The primary metric displayed in the tooltip for each country.
Values	Measure	Additional measures shown in the tooltip below the Point Value.	Displays on the tooltip in the order from the panel. Maximum 5 items

⚠️

Category and Point Value panels must be populated before the chart will render.

Configure settings

💡

Apply Sisense native conditional formatting to the Values field to dynamically display the country color based on your selected metric.

Setting	Description	Behavior
Points	Shows or hides circular point markers on each country that has data.	When enabled, a dot is placed at the geographic center of each matched country. When disabled, only country polygon coloring is used.
Water Color	Fill color of the ocean/background sphere.	Applied to the background polygon that represents water.
Countries with data	Fill color for countries that have a matching value in the data.	Applied to country polygons where a data row was matched.
Countries without data	Fill color for countries with no matching data.	Applied to all country polygons that are not found in the query result.
Points color	Color of the circular point markers.	Applied to all point bullets. ℹ️ Only visible when Points is enabled.

Configure map settings - config.js

The 3D Spinning Globe uses a config.js file to control additional options. This file controls the global behavior across your entire Sisense instance.

To locate this file:

Go to the Admin tab > App Configurations > File Management

Continue to the plugins folder > QBeeQGlobe folder > select the config.js file

You can edit the file's code directly in the user interface.

var settings = {
    licenseSerial: "",
    noDataColor: "#7e7676",
    radius: 4,
    animationSpeed: 30000,
    tooltipFontColor: "#5B6372",
    //tooltipFontFamily: "Open Sans",
    tooltipFontSize: "13px",
    tooltipFontWeight: "400",
};

Setting	Description	Default
`noDataColor`	Sets the fill color for countries that have no matching data. This value is used as a fallback if the Countries without data color is configured in the design panel, that takes precedence over this setting.	`#7e7676`
`radius`	Base radius of point markers in pixels.	`4`
`animationSpeed`	Duration of one full 360° globe rotation in milliseconds	`30000` (30 sec)
`tooltipFontColor`	Sets the color of the labels in the tooltip	`#5B6372`
`tooltipFontSize`	Sets the font size of the label text in the tooltip	`13px`
`tooltipFontWeight`	Sets the font weight of the text in the tooltip	`400`

Using the 3D Spinning Globe

Globe Controls

The globe has built-in controls that appear on the chart itself:

Play / Pause

ℹ️

Rotation speed is controlled by the animationSpeed setting in config.js

Click the play button (bottom-left of the zoom control) to start the automatic 360° rotation. Click again (pause icon) to stop. One full rotation takes approximately 30 seconds.

Zoom in/out

Use the + and − buttons on the zoom control to zoom in or out

Panning

Click and drag anywhere on the globe to rotate it manually in any direction

Filtering from the Globe

Clicking a point marker on a country applies a dashboard filter for that country. The filter is set on the Category dimension and updates all connected widgets on the dashboard. To clear the filter, use the Sisense filter panel or click the country again.

Tooltips

⚠️

The tooltip is not shown for countries without a matching data point

Viewers can hover over each point market to view a tooltip containing:

Country name

Point Value

Any additional data defined in the values panel

Troubleshooting

Country not appearing on the globe

The globe matches country names against ISO 3166 codes using the built-in amCharts world geodata. If a country in your data uses an abbreviation or alternate name (e.g., "US" instead of "United States"), it won't be recognized and will be skipped.

Use the full English country name in your dimension to ensure correct matching.