KNOWLEDGE BASE

Maps Do Not Display or Render Incompletely on Tableau Server


Published: 20 Feb 2013
Last Modified Date: 23 Dec 2016

Issue

In a workbook with a map view, maps display in Tableau Desktop but not in Tableau Server, or render incompletely (tiles missing, or does not zoom correctly.) 

Or, the following error occurs: 

Permission denied when retrieving map. Your firewall or proxy server is likely preventing Tableau from accessing maps.tableausoftware.com.

Environment

  • Tableau Server
  • A security device (firewall, proxy, and so on) that controls access to the Internet from the computer running Tableau Server.

Resolution

Step 1

To show online maps, Tableau Server must be able to use the Run As User account to connect to the following map server over port 443 from all nodes of Tableau Server which are running an instance of the vizql process:

  • maps.tableausoftware.com:443

To open access to these addresses, either change the settings of the computer running Tableau Server as described in Configuring Proxies for Tableau Server, or create exceptions directly in the firewall or proxy.

Step 2

If Step 1 does not resolve your issue, in Internet Explorer, add the map server URLs to Trusted Sites on all nodes of Tableau Server which are running an instance of the vizql process.

  1. In Internet Explorer, go to Settings > Internet Options.
  2. On the Security tab, select Trusted Sites, and then click Sites.
  3. In Websites, enter the following map server URL and then click Add. When finished, click Close.
    • maps.tableausoftware.com

 

Cause

Tableau Server is not able to communicate with Tableau Software's map server.

Additional Information

  • Tableau Server 9.1 and earlier versions communicate over port 80, rather than 443.
  • Tableau Server 8.1 and earlier versions use the following default map servers:
    • mapspatial.tableausoftware.com (accessed the first time the map view is opened after restarting Tableau Server)
    • mapvisual2.tableausoftware.com (accessed every time the map view is opened)
  • Very secure environments might implement more complicated ways of providing access. How the request is routed does not really matter as long as Tableau Server can send requests to both sites and receive responses.
  • It is also possible to use offline maps (less detailed) or deploy a local WMS server as described in Use Web Map Service (WMS) Servers.
  • In a distributed environment, follow the steps in Resolution for any computer that runs the vizqlserver process.
    Did this article resolve the issue?