The web GUI
Scope
This page provides information required to operate the MapCore™ Map Layer Server via GUI in browser. The chapter describes the GUI controls and functions and provides detailed instructions on how to operate the server using GUI.
This page is intended for operators who are authorized to manage the MapCore™ Map Layer Server.
Start the GUI Client
-
If not already running, start the MapCore™ Map Layer Server. Refer to Server Start for detailed instructions.
-
Using any of the supported browsers (see Minimum System Requirements), navigate to the following URL:
http://<server>:<port>
Where:
-
<server>is either:-
localhost, when the GUI client and the MapCore™ Map Layer Server are running on the same machine,
-
Server’s DNS name or IP address when the GUI client and the MapCore™ Map Layer Server are running different machines.
-
-
<port>is the port on which the server is running. Refer to Server Execution Parameters for details.
For example:
http://localhost:6767
This section is divided into two high-level aspects of the GUI:
-
User Interface Structure, which describes the structure and use of each area of the MapCore™ Map Layer Server graphic interface.
-
User Interface Controls, which describes the purpose and manner of use of controls found in the different interface areas.
Refer to Server actions in the web GUI, Groups and the layer backlog and Layers in the web GUI for detailed instructions on how to perform different tasks using the MapCore™ Map Layer Server graphic interface.
User Interface Structure
The GUI window consists of the following components as detailed in Figure 4-1 User interface structure below. Each of these sections further described below. Controls available for each component on the screen are detailed and explained in User Interface Controls while instructions for achieving any goal using the graphical interface are detailed in Server actions in the web GUI, Groups and the layer backlog and Layers in the web GUI.

Figure 4-1 User interface structure
Where:
-
Content repository search box.
-
Preview controls, when applicable.
-
Action display.
-
Content repository.
-
Log display.
Content repository search box
This field is used to search for layers within both the Map Layer Repository and the Layer Backlog group. Typing in the field results in a filtered list in the Content Repository area, displaying only groups and layers matching the string present in the search box. Refer to the Content Repository for more details on the group and layer display as well as the Layers Backlog.

Figure 4-2 Layers and their groups displayed as per searched string
Preview Perspective
Preview controls are only displayed when the Preview area is active.
Figure 4-3 Preview controls
The preview controls are used to toggle between different preview perspective modes: map, 3D, and DTM.
Where:
-
Map displays a 2D perspective of the previewed map.
-
3D displays a 3D perspective of the previewed map.
-
DTM displays DTM information terrain altitudes in colors (from blue for the lowest values through green, yellow, and orange to brown for the highest values). Available for both 2D and 3D previews but only when the group contains 3D information.
Content Repository
The Content Repository is a tree-like formation of all groups and layers present on the server. It is divided into two separate parts: the Layers Backlog and the Map Layer Repository, both of which are always present in the Content Repository display. The layer backlog contains only layers and no groups. In the Map Layer Repository, layers must be associated with a group. The hierarchical formation holds the following elements, which are further detailed below:

Figure 4-4 Hierarchical view of the Content Repository area
Where:
-
The number next to each group’s name represent the number of layers associated with that group
-
The More Options (three dots) menu at the end of each row
allows access specific actions relevant for that type of entity.
Layer Backlog
The first group displayed in the Map Layer Repository is always the Layer Backlog group. This group contains layers that will not be visible to client applications but exist in the server's repository and can be managed by an operator. The Layer Backlog group can contain layers of any type. Deleting a layer from this group permanently removes the layer from the server.
Refer to the Layer Backlog for a detailed explanation of the layer backlog.
Refer to Layer Backlog Controls for further details on controls available for this group.
Refer to Layer Backlog Actions for detailed instruction how to perform operations related to this group.
Map Layer Repository Bar
This is the top hierarchy in the tree-like formation of the Content Repository area. It allows access to server-related operations.
Refer to Server Controls for further details on controls available in this section of the GUI display.
Refer to Server-related Actions for detailed instruction how to perform server-related operations.
User-created layer groups
A group is a container of layers managed by the server and reflected in client applications. Groups are used to organize layers and preview grouped layers, so layers should be grouped based on shared characteristics such as geographic location. For grouped layers to be previewed properly together, all layers in the group must share a common area of interest, their target coordinate system, and their tiling scheme.
Refer to Group for a detailed explanation of groups.
Refer to Coordinate System for detailed information on the layer’s coordinate system.
Refer to Tiling Scheme for detailed information on the tiling scheme and its relationship to the layer’s coordinate system.
Refer to Group Controls and Group and Layer Preview Controls for further details on controls available to groups and their preview option.
Refer to Group-related Actions for detailed instruction on how to perform operations related to groups.
Layers
Layers are the building blocks of all maps and must be associated with a layer group. As such, layers can only be added via the user-created group actions. When a group is removed, layers of that group are moved to the Layer Backlog group.
Refer to the Basic Concepts for a detailed explanation of layers and their different types.
Refer to Layer Controls and Group and Layer Preview Controls for further details on controls available to groups and their preview option.
Refer to Layer-related Actions for detailed instruction on how to perform operations related to individual layers.
Action Display
The Action Display area displays two different functions, as detailed below:
-
Running processes
-
Map preview
Running processes
Used to display process status and counters when processes are run.

