Terrastories Support Materials
  • Introduction
  • OVERVIEW
    • About Terrastories
      • How Terrastories is being used
    • FAQs
    • Getting started
    • Terrastories demo
  • USING TERRASTORIES
    • Exploring the Terrastories main interface
    • Using the Terrastories member dashboard
      • Exploring and creating stories, speakers, and places
      • Customizing your community theme
      • Setting up users and roles
      • Setting up an Explore Terrastories view for your community
      • Modifying map settings
      • Importing data
  • EXPLORE TERRASTORIES
    • What is Explore Terrastories?
    • Exploring the Explore Terrastories interface
    • Setting up Explore Terrastories for your community
  • Operating Terrastories Offline
    • Operating an offline Terrastories "Field Kit"
    • Preparing offline map packages
  • SETTING UP A TERRASTORIES SERVER
    • Hosting environments
      • 🌐 Hosting Terrastories online
      • 🛖 Hosting Terrastories offline as a "Field Kit"
        • Advanced Setup
      • 🍫 Hosting Terrastories on Kakawa (Earth Defenders Toolkit Offline)
    • Navigating the Super Admin dashboard
    • Setting up an Explore Terrastories server
  • MISCELLANEOUS
    • Support
    • Troubleshooting
      • Offline map tiles are not showing up
      • Resetting passwords (using the Rails console)
      • Saving and printing Terrastories reference materials
    • Translating Terrastories
    • Additional resources and references
    • For developers
  • Terrastories website
  • our.terrastories.app
Powered by GitBook
On this page
Export as PDF
  1. MISCELLANEOUS
  2. Troubleshooting

Offline map tiles are not showing up

PreviousTroubleshootingNextResetting passwords (using the Rails console)

Last updated 1 year ago

It may happen that when you have set up Terrastories for an offline environment ("Field Kit" or mesh) that your offline map tiles are not showing up on the Terrastories map.

Typically, there are two reasons for this:

  1. Your map tiles are not properly defined in your style.json file. The mbtiles or pmtiles file must be defined in the sources array, and you must have layers which place and style your data (raster or vector) within the layers array. See Preparing offline map packages for more.

  2. Your map tiles cover a small area, and you are not sufficiently centered, and zoomed in, on that area. Many map tilesets start at zoom level 0, which is the whole world; hence, when you zoom out on Terrastories, you should start to see some tiles, and as you zoom in, you can see where the area that your tileset covers is located. However, some map tilesets may start at a much higher zoom level and are therefore hard to find on the map. To resolve this, we recommend setting a Zoom Level and Center coordinates, along with Map Bounds to avoid the user from traveling far away from your tiles. (You might need to get the coordinates for these from the source who created the map tiles, or use a tool like to figure them out.) See Modifying map settings for more.

Still having issues? Access the console in your browser's developer tools to see if there are any errors. If you need help interpreting these, please see Support for ways to get help.

Mapbox Location Helper