TIBCO Cloud™ Spotfire® User Guide

Adding a WMS layer

The Web Map Service (WMS) is a standard protocol for serving map images that a map server generates using data from a Geographic Information System (GIS) database. You can add a WMS layer to a map chart visualization to provide specialized context.

Before you begin

To add a WMS layer, you must have a URL to a valid WMS 1.1.1 (or earlier) service that uses WGS84 coordinate reference system (EPSG:3857 or EPSG: 4326). You can use a WMS server that does not require any login credentials, uses basic authentication or authentication with an identity provider (OAuth).

To authenticate with an identity provider, you must configure your Spotfire environment and the external system (the WMS server) from which you want to access data to use your identity provider. See Authentication with an identity provider (OAuth2) to access external systems for more information.

Tip: Many WMS resources are available on the internet. The article WMS sources for Spotfire on the Community site lists many links to sites that contain WMS resources, both free and paid. (The Community site is free to use; however, users must register an account to gain access to the information.)

Procedure

  1. Follow the steps in Adding layers.
    Tip: You can reuse the settings of an already existing layer instead of adding a completely new layer. See Duplicating a layer for detailed instructions.
  2. From the list, select WMS layer.
  3. Required: Provide the URL to a valid service.
    The URL must link to a valid XML structure and a server that supports a WMS 1.1.1 or earlier service, and which uses the WGS84 coordinate reference system (EPSG:3857 or EPSG: 4326).
    Note: If you enter a link to a server that supports only WMS 1.3.0 or later, an error is shown in the title area.
    Most WMS maps are designed for specific regions or countries. If you provide a URL that contains a map structure for another country or region, Spotfire will show an error.
  4. If the specified WMS service requires login, select an Authentication method from the drop-down list.
    OptionDescription
    Username and password Enter your username and password and click Log in.
    Identity provider (OAuth)
    Note: This option is not available in TIBCO Cloud™ Spotfire environments.
    Select your Identity provider from the drop-down and select the Scopes. Scopes determine which permissions Spotfire requests on your behalf when you log in to the server. Use the Default scopes that you have specified for your identity provider in the OAuth2IdentityProviders preference. Or use Custom scopes by entering scopes manually in the text box. Separate values with a space.

    Click Log in to be redirected to your identity provider to log in.

    Tip: Under Visualizations > Manage external logins you can see all identity providers used to log in to a WMS server and whose map data is used in visualizations. Here you can also log in again, for example, after starting a new session.

  5. Expand the WMS sublayers section in the visualization properties panel to add sublayers. See Configuring a WMS layer and sublayer for detailed instructions and an example.