Figure 4-5 Running processes display
The layer progress bars show the upload progression of the specified layer. Each status of the progress bar triggers a different counter in matching color as detailed in the following table:
Table 4-1 Layer upload progress bar and counters
| Color | Progress bar | Counter | Description |
|---|---|---|---|
| Yellow | Upload in progress | In Progress | Shows the number of layers that are currently being added to the server. |
| Green | Upload successfully completed | Completed | Shows the number of successfully added layers out of the total number of upload attempts since the last counter reset. |
| Red | Upload failed | Failed | Shows the number of layers that had failed to upload since the last counter reset. |
| Post process | Raw layer post-processing in progress | Post process | Shows the number of post-upload processes in progress, such as raw to native layer conversion in progress. |
All past uploads are displayed in the Action Display area and the counters until counter reset. Refer to Reset Upload Counters for detailed instructions on resetting the counters. Process-related activities are documented in the MapCore™ Map Layer Server’s log file, which is displayed on the graphic user interface for convenience. Refer Section to for detailed information.
Map preview
Used to display single layers or the combined image of the grouped layers being previewed. Refer to Preview Layer on preview actions.

Figure 4-6 Map preview
Log Display
Highlights of activities that are performed through the Action Display are recorded in the Log Display area, capturing the following information:
-
Layer-related actions successfully completed, such as successful upload or successful deletion.
-
Warning messages reflecting partial process failure (such as partial import of multiple layers).
-
Error messages reflecting essential process failure such as missing critical data.

Figure 4-7 When activity is complete, log is displayed
The GUI log may be exported into a text file via the Log Display. The exported file will capture all log messages currently displayed in the Log Display. Log files exported through the GUI are found in your browser’s download folder and are saved with the file name: logs_<timestamp>.txt where timestamp is presented in this format: YYYY_MM_DD_HH_MM_SS (such as: logs_2023_11_21_09_34_28.txt).
The GUI log file is a concise version of the full server log file and does not affect the server session log file. Refer to Server Log File for details on the server log file.
Refer to Log Display Actions for detailed instructions regarding all actions available for the Log Display.
User Interface Controls
Below are described controls and menu options available in the different contexts of the MapCore™ Map Layer Server:
-
Server Controls
-
Layer Backlog Controls
-
Group Controls
-
Layer Controls
-
Group and Layer Preview Controls
-
Layer and Server Parameter Controls
-
Log Display Controls
Server Controls
The More options menu on the Map Layer Repository allows access to the server as detailed in the table below.

