New TIBCO Community Launches Soon!

The community will temporarily be 'read-only' beginning July 8th until the launch.

Offline Maps in Spotfire

Last updated:
1:36am Jul 19, 2021

Map tiles (or tiles web map, slippy map or raster tiles) are a map displayed on your Map Chart by seamlessly joining dozens of individually requested image files over the internet. They are convenient because they are loaded on-demand over the internet but there are some cases where it is desired to work with maps offline. That's the reason why TIBCO Spotfire allows the use of a local override of the default map service.

In this guide you will learn how to host map tiles locally for use in Spotfire.

1. Download the Map Tiles

This guides comes with a pre-downloaded map tiles package ( containing worldwide raster tiles and vector tiles (used for PDF export) down to zoom level 6 (level 0 is the lowest level of details). It is precise enough to visualize data at country, state (Admin-1), county (Admin-2) levels offline.

You can download the package ( at the bottom of this page, or here.

You can also download map tiles for a specific geographic area or for additional zoom levels for use offline. To do that you will need to follow the latest section of this article "Creating a custom Map Tiles Package".

2. Setup a Localhost Server to host the Map Tiles

  1. Go to Control Panel > Programs > Turn Windows features on or off.
  2. Check “Internet Information Services”.

  3. Click OK.

3. Enable Cross-origin Resource Sharing (CORS)

CORS must be activated on Internet Information Services to enable fetching vector tiles used for PDF Exports of map charts in Spotfire.

  1. Go to Control Panel > Administrative Tools
  2. Open Internet Information Services (IIS) Manager
  3. Open HTTP Response Headers

  4. Click Add and enter the following setting:

    Name: Access-Control-Allow-Origin

    Value: *

  5. Click OK.

3. Install the Map Tiles

  1. If not done already, extract the archive you previously downloaded
  2. Move the “maplayer” folder in your localhost directory (Local Disk > inetpub > wwwroot).

  3. Eventually, if the offline map will be called from a different domain than localhost, modify the URL in the JSON Files (services-list & offlinemap).


4. Configure Spotfire

The offline map tiles are ready to be used in Spotfire. You simply need to change the default Map service URL to your locally hosted tiles.

  1. Start Spotfire.
  2. Go to Tools > Options > Map Chart.
  3. Check "Custom URL" and replace default URL by the URL of your locally hosted tiles service list (Should be http://localhost/maplayer/services-list.json).

  4. Click OK and restart Spotfire (A change of map service will only take effect after the program has been restarted).


4b. Configure Spotfire Web Player

If you need the Spotfire Web PLayer to use offline tiles, you simply need to change the default Map Service URL to your locally hosted tiles in the Administration Manager.

  1. Start Spotfire.
  2. Go to Tools > Administration Manager > Preferences > Everyone > MapChart > MapChartPreferences
  3. Enter URL of your locally hosted tiles service list (Example: http://localhost/maplayer/services-list.json) in "DefaultWebMapServiceListUrl" and "DefaultHttpsWebMapServiceListUrl"
  4. Close.


Creating a custom Map Tiles Package

This part of the guide provides guidance on how to download map tiles from TIBCO GeoAnalytics map service using QGIS.

Note that this method is way to download raster tiles to be used offline in your Spotfire analysis. This method does not support downloading vector tiles necessary to support offline PDF Exports of map charts in Spotfire.

QGIS is a free, open source professional GIS software available for Windows, macOS and Linux used to create and edit geospatial information. The instructions below are based on QGIS 3.6.

1. Install and configure QGIS

  1. Download, install and start QGIS
  2. Go to Plugins > Manage and Install Plugins...
  3. Install the "Tiles XYZ" plugin and close the Plugins windows

2. Add the TIBCO GeoAnalytics map tiles

From the Browser panel, right-click XYZ Tiles and create a New Connection with the following information:

Click OK and double click the TIBCO GeoAnalytics XYZ Tiles service you just created. The TIBCO GeoAnalytics map is now added to QGIS and visible from the Map View.

3. Downloading the Map Tiles

The guide comes with a map tiles package template containing the files necessary to Spotfire to make your map work offline.

  1. Download the template package ( at the bottom of this page, or here.
  2. Extract the archive and rename the folder to "maplayer"
  3. Go back to QGIS
  4. Open the Processing Toolbox (Ctrl + Alt + T), double-click "Generate XYZ Tiles (Directory)" and enter the following information:

    - Extent: Select "Use Canvas Extent"

    - Minimum Zoom: Choose the minimum zoom level (level 0 the lowest, level 18 the most precise)

    - Maximum Zoom: Choose the maximum zoom level (level 0 the lowest, level 18 the most precise)

    The higher the number of zoom levels you select the longer it will take to download the tiles and the more storage space will be required from your local drive.

    We don't recommend downloading tiles from zoom level 10 and upper.

  5. Click "Run". Map Tiles are now downloading. This process can take a while depending on the number of zoom levels and their precisions.

4. Configure the Template Package

  1. Go to the maplayer folder you previously downloaded and extracted
  2. Open offlinemap.json with a text editor
  3. Change the value for the following lines:

    - minScale = The minimum zoom value you set in QGIS

    - maxScale = The maximum zoom value you set in QGIS

  4. Save and close the file

Your custom Map Tiles package is now ready to use with Spotfire. You can follow the steps described at the top of the page.


Package icon maplayer.zip73.3 MB
Package icon maplayer-template.zip18.33 KB

Feedback (2)

@erick.ruizherrera: Could you check if cross-origin resource sharing (CORS) is enabled on Apache server ?

Arnaud Varin 5:01am Jan. 29, 2018

Hi there,

We have an instance of Spotfire that does not have access to Internet which is why we had to work with offline maps. 
But we hosted the maps on another server using Apache instead of IIS, which I do not think would be a problem, right? 
When we try to create a new map chart it shows the loading icon and then after some time it displays an error saying: "Error when downloading map chart service list from <Our internal URL>". 
We also updated the references on the servicelist.js and standarmap.js files.
From the computer on which Spotfire Analyst is install I can enter the URL on a Internet browser and I can reach the file and see the contents. So, it is not an issue of not being able to reach the file. 
Is there any log we can check to see a more descriptive error? Any thoughts?

erick.ruizherrera 6:46am Jan. 26, 2018