Map Tile Downloader

This Python script downloads map tiles from Thunderforest's Mobile Atlas for specified regions at multiple zoom levels. It supports resuming downloads by skipping already downloaded files and provides a progress bar to track the download progress. This was designed to make map tiles that are compatible with the Lilygo T-Deck running Ripple or MUI.

Features

• Download map tiles from Thunderforest's Mobile Atlas
• Specify multiple regions and zoom levels
• Skip already downloaded files
• Progress bar to track download progress

Requirements

• Python 3.x
• requests library
• tqdm library

Installation

1. Clone the repository:

   git clone https://github.com/fistulareffigy/MTD-Script.git
   cd MTD-Script

2. Install the required Python packages:

   pip install requests tqdm

Configuration

1. Obtain an API key from Thunderforest.

2. Edit the script to include your API key:

   api_key = "your_api_key_here"

3. Specify the regions and zoom levels you want to download in the script:

   # Define the bounding boxes and zoom levels
   regions = {
       "southern_ontario": (41.5, -83.5, 45.5, -75.0),
       "las_vegas": (35.5, -116.0, 37.5, -114.0),
       "grand_canyon": (35.5, -113.0, 37.0, -111.0)
   }
   zoom_levels = range(1, 15)  # Focusing on zoom levels 1 to 14

   Please note that I have adjusted the scripts to work with Europe. I have not tested correct behaviour with any other region.

4. Choose map style

   # mapstyle = "cycle"
   # mapstyle = "transport"
   # mapstyle = "landscape"
   # mapstyle = "outdoors"
   # mapstyle = "transport-dark"
   # mapstyle = "spinal-map"
   # mapstyle = "pioneer"
   mapstyle = "mobile-atlas"
   # mapstyle = "neighbourhood"
   # mapstyle = "atlas"

Usage

The tiles will be saved in a folder named tiles on your desktop, organized by zoom level and tile coordinates.

Run the script to start downloading tiles:

python TileDL.py

Updates

2024-08-04 Thanks Scott Powell for suggesting and adding the map style selection function.

Contributing

If you find any issues or have suggestions for improvements, please feel free to create an issue or submit a pull request.

License

This project is licensed under the MIT License. See the LICENSE file for more details