Figure 4-8 Map Layer Repository More options menu
Where:
Table 4-2 Map Layer Repository More options menu elements
| Element | Allows you to…. |
|---|---|
| Add Group | Add a new group to Layer Map Repository. Refer to Add New Group for detailed instructions. |
| Import MC Package | Allows to import a group of layers or any type of individual layer that had been previously exported from MapCore™. Refer to Import MC Package for detailed instructions. |
| Export Repository | Export entire contents of the Map Layer Repository as an MC Package. Refer to Export Group and Export Layer for instructions on exporting only some groups and layers. Refer to Export Repository for detailed instructions. |
| Server Configuration | Display and edit key server configuration data. Refer to Change Server Configuration for detailed instructions. |
| Preview Configuration | Configure preview options. for current browser on current device. Refer to Configure Preview Options for detailed instructions. |
| About | Display software versions of both: MapCore Map Layer Server MapCore viewer Refer to View MapCore™ Server Version Number for detailed instructions. |
Layer Backlog Controls
The only option available from the Layer Backlog More options menu is to clear the backlog as detailed in the table below.
Figure 4-9 More options menu for Layer Backlog
The Layers Backlog group contains only layers and no groups. The More options menu for layers within the Layers Backloggroupallows access to management and preview options as detailed in the table below. Options in this menu vary depending on whether the operation applies to a single layer or a selection of multiple layers.
It is impossible to export layers that have been moved to the Layer Backlog. To export such layers, it would first be necessary to associate them with a group, after which they may be exported via the Group or Layer bars.
Refer to Move to Groups for instructions on associating backlog layers with groups.
Refer to Export Group andExport Layer for instructions on exporting layers.
Figure 4-10 More options menu for layers in the Layer Backlog group
Where:
Table 4-3 Layer Backlog and backlog layer More options menu options
| Element | Allows you to…. | |
|---|---|---|
| Clear Backlog | Remove all unused layers from the server. WARNING This action deletes all backlog layers from the server and cannot be undone. Refer to Delete All Layers for detailed instructions. | |
| Move to Groups | Attach layers to one or more groups. Refer to Move to Groupsfor detailed instructions. | |
| Delete Layers | Remove layers from the server. WARNING This action deletes the specified layer from the server and cannot be undone. Refer to Delete Layers for detailed instructions. |
Refer to Layer Backlog Actions for detailed instructions regarding all actions available for the Layers Backlog.
Group Controls
The group More options menu allows access to group management and preview options as detailed in the table below. Options in this menu vary depending on whether the group is empty or already has associated layers.
| --- | --- | --- | --- |
| |
|
|
|
| (a) More options menu of an empty group | (b) More options menu of a populated group | (c) More options menu of populated group in multi-group selection | (d) More options menu of non-populated group in multi-group selection |
Figure 4-11 More options menu for group
Groups can only be added through the Map Layer Repository bar. Refer to Add New Group for detailed instructions.
Table 4-4 Group More options menu options
| Menu option | Allows you to…. |
|---|---|
| Preview | Preview all the layers in the group together. Refer to Preview Group Content for detailed instructions. |
| Add Layer | Add a new layer to the group. Refer to Add New Layerfor detailed instructions. |
| Export Group | Export the group layers. Refer to Export Group for detailed instructions. |
| Rename Group | Change the group’s name. Refer to Rename Group for detailed instructions. |
| Remove Group | Remove group(s) from the Map Layer Repository. All group layers, including those that are associated with other groups, will be moved to the Layer Backlog group and will not be available to the client applications. Refer to Remove Group for detailed instructions. |
Refer to Group-related Actions for detailed instructions on all actions available for user-created groups.
Layer Controls
The layer More options menu allows access to layer management and preview options as detailed in the table below. Options in this menu vary depending on whether the operation applies to a single layer or a selection of multiple layers. The layer controls for the Layer Backlog group are described in Layer Backlog Controls.
| --- | --- | --- |
| |
|
|
| (a) More options menu of a single layer (options may vary based on layer type) | (b) More options menu of layer in a selection of multiple layers | (c) More options menu of layer in a mixed selection of groups and layers |
Figure 4-12 More options menu for layer
Layers can only be added through the group bar to which they appended. Refer to Add New Layer.
Table 4-5 Layer More options menu options
| Menu option | Allows you to…. | |
|---|---|---|
| Build search indexes | Relevant for vector layer types only (i.e., raw vector, raw S-57), Refer to Build Search Indexesfor detailed instructions. | |
| Preview | Preview selected layer(s). Refer to Preview Layer for detailed instructions. To preview all layers of a selected group(s), refer to Preview Group Content for detailed instructions. | |
| Edit Layer | Edit editing-enabled layer information. Refer to Edit Layer Parameters for detailed instructions. | |
| Export Layer | Export the layer into a package. Refer to Export Layer for detailed instructions. This action may be applied to a selection of multiple layers. Refer to Select Multiple Layers. | |
| Select Groups | Attach the layer to one or more groups, including the option to disattach from current group. Refer to Attach Layer to Different Group(s) for detailed instructions. | |
| Remove Layer | Move the layer to Layer Backlog. Refer to Remove Layer from user-created group for detailed instructions. This action may be applied to a selection of multiple layers. Refer to Select Multiple Layers. |
Group and Layer Preview Controls
A map preview may be manipulated at two different levels as detailed below:
-
Preview mode.
-
Preview content.
Preview mode
Four preview options are available for previewed maps as detailed below.
Figure 4-13 Preview controls
Where:
Table 4-6 Preview controls
| Menu option | Allows you to…. |
|---|---|
| Display 2D map. In this mode, the observer is always looking down at the terrain. | |
| Display 3D map. In this mode, the topographical details are displayed. | |
| Display DTM information overlay where present. | |
| Close preview. |
The Preview Perspective display will alter according to the chosen preview mode.

