Skip to content

Background Selector

The background selector, located in the bottom left corner of the Viewer, allows the user to add, manage and remove map backgrounds.

By clicking on the background selector, a list of available backgrounds will be displayed. The user can select one of them to switch to it. The default map backgrounds in MapStore are: OSM Simple Light, OSM Simple Dark, OSM Bright, NE Political, Sentinel 2 Cloudless, Open Street Map and Empty Background.

For example choosing NE Political, the map background will change like in the following image:

If the user has editing permissions on the map (independently on the role, see Resource Properties section for more information about permissions), it is also possible to add, edit or remove backgrounds.

Add background

A new background can be added through the button on the top of the background selector. Performing this operation the Catalog panel opens with the possibility to access the Remote Services:

Warning

Default Backgrounds service is available only accessing the Catalog from the background selector, but if you add a new Remote Service from there, it will be available also accessing Catalog from the Side Toolbar or from TOC. Default Backgrounds represent a list of backgrounds that can be configured from MapStore's configuration files (more information about that can be found in Developer Guide's Map Configuration section).

From the Catalog the user can choose the layers to add to the list of backgrounds:

As soon as a WMS layer is selected, the Add New Background window opens:

In particular, from this window, the user can perform the following operations:

  • Add a Thumbnail choosing the desired local file by clicking on image preview area, or simply with the drag and drop function

  • Set the Title

  • Set the Format (between png, png8, jpeg, vnd.jpeg-png or gif)

  • Choose the Style, between the ones available for that layer

  • Enable/disable the use of the layer cached tiles. If checked, the Tiled=true URL parameter will be added to the WMS request to use tiles cached with GeoWebCache. When the Use cache options is enabled, more controls are enabled so that it is possible for the user to check if the current map settings match any GWC standard Gridset defined on the server side for the given WMS layer (Check available tile grids information ). At the same time, it is also possible to change the setting strategy (based on the WMTS service response) to strictly adapt layer settings on the client side to the ones matching any remote custom Gridset defined for the current map settings (Use remote custom tile grids button). (More details on Layer Settings section.)

  • Add Additional Parameters of three different types: String, Number or Boolean (these parameters will be added to the WMS request).

Warning

The thumbnail image size should be a square of 98x98px or 128x128px, max 500kb and the supported format are jpg (or jpeg) and png

Once the options are chosen, with the button the new background layer is definitively added to the background selector as a card and automatically set as the current one.

Add WMTS background

In case of a WMTS layer added as a background layer, the Add New Background window is a bit different:

The user can perform the following operations:

  • Add a Thumbnail choosing the desired local file by clicking on image preview area, or simply with the drag and drop function

  • Set the Title

  • Set the Attribution visible at the bottom left of the footer in the map viewer.

Edit background

Backgrounds can be edited using the button located to the right of each background in the list.

The Edit Current Background window opens, allowing the user to customize the same set of information when adding a new background (see previous section).

Remove background

Backgrounds can be removed using the button located to the right of each background in the list.

Note

By default, for new maps, all backgrounds from Default Backgrounds Service are added to the background selector, and in Catalog they appear grayed (it's not allowed to add the same default background twice): as soon as you remove one from the background selector, it becomes selectable from the Catalog.

Background Selector on the 3D navigation

On MapStore, when 3D Navigation is enabled, the user can customize the background of the map viewer.

If the user has editing permissions on the map, they can also add, edit, or remove terrain layers to be used as a background for that map.

Note

By default, the only terrain available in the 3D map list is Ellipsoid, which cannot be edited or removed.

Add Terrains

A new terrain can be added through the button. This opens the Add New Terrain panel, where the user can select the Provider by choosing between: Cesium, Cesium Ion and WMS.

Cesium Provider

Using the Cesium provider, the user can add a terrain to the Backgrounds Selector list by:

  • Entering a service Title and URL

Cesium Ion Provider

Using the Cesium Ion provider, the user can add a terrain to the Backgrounds Selector list by:

  • Entering a service Title
  • Providing the Asset ID
  • Providing the Access Token
  • Adding the Server name of the terrain

WMS Provider

Using the WMS provider, the user can add a terrain to the Backgrounds Selector list by:

  • Entering a service Title
  • Entering the URL of the WMS service
  • Specifying the Layer Name
  • Setting the Projection
  • Setting the WMS Version

Edit Terrain

Once a terrain has been added to the list, it can be edited using the button located to the right of each terrain.

Remove Terrain

Terrains can be removed using the button located to the right of each terrain in the list.