TIBCO Cloud™ Spotfire® User Guide

Adding a TMS layer

The Tile Map Service (TMS) is a widely supported map protocol. Use it to show a map background from a third party provider or to change the default map layer.

Before you begin

To add a TMS layer, you must have a URL to a valid TMS map.
Tip: You can find many TMS resources on the internet. The article GeoAnalytics Resources on the Community site lists many TMS resources, both free and paid. The lists include the complete URL, copyright text, and if available, copyright URL to specify in the TMS layer. (The Community site is free to use; however, you 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, click TMS layer.
    The TMS layer is added to the Map chart layer list, and the layer with its default settings is added to the map chart.
    Note: If no URL has been specified, an error icon (error icon) is shown in the title bar. A TMS layer is not valid until the URL to a valid service is supplied.
  3. Required: Provide the URL to a valid service.
    Note: The URL must be in the format http://base/url/{z}/{x}/{y}. {z} specifies zoom level, {x} specifies the column number, and {y} specifies the row number. You do not need to provide values for the three variables {z}/{x}/{y} for the map to work.
  4. Optionally, move the layer to a new position on the list.
  5. Review and update map chart properties.
    Note that it is mandatory to include copyright information for the vast majority of third-party map providers. Open the Properties and locate the Copyright text and Copyright link fields to paste the required copyright information. The information is then available in the lower right corner of the map layer.

TMS layer example

In this example, the map chart has a feature layer showing the outlines of Australia counties on top of a TMS layer.

  • The feature layer for Australia Counties is available in the geocoding data tables provided in the library. The transparency is set to a high degree to show outline and shading. The feature layer is the top layer of the map chart.
  • The standard map layer is removed. The TMS layer replaces the standard map.
  • The TMS layer is drawn from a map from OpenStreetMap, so the Title property of the layer is set to OpenStreetMap.
  • The URL is set to http://a.tile.openstreetmap.org/{z}/{x}/{y}.png.

TMS map layer