Figure 4-14 Preview Perspective display per perspective mode
Preview content
The observer’s perspective of the previewed content may be controlled using the mouse and keyboard as described in the following table.
Table 4-7 Image controls
| Mouse control | Action in 2D mode | Action in 3D mode |
|---|---|---|
| Wheel scroll | Turn wheel forward and backward to respectively zoom in and out. | Turn wheel forward and back to respectively move the observer forward and backward. |
| Shift + wheel scroll | Turn wheel forward and back to respectively zoom in and out in big strides. | Turn wheel forward and backwards to respectively move the observer forward and backward in big strides. |
| Ctrl + wheel scroll | As wheel scroll above. | Turn wheel forward and back to respectively decrease or increase the observer‘s altitude. |
| Wheel click and drag | Drag left and right to rotate the map around the clicking point. | Drag to rotate the observer around the clicking point. |
| Left button click and drag | Move the map. | Drag to change the observer’s orientation: right and left rotate yaw (around y axis); up and down rotate pitch (around z axis). |
| Ctrl + left button click and drag | Rotate the map around the center of the viewport (preview window) | Drag left or right to respectively move the observer in those directions; drag up or down to respectively move the observer forward and backward. |
Layer and Server Parameter Controls
The following table details different field types in the layer and server parameter forms and how they may be handled.
Table 4-8 Image controls
| Visual | Field type | How to enter data |
|---|---|---|
| Mandatory | Fields marked with a red asterisk (*) are required and cannot be left empty. | |
| Information | Click the ⓘ icon by the field name to display the field’s description. | |
| String (empty) | Click the empty field and type the new value. | |
| String (suggested value) | Use the auto-populated value as an example of the value expected in the field. To override the default value, select the text and type the new value. Unless deleted, the default value is used. | |
| Number | Type the number or use the up and down arrows to navigate to the desired number. | |
| Boolean | Use the dropdown arrow to open the list of valid values, which are either True or False. | |
| More… | Click the sideways arrow to open more options related to this parameter. | |
| Checkbox | Click the checkbox to toggle between checked (selected) and unchecked (unselected) states. | |
| List | Use the dropdown arrow to open the list of valid values. Some list fields have a descriptive title within the list: Figure 4-16 List field entries filtered by entered string Lists in which a multiple selection of values is permitted have a built-in option to clear all selected value by clicking on the x option: |
Log Display Controls
The Log Display More options menu allows access to log management options as detailed in the table below.
Figure 4-18 More options menu for Log Display
Table 4-9 Log Messages More options menu options
| Menu option | Allows you to…. |
|---|---|
| Clear Log Window | Clear log window display. This does not affect the server log file. Refer to Clear Log Window for detailed instructions. |
| Export Log | Export information in log window display. More robust information, however, is found in the log file. Refer to Export Log for detailed instructions. Refer to Log Displayfor information on the log file and its location. |
Refer to Log Display Actions for detailed instructions on all actions available for the Log Display.
This section provides detailed instructions for achieving all tasks that may be completed using the MapCore™ Map Layer Server graphic interface.
Refer to User Interface Controls for more information on control purpose and behavior.
Any action may be aborted without completion. Refer to Aborting GUI Actions for detailed instructions.
Display-related Actions
Reset Upload Counters
Upload counters are aggregated in each session of the MapCore™ Map Layer Server as is the display of past upload progress bars. To reset the counters and the display within the current MapCore™ Map Layer Server session, click the Clear option next to the counter. Refer to Action Display for a detailed explanation about the Running Process display and colors.
Figure 4-19 Resetting upload counters
Aborting GUI Actions
Process may be aborted without completion in of two ways:
- Clicking the Cancel button.
Figure 4-20 The Cancel button
- Clicking the
at the top right corner of the window.
Some process terminations may prompt a warning message to confirm process termination without completion (click the OK button to confirm).
Log Display Actions
The following actions are available for the Log Display:
-
Clear Log Window
-
Export Log
Clear Log Window
On the Log Display bar, click the More options menu icon , and then click the Clear Log Window option. All data will be deleted from the log display. This does not affect the server log file. Refer to Log Display for detailed information about the log file and its location.
Export Log
On the Log Display bar, click the More options menu icon , and then click the Export Log option. All current data in the log display will be exported into a new log file found under your browser’s downloads folder. This does not affect the server log file. Refer to Log Display for detailed information about the log file and its naming convention.
Figure 4-16 List field entries filtered by entered string Lists in which a multiple selection of values is permitted have a built-in option to clear all selected value by clicking on the x option: