OGC WMS Layer

Icon Map Slicer can overlay tiles provided by an OGC WMS (Web Map Service) server on top of the background map. You can display up to 5 WMS layers. The server must use an HTTPS address to work within Power BI and serve layers in EPSG:3857.

Authentication

Icon Map Slicer offers multiple methods of authenticating against WMS servers:

None

For public access sources that do not require any authentication.

Basic (Username and Password)

For servers configured with basic authentication using a username and password.

Token / API Key in URL

This is for servers where a token or API key is passed in the URL. For example, if your server's example URL looks like https://exampleserver.com/service/wms?request=getCapabilities&apikey=YOUR_KEY you should enter https://exampleserver.com/service/wms?request=getCapabilities in the WMS Server URL textbox, apikey in the Authentication Property Name textbox, and your key in the Authentication Property Value textbox.

Token / API Key in Header

This is for servers where a token or API key is passed in the HTTP headers.

Automatic Configuration

If the server has CORS enabled, then Icon Map Slicer will be able to interrogate the server and return the available layers and formats automatically.

Enter the WMS Server URL (either with or without the ?request=GetCapabilities&service=WMS query string) and Icon Map Slicer will parse the GetCapabilities response to populate the Layer and Format dropdowns.

Manual Configuration

If the WMS server hasn't been configured for CORS, toggle the Manual Configuration option and enter the appropriate values manually.

Layer

The name of the layer as specified in the capabilities XML.

Format

The format of the output, for example image/png.

Style (optional)

Specify a named style for the layer if required.

CQL Filter

For supported servers such as GeoServer, the CQL Filter allows you to dynamically determine which WMS items are displayed. CQL expressions should be in the following format: [Property Name]=[Property Value]. Text items should be enclosed in single quotes, for example:

Name='York'

You can use DAX expressions to dynamically generate the CQL filter from values in your data or selected slicer values.

Custom Parameter Name and Value

If you need to pass any additional parameters on the URL, do not include these in the WMS Server URL. Instead, enter the parameter name in the Custom Parameter Name field, and the value in Custom Parameter Value.

Transparency

Percentage transparency of the layer between 0 and 100.

Minimum Zoom

The zoom level at which the layer starts to be shown.

Maximum Zoom

The zoom level at which the layer stops being shown.

Z-Index

A number representing the order of the layer relative to other Icon Map Slicer layers.

Visible

Whether the layer should be shown or not. This can be set using conditional formatting (yes or no) to dynamically display a layer according to your data context or a Power BI slicer.

Additional Layers

It is possible to overlay multiple WMS layers on the same map.

Specify the number of additional layers using the Number of Additional Layers setting (up to 4 additional layers), then use the Apply settings to dropdown to configure the selected layer. Each additional layer has its own WMS Server URL, Layer, Format, Style, Authentication, CQL Filter, Transparency, Visible, Minimum/Maximum Zoom, and Z-Index settings.