GeoBI Visualization Dashboard#

Version: 0.01 Copyright: Shenzhen Intergeo Innovation Technology Co., Ltd. Last Updated: 2026.03.10

Copyright and Disclaimer#

1. All ownership and related intellectual property rights of this software belong solely to Shenzhen Intergeo Innovation Technology Co., Ltd.
2. Users shall obtain the right to use the software through lawful means and use it in accordance with the relevant agreements.
3. During the use of this software, any infringement or illegal acts caused by reasons not attributable to Shenzhen Intergeo Innovation Technology Co., Ltd. shall be borne entirely by the user. Shenzhen Intergeo Innovation Technology Co., Ltd. shall not bear any joint liability.
4. Without the written consent or authorization of Shenzhen Intergeo Innovation Technology Co., Ltd., no entity may adapt, translate, annotate, compile, sublicense, re-authorize, or otherwise modify or derive from this software in any form.
5. The content of this manual is subject to update or change without prior notice. Shenzhen Intergeo Innovation Technology Co., Ltd. assumes no related obligation in this regard.

Trademark Notice#

"GeoTwin" and "Shenzhen Intergeo Innovation Technology Co., Ltd." are registered trademarks of Shenzhen Intergeo Innovation Technology Co., Ltd. and are protected by law. Without the written consent or authorization of Shenzhen Intergeo Innovation Technology Co., Ltd., no infringement of registered trademark rights is permitted in any form. Violators will be prosecuted.

Table of Contents#

1. New Features and Improvements
2. Usage Notes
3. Software Overview
4. Configuration and Data Formats
5. Software Guide
6. Glossary
7. Technical Support

1. New Features and Improvements#

1.1 Version Update Summary#

New Features:

• Official release of the first version of the GeoTwin Data Visualization Platform, debuting as an enterprise-grade data visualization dashboard builder
• Support for multiple chart components: bar charts, line charts, pie charts, radar charts, scatter charts, funnel charts, pictographic charts, treemap charts, and more
• Support for 3D model display and interaction: 3D model loading, position anchoring, and animation effects
• Support for map components: integrated map visualization with annotation and layer management
• Support for video components: video playback and live streaming (HLS, FLV, ZLMediaKit)
• Support for IoT components: real-time device data display, video popups, data popups, and model positioning
• Support for data source management: multiple data source types including API, App, and IoT data sources
• Support for dataset configuration: flexible data querying, filtering, and formatting settings
• Support for interaction events: inter-component interactions, data linkage, page navigation, and popup display
• Support for AI-assisted generation: automatically generate dashboard configurations from natural language descriptions
• Support for dashboard sharing: share dashboards directly via link
• Support for dashboard export/import: export configuration files in JSON format for backup and cross-environment migration
• Rich animation effects: support for various entry and exit animations with looping capability
• Flexible theme configuration: support for custom theme colors and style variables

Other Changes:

• Initial release — all features listed above are newly added

1.2 Version History#

2. Usage Notes#

2.1 System Requirements#

2.1.1 Operating System#

• Recommended: Windows 10/11 (64-bit) or Windows Server 2012 and above
• macOS and Linux are supported (some features may require additional configuration)
• A modern browser (Chrome, Edge, Firefox, etc.) is required for the best experience

2.1.2 Minimum Hardware Requirements#

• Processor: Intel Core i5 or equivalent performance or higher
• Memory: 8 GB RAM or more recommended
• Storage: At least 10 GB of available space recommended for storing dashboard configuration files and assets
• GPU: A dedicated or integrated graphics card with WebGL support (required for 3D model display)

2.1.3 Storage and Network Requirements#

• Storage: SSD recommended for faster loading speeds
• Network: A stable internet connection is required (for loading external resources, API data requests, IoT device connections, etc.)
• Dashboard preview and sharing features require an accessible network environment

2.1.4 Recommended Hardware Configuration#

2.2 Software Installation#

1. Visit the GeoTwin Data Visualization Platform official website to download the installer;
2. Double-click the installer and follow the setup wizard to complete installation (the default path is recommended, or choose a custom path that does not contain non-ASCII characters);
3. After installation, a shortcut will be created on the desktop — double-click it to launch the software;
4. After the first launch, access the platform's main interface by visiting the local service address in your browser.

2.3 Account and Authorization#

1. After launching the software, log in using your assigned account credentials;
2. Once logged in, you can view account permissions and authorization information in the personal center;
3. Contact your system administrator if you need additional feature permissions.

3. Software Overview#

3.1 Core Positioning#

GeoTwin Data Visualization Platform is an enterprise-oriented data visualization dashboard builder. Through a visual drag-and-drop editing interface, users can quickly build professional data display dashboards with minimal or no coding required. The platform supports multiple chart types, map displays, 3D models, video playback, IoT device data integration, and more — making it widely applicable to smart campuses, smart construction sites, smart cities, smart water management, comprehensive data displays, and other scenarios.

3.2 Module Structure#

The software consists of the following core modules:

Dashboard Management Module: Manages the full lifecycle of dashboards, including creation, editing, saving, deletion, duplication, sharing, and import/export.

Component Library Module: Provides a rich set of built-in components and empowers users to create custom components, helping them build visualization elements that better fit their business needs.

Data Source Management Module: Supports the configuration of multiple data source types, including API, App, and IoT data sources, with dataset querying, filtering, and formatting capabilities.

Deployment and Publishing Module: Supports dashboard preview, share link generation, and export/deployment features.

3.3 Core Advantages#

• Easy to Use: Visual drag-and-drop editing with a WYSIWYG interface — no programming experience required to get started quickly
• Rich Components: A wide variety of built-in chart types, with support for complex components such as maps, 3D models, and video, meeting diverse display needs
• Flexible Data Handling: Supports multiple data source types, powerful data processing capabilities, and real-time data updates
• Powerful Interactions: Supports complex component interaction configurations to achieve data linkage and dynamic interactive effects
• Multi-scenario Adaptability: Suitable for smart cities, smart campuses, industrial monitoring, command and dispatch centers, and many other application scenarios

4. Configuration and Data Formats#

4.1 Dashboard Configuration File Format#

4.2 Data Source Configuration Formats#

Data loading supports connecting data to components through various data sources for display. This flexibility provides support for multiple data formats and enables dynamic data updates with real-time display. Data refresh intervals only take effect in preview mode, significantly reducing the workload of manually writing extensive code to fetch data.

The platform currently supports the following 13 data source types:

Important Notes:

• All data source types listed above support arbitrary data formats. However, for data to display correctly within a component, it must be converted to the format required by that component. The Data Filter can be used to perform this conversion.
• Component Interactions can also be configured to receive parameters passed from other components, enabling data linkage effects.
• Data refresh policies support configuring automatic refresh intervals for real-time data updates.

4.3 Dataset Configuration#

A dataset (Record) is a reusable data query configuration. Users can create datasets in the data source management section and share them across multiple components. Datasets enable centralized data management, avoiding the need to repeatedly configure the same interface parameters in each component.

4.4 Component Data Formats#

The following are sample data format examples for chart components:

Format 1 (Category-Series Format):

{
  "categories": ["Apple", "Samsung", "Xiaomi", "OPPO", "vivo"],
  "series": [
    {
      "name": "Phone Brand",
      "data": [1000879, 3400879, 2300879, 5400879, 3400879]
    }
  ]
}

Format 2 (Name-Value Pair Format):

[
  { "name": "Apple", "value": 1000879 },
  { "name": "Samsung", "value": 3400879 },
  { "name": "Xiaomi", "value": 2300879 }
]

5. Software Guide#

5.1 Core Module Operations#

5.1.1 Dashboard Management#

How It Works: Use the dashboard management interface to create new dashboards or edit existing ones. Dashboard configurations are stored in JSON format, with support for export backup and import restoration.

Core Features:

• Create Dashboard: Supports creating from a blank template or selecting a preset template
• Edit Dashboard: Add components via drag-and-drop, adjust layout, and configure styles
• Preview Dashboard: Real-time preview of the dashboard's display effect
• Share Dashboard: Generate a share link that others can use to preview directly
• Export/Import: Export JSON configuration files; supports cross-environment migration

Steps:

1. Click "Create Dashboard," enter the dashboard name, and select a size template (e.g., 1920×1080);

2. Enter the dashboard editing interface and drag components from the left component panel onto the canvas;

3. Select a component and configure its data source, style, interaction, and other properties in the right configuration panel;

4. Click the "Preview" button to view the display effect;

5. Click "Share" to obtain a share link, or click "Export" to save the configuration file.

5.1.2 Component Library#

Chart Components: Includes bar charts, line charts, pie charts, radar charts, scatter charts, funnel charts, pictographic charts, treemap charts, and more. Supports custom colors, styles, and data formats.

gtApp Components: Integrates output from gtAppBuilder, providing map visualization capabilities with support for various geographic information displays and interactions.

3D Components: Supports loading and displaying 3D models, with configurable position, rotation angles, and animation effects.

Video Components: Supports multiple video formats and live streaming protocols, including HLS, FLV, and ZLMediaKit.

IoT Components: Supports IoT device data display, including real-time data panels, video popups, data popups, and model positioning.

Table Components: Supports data table display, sorting, and filtering.

Form Components: Provides form controls including buttons, input fields, and dropdowns.

5.1.3 Data Source Management#

How It Works: Configure data sources in the "Data" panel to provide data support for components. Multiple data source types are supported, with flexible configuration of data retrieval methods and processing logic.

Core Features:

• Add Data Source: Supports API, App, and IoT data sources
• Dataset Configuration: Configure query conditions, refresh policies, and data formatting rules
• Data Filtering: Configure filtering rules to display only data that meets specified conditions

Steps:

1. In the dashboard editing interface, click the "Data" panel;

2. Click "Add Data Source" and select the data source type;

3. Configure the data source parameters (URL, request method, request parameters, etc.);

4. Configure data formatting functions to process the returned data;

5. Bind the configured data source to the component.

5.1.4 Interaction Event Configuration#

How It Works: Configure interaction events to achieve data linkage and dynamic interactive effects between components.

Core Features:

• Click Events: Trigger interaction actions when a component is clicked
• Data Linkage: Automatically update associated components when one component's data changes
• Page Navigation: Navigate to a specified dashboard or external link upon click
• Popup Display: Open a detailed information popup upon click
• Component Control: Control the show/hide state and position of other components

Steps:

1. Select the component for which you want to configure interactions;

2. Click the "Interaction" tab in the right configuration panel;

3. Click "Add Interaction" and select the trigger event type;

4. Configure the trigger conditions and action to execute;

5. Save the configuration and test the interaction effect.

5.2 Key Workflow Operations#

5.2.1 Dashboard Creation Workflow#

Log in to the system, navigate to the dashboard list page, and click the "Create Dashboard" button.

1. Enter the dashboard name and select the dashboard size (e.g., 1920×1080 standard, 4K, or custom size);
2. Choose to create from a blank template or use a preset template;
3. Click "Create" to enter the dashboard editing interface.

5.2.2 Adding Components Workflow#

In the dashboard editing interface, the component library panel is displayed on the left.

1. Browse or search for the desired component type;
2. Drag the component to the canvas area, or double-click the component to add it directly;
3. Select the component on the canvas — the component properties panel will appear on the right;
4. Configure the component's basic information, data source, style, and interaction properties.

5.2.3 Data Source Configuration Workflow#

In the dashboard editing interface, click the "Data" panel.

1. Click "Add Data Source";
2. Select the data source type (API / App / IoT);
3. Configure the data source parameters based on the selected type:
   • API Data Source: Enter the request URL, select the request method, and configure request parameters and headers
   • App Data Source: Select the target application and layer
   • IoT Data Source: Configure the IoT device connection information
4. Configure data formatting functions to process the returned data format;
5. Configure the data refresh policy (manual refresh, automatic refresh, and refresh interval);
6. Save the data source configuration.

5.2.4 Binding Data to Components Workflow#

1. Select the component to which you want to bind data;

2. In the right component configuration panel, click the "Data" tab;

3. Select a configured data source or create a new one;

4. Configure data mapping to map data source fields to the component's display fields;

5. Configure data formatting functions to customize the data display;

6. Save the configuration — the component will now display data correctly.

5.2.5 Interaction Event Configuration Workflow#

1. Select the component for which you want to configure interactions;

2. In the right component configuration panel, click the "Interaction" tab;

3. Click "Add Interaction";

4. Select the trigger event type (click, mouse hover, data change, etc.);

5. Configure trigger conditions (optional);

6. Select the action type to execute:

   • Switch Dashboard: Navigate to another dashboard
   • Open Link: Open an external link in a new window
   • Show Popup: Display a specified popup component
   • Refresh Data: Refresh the data of a specified component
   • Show/Hide: Control the visibility state of a component
   • Move Position: Move the position of a component

7. Save the interaction configuration and verify the interaction effect.

5.2.6 Preview and Publishing Workflow#

After completing dashboard editing, click the "Preview" button in the toolbar.

1. Click "Preview" to immediately view the dashboard's actual display effect;

2. If adjustments are needed, click the "Reset" button to return to the editing state;

3. Click "Share" to generate a share link — copy the link and share it with others for preview;

4. Click "Export" to download the JSON configuration file for backup or migration.

5.3 Troubleshooting Common Issues#

Issue 1: Dashboard Component Displaying Abnormally

Check whether the component's data source configuration is correct and confirm that the returned data format meets the component's requirements. Also check the browser console for any error messages.

Issue 2: Data Fails to Load

Check whether the data source URL is correct; confirm that the network connection is functioning normally; confirm that the API interface supports cross-origin requests; check whether the request parameters and request headers are configured correctly.

Issue 3: 3D Model Fails to Display

Confirm that the browser supports WebGL; check whether the model file URL is correct; confirm that the model format is supported by the platform (GLTF / GLB, etc.).

Issue 4: Video Fails to Play

Check whether the video URL is correct; confirm that the video format is supported (HLS requires an m3u8 address); check whether the current network environment supports the HLS protocol.

Issue 5: Interaction Events Not Taking Effect

Check whether the interaction configuration has been saved correctly; confirm that the trigger conditions and action configurations are correct; check whether the target component exists in the current dashboard.

Issue 6: IoT Device Data Not Updating

Check whether the MQTT connection configuration is correct; confirm that the device is online; check whether the data formatting function can correctly process the data returned by the device.

6. Glossary#

7. Technical Support#

• Official Website: To be updated
• Manual Download: To be updated
• Contact Email: To be updated
• Technical Support: For technical issues, please contact us through the channels listed above

Note: This manual is the initial version of the GeoTwin Data Visualization Platform user manual. Detailed feature descriptions, parameter configurations, and other content will be continuously updated and improved as the product evolves. For any questions, please feel free to contact the technical support team.