3DDB Viewer Version 0.2 Manual


This document describes how to use a Web-based user interface (hereinafter referred to as “3DDB Viewer”) for displaying model data registered in the 3DDB database operated and managed by the Geographical Information Science Research Team, Artificial Intelligence Research Center, Information and Human Engineering Field, National Institute of Advanced Industrial Science and Technology (AIST).

Operating Environment

We have confirmed that 3DDB Viewer works in the following environments.

Hardware/OS/Web Browser

DOS/V (CPU: Intel(R) Core(TM) i7-7700K MEM: 32GB GPU: GeForce GTX1080)
Windows 10 Pro version 1809
Chrome version 87.0.4280.88, Firefox version 84.0 (64bit),
Microsfot Edge version 83.0.478.64 (official build)(64bit)
Alienware (CPU: Intel(R) Core(TM) i9-8950HK MEM: 32GB GPU: GeForce GTX1080 with Max-Q)
Windows 10 Enterprise version 2004
Chrome version 87.0.4280.88, Firefox version 83.0 (64bit)
MacBook Pro 15inch Mid 2015 (CPU: Intel(R) Core(TM) i7 MEM: 16GB)
macOS Catalina version 10.15.7
Chrome version 87.0.4280.88, Firefox version 84.0 (64bit)
MacBook Pro 13inch 2016 (CPU: Intel(R) Core(TM) i5 MEM: 16GB)
macOS Mojave version 10.14.6
Chrome version 87.0.4280.88, Firefox version 84.0 (64bit)


  • It should work in the same level of environment as above, but it is not guaranteed to work in all environments.

    Basically, the operation by the environment other than the operation check is not guaranteed at all.

  • During the development process, we have confirmed that there was a bug that caused the application to crash due to a WebGL-related error when using Chrome for Mac.

    The cause of the problem is unknown at this time, as Chrome has been updated to work properly without reproducing the problem.

    Since this problem only occurs on Chrome for Mac and works fine on Chrome for Windows, and since Firefox works fine on both Windows and Mac, it is possible that this is a problem with Chrome for Mac.

    If you encounter similar problems, please consider using Firefox.


We have confirmed that it does not work in the following environments.

  • Web browsers: Internet Explorer, Microsoft Edge (not the Chromium baseed), and Safari

  • Environments: Android OS, iOS, and iPadOS

How to Use

The following sections describe how to use the 3DDB Viewer.

Basic Operation

The basic operations of 3DDB Viewer are described in the following sections.


Figure 1. 3DDB Viewer (Click to enlarge)

Figure 1. shows the screen after starting the 3DDB Viewer. The 3DDB Viewer consists of the numbered areas (1) to (5) as shown in Figure 1. Each area has the following functions

(1) Model Data Search and Display Control Panel

It has functions for searching model data and displaying and downloading model data. For specific instructions on how to use this function, please refer to “Searching, Viewing and Downloading Model Data” below.

(2) Base Layer

This panel is responsible for displaying model data. The model data selected in “(1) Model data search and display control panel” is displayed here.

The operations on the base layer are as follows.


Base Layer Behavior

Drag left mouse button + move mouse

Move (Figure. 2. red arrow)

Shift + drag left mouse button + move mouse

translation (Figure. 2. light blue arrow)

Rotate mouse wheel

Zoom in/out

Drag the mouse wheel + move the mouse
Ctrl + drag left mouse button + move mouse

Rotate (Figure. 2. green arrow)


Figure 2. Base layer manipulation (Click to enlarge)

(3) Toolbox

It serves as a simple help for changing the base layer and model display mode (scene mode). For specific instructions on how to use it, see “Toolbox” below.

(4) Time bar

It is responsible for changing the time in the 3DDB Viewer.

In a structural model that is affected by ambient light, the shading of the building and other features change as the time of day changes.

You can change the time by clicking anywhere on the bar, or by dragging the knob on the bar.

The time when the 3DDB Viewer is started is noon in the time zone of the started environment.


The time bar displays the time in Coordinated Universal Time (UTC), so noon may not be noon depending on the time zone of the environment in which you run the 3DDB Viewer.

For example, if the time zone of the environment you are running in is Japan Standard Time (JST), noon (12:00) in JST will be 3:00 in the time bar, since from UTC a time difference of +9 hours.

The center of the time bar is set to be the noon of the environment in which it is launched, so if you are confused, please recognize that the center of the time bar is noon.

(5) Credit

This is a credit for 3DDB Viewer. It does not have any other functions.

Model data search, display and download

The following section describes how to search, display and download model data in 3DDB Viewer.

Model data display and download

When you execute a search with “Model Data Search”, the following dialog box with search results is displayed.


Figure 7. Search results available

If the result does not exist, a message is displayed stating that the result does not exist.


Figure 8. No results

The following is an explanation of how the search results are displayed.


Figure 9. Search Results Icon (Click to enlarge)

    1. Page switching in search results

    Switch between pages of search results.

    The number of data per page is 20, and the search results / 20 page numbers are displayed here. You can switch between the search results by clicking on the displayed page number.

    1. Model data display ON/OFF

    Switches the display of model data ON and OFF.

    The state after the search (Figure 9) is the state of the display OFF.


    Figure 10. Example display of model data (Click to enlarge)

  1. Detailed model data information

Displays detailed information of model data.

When you click this button, the following dialog box will be opened and detailed information will be displayed.


Figure 11. Detailed information

    1. Moving to the location of the model data

    Clicking on it will take you to the location of the model data.

    1. Download Model Data


    If the data is registered as non-downloadable when the model data is registered, the icon in question will be hidden.

    When you click this icon, the following dialog box will open and you can download the model data.


    Figure 12. Download


    When you download model data, you agree to abide by the license terms associated with that model data.


Control of display state

In order to display the model data, the following features are available that affect the overall display, not the individual model data.


Figure 13. Display control (general)

    1. Foot print

    Toggles the display of the wireframe area (foot print) drawn at the location where the model exists.

    Initially, it is OFF.


    Figure 14. Foot print OFF

    When this is turned on, foot print is drawn at the point where the model exists, as shown in Figure 15.


    Figure 15. Foot print ON

    When the model is displayed, the foot print of the model is automatically turned off.

    1. Point Size

    Changes the size of points in point cloud data. There is no effect on anything other than point cloud data.

Share the display state

The 3DDB Viewer provides a function to generate a URL that allows you to recreate the display state of the model data. By sharing this URL, you can share the view of the model data.


  • This function works only the 3D view of scene mode.

  • If you use a URL generated in version 0.2 or earlier, you cannot restore the display state of model data.

This URL can be generated by clicking on the Share button in the Model Search and Display Control Panel.


Figure 16. Share button

When you click the Share button, the following dialog will be displayed.


Figure 17. Share dialog

Clicking the “Copy to clipboard” button will copy the URL to the clipboard area. Use a text editor or other application to save the contents of the clipboard.


The toolbox is described below.


Figure 18. Toolbox

From left to right: Scene mode change, base layer switching, and simple help on how to operate.

Each of these features is described below.

Scene mode change

After clicking on the icon, the icon will expand as shown in Figure 19, and you can select the desired mode.


Figure 19. Scene mode change

The icons for each mode are, from the top, 3D view, 2D view and 2.5D view (Columnbus View).

The order of display changes depending on the selected mode, so try to remember the icon and mode, not the order of display.

Base layer switching

Click the icon to expand the dialog shown in Figure 20. Select the desired base layer image and Digital Elevation Model (DEM).


Figure 20. Base layer switching

You can select one image from Imagery for base layer and one from Terrain for DEM.

When launching the 3DDB Viewer, “Basemap of GSI of Japan” for Imagery and “WGS84 Elipsoid” for Terrain are specified.

Simple help on how to use

When you click the icon, the dialog shown in Figure 21 will be expanded to display a simple explanatory diagram of the operation on the base layer.


Figure 21. Simple help

When you click on a different location after viewing, the dialog is automatically hidden.


Dialog common operations

The common operations of the dialog are described below.


Figure 22. Dialog common operations

  • (1). Moving bar

    You can move the position of the dialog.

    By dragging the bar, you can move it to the desired location.

  • (2). Collapse button

    Click to collapse the dialog.

    Click again to un-collapse the dialog.

  • (3). Label

    Labeling to identify the dialog.

    It cannot be manipulated.

  • (4). Close button

    Click to close the dialog.

    Some dialogs do not have a close button.

Show help

You can refer to this manual by clicking on the Help button.


Figure 23. Help button