Adding more detail to the Tableau offline map tile cache

Notice – if you are thinking of using this technique, please be a good citizen and keep your tile scraping to a minimum. I’ve had our product team tell me that aggressive use of this script hammers our tile servers, so to avoid this please don’t siphon to a deep level over a wide area. Let’s all play nicely together and we’ll get along.

A couple of weeks ago I saw a request from a customer asking if it was possible to have more detail in the Tableau offline map tile cache – that is the set of tile images that is included as part of a Tableau install and used when you select Map menu -> Background Maps > Offline.


Off the back of this request I did a little experimentation to see if it was possible to make the offline tile cache larger. Turns out it is possible and not terribly difficult, but it is (of course) unsupported.

The offline tile cache (for 64-bit Tableau Desktop) is in C:\Program Files\Tableau\Tableau 8.1\Local\Maps with subdirectories for languages. Under US is the English version which is where I was working. Under the normal directory you will find a series of nested folders that reflect the zoom level, each containing the tiles. Out of the box, Tableau provides tiles to zoom level 5 globally.

I have created two Python scripts. The first “” pulls tiles for the entire globe to a nominated depth. Edit the file to select which tiles you want to use (grey or original) and the depth to which you want to generate. Note that this is an exponential problem and each level has 2^n tiles so by the time you get to level 7 (for example) you will have 32K tiles. This makes the tile cache much larger and takes quite some time to generate so please be thoughtful of our tile servers.

To save  some time and bandwidth, I have already generated tiles down to level 7 globally (i.e. 2 further levels of drill) and you can pull them from here:

It also turns out that we can selectively extract parts of the globe to a deeper level and if we are just drilling in on a smaller region this is a good way to have zoom level 8+ tiles. See the second Python script “” – edit this to select the tile format, the zoom levels as well as a bounding box expressed in lat/long. It will pull the tiles just in this area.

Of course, this is:

  • Unsupported – if this breaks, you can’t call support (or me 🙂 ) so you better keep a backup of your original tile folder;
  • Going to break between upgrades – you must remember to back the cache up and reapply;
  • Very slow to populate globally below level 6 and even in defined regions below level 10;
  • Totally freaking awesome as we could use this technique to get other tile formats, potentially from other tile providers – offline aerial photography tiles, anyone?

Happy hacking!

PS:  In case you are wondering where the URLs came from, they were the result of using Fiddler2 to watchTableau Desktop make requests. It will be a trivial exercise to find the URLs for other tile types in case you need other languages, levels of detail or if you intend to pull from a completely different tile provider.

About Alan Eldridge

Hi. I'm Alan. By day I manage the APAC sales engineering team for Snowflake Computing. By night, I'm a caped crusader. Or sleeping. Most often it's sleeping.
This entry was posted in Uncategorized. Bookmark the permalink.

26 Responses to Adding more detail to the Tableau offline map tile cache

  1. craig says:

    Very clever Alan. Nice work!

  2. Ivan Monnier says:

    That’s awsome!
    2 questions:
    – is that comptible with Tableau 8.2
    – can it work on Tableau server? (our servers do not have internet access)

    • Hi Ivan,

      1. Yes, this will work for 8.2. The directory where you put the files is C:\Program Files\Tableau\Tableau 8.2\Local\Maps (for the 64-bit version) – just follow the directory structure in from there to set the correct language set.

      2. Yes, this works for Tableau Server. The directory where you need to put the files is C:\Program Files\Tableau\Tableau Server\8.2\vizqlserver\local\maps


      • Ivan Monnier says:

        Sorry if I insist,
        On Tableau Server, I have copied the “grey” file in the directory you told me. I have un zipped the file so that the tree is …\8.2\vizqlserver\local\maps\grey\…
        The maps are not displayed.
        Do I need to change parameters on Tableau Server?
        Do I need to force the use of Tableau Classic maps with Tableau Desktop ?

        Thank you


      • Hi Ivan

        Sure – happy to clarify. If you look in C:\Program Files\Tableau\Tableau Server\8.2\vizqlserver\local\maps\US\normal you’ll find a set of directories labelled 1 through 5. These are the zoom level folders and they are the ones we want to replace. Move these out to another location or delete them if you are not as conservative as me 🙂 and then open the file. Go into the grey directory and you’ll find a new set of folders labelled 1 through 10. Copy these into C:\Program Files\Tableau\Tableau Server\8.2\vizqlserver\local\maps\US\normal as replacement for the original files.

        In order to have the workbooks use these set of cached tiles you can have the workbook authors create their workbook with the offline maps options selected, but this requires them to do this every time. The other option is to “trick” Tableau Server into redirecting requests for online map tiles to the offline cache. You can do this by replacing online.tms and tableau.tms files in C:\Program Files\Tableau\Tableau Server\8.2\vizqlserver\mapsources\ with a copy of the offline.tms file in the same directory.

        Hope this clarifies.


  3. Pingback: Redirecting map tile requests | Alan@Tableau

  4. Ivan Monnier says:

    Hello Alan,

    thanks for taking the time to reply.
    I have copied the png files under the Tableau Server\8.2\vizqlserver\local\maps\US\normal directory, and have replaced the online.tms and tableau.tms by the offline.tms file.
    I still don’t have the maps.

    Here is the content of the new online.tms file.

    Best regards


  5. Oliver says:

    Hi Alan,
    can you please explain in more detail how to set the bounding box expressions to match a requested area? Let’s assume, I want to only capture offline map tiles for whole Germany, how would I need to set those boundaries?

    Thanks, appreciate your help!

    • Hi Oliver.

      First you need to work out what the bounding box is for the area of the world you want to extract. You asked about Germany so according to the required bounding box is:

      NE 55.05814, 15.04205
      SW 47.27021, 5.86624

      You would use these values in the Python script:

      #bounding box to fetch

      The script then has the logic to convert these lat/lon coordinates into slippy tile numbers. Note that the map tile URLs have likely changed since this post was originally made so you need to update the URLs as follows:

      #normal tiles
      baseURL = ‘’
      URLsuffix =’.png?apikey=ttab56540ba691a909b0f7d2af0f6fe7′

      #grey tiles
      baseURL = ‘’
      URLsuffix =’.png?apikey=ttab56540ba691a909b0f7d2af0f6fe7′

      #dark tiles
      baseURL = ‘’
      URLsuffix =’.png?apikey=ttab56540ba691a909b0f7d2af0f6fe7′

      Hope this helps.


  6. Jose says:

    Can you change the background color from White to black similar to the option when Online maps are enabled? Why is the map only white and cannot be changed when map option is switched to off??

    • Hi Jose,

      The offline maps don’t have multiple styles – only the “light” style by default. If you want a different style, then you can download a different set of offline tiles using the techniques in this blog post (in fact you could pull just about any format now that we have MapBox integration).

  7. shayhablog says:

    Hi Alan,
    First off all thanks for this post.
    few questions:
    1. what is the URL we should use now if we want to focus only on specific area?
    2. can we change the map image format (e.g. without any labeling on the map)?
    3. any limitation on the map level drill down?

  8. Rajshankar lakshminarayanan says:

    Hi Alan, Amazing explanation and it was very easy to get the files ! Can we also download the data layers along with the tiles? I am looking for a specific data layer called household.

  9. Gil BI says:

    Hey Alan,
    Great idea!
    Is there a method to pass additional parameters in the request, namely the street, road and city layers?

    • Hi Gil,

      Yes you can. Set the tiles the way you want them in Tableau and then use a tool like Fiddler to observe the HTTP requests being sent to the tile servers. This will show the URL structure for the tiles with the layers on.


  10. Amber says:

    Hi Alan, the link to the code has been expired. Would you mind uploading them again like to Google Drive? Thank you very much!

  11. Sean says:

    Tried but downloaded folders were empty.

Leave a Reply to Ivan Monnier Cancel reply

Fill in your details below or click an icon to log in: Logo

You are commenting using your account. Log Out /  Change )

Facebook photo

You are commenting using your Facebook account. Log Out /  Change )

Connecting to %s