Downloads and stitches images downloaded from Map Tile servers.
Assuming you have Python 3 installed and in your $PATH, you can run pip3 install -r requirements.txt and all required dependencies will be installed. For best results, use a VirtualEnv. If you'd prefer not to use requirements.txt, the manual install instructions are below.
- Python 3
- Python Requests (
pip3 install --user requests==2.*) - Python Pillow (
pip3 install --user Pillow=6.*) -- optional, used for image stitching and corruption checking
After ensuring your dependencies are installed, you can run the program with python3 tsdl.py. It will prompt you for your bounding Lat and Long coordinates, zoom, and tile server URL.
For best results, the larger the area you select with your lat & long, the smaller you should have your zoom. If your zoom is too big, downloading will take longer, your resulting stitched file will be larger, and the tile server may throttle / restrict your usage. See this OpenStreetMap Wiki page for scaling and examples, and this tool to generate a bounding box.
The program will tell you the coords it rounded to (make a note of these for geolocation, they are the top right and bottom left of the generated image), and start downloading the tiles to the tiles/ folder.
After downloading all tiles, you will be asked if you'd like to stitch together the images. Type "y" to continue, or anything else to exit. The tiles will be stitched together, and saved to a file named with the pattern Map_XMIN-XMAX_YMIN-YMAX.(.png|.jpg).
The following example will download and stitch tiles within an area of the MIT campus in Cambridge, Massachusetts.
$ # Command-line format
$ python3 tsdl.py -h
Starting Anaxi Tile Downloader...
usage: tsdl.py [-h] [--tilesDir TILESDIR] [--stitchFormat STITCHFORMAT]
[--noStitch] [--forceDownload] [--printSourcesAndExit]
[--dryRun]
latStart lonStart latEnd lonEnd zoom tileServer
Download and stitch tile images from GIS / TMS Tile Servers
positional arguments:
latStart Starting Latitude Coordinate
lonStart Starting Longitude Coordinate
latEnd Ending Latitude Coordinate
lonEnd Ending Longitude Coordinate
zoom Level of Zoom / Detail (more zoom + large area = huge
image)
tileServer URL (or ID) of the Tile Server to download from
optional arguments:
-h, --help show this help message and exit
--tilesDir TILESDIR Where to save tiles / Map
--stitchFormat STITCHFORMAT
Format to save stitched Map as
--noStitch Don't stitch tiles together
--forceDownload Skip checking if files are already downloaded
--printSourcesAndExit Print known tile sources and exit
--dryRun Print download area, expected number of tiles and exit
$ python3 tsdl.py 42.363531 -71.096362 42.354185 -71.069741 17 https://tile.openstreetmap.org/%zoom%/%xTile%/%yTile%.png
$ python3 tsdl.py
Starting Anaxi Tile Downloader...
Enter Starting Latitude: 42.363531
Enter Starting Longitude: -71.096362
Enter Ending Latitude: 42.354185
Enter Ending Longitude: -71.069741
Zoom / Level of Detail (usually 0-18, larger = more data & detail): 16
Would you like to stitch images together? (Y/n) y
Format to save as [Blank for suggested, or .jpg, .png, .tiff, etc]:
Tile Server URL: https://tile.openstreetmap.org/%zoom%/%xTile%/%yTile%.png
Starting at North-West corner: [42.366661663732735, -71.0980224609375]
Ending at South-East corner: [42.34636533160188, -71.0595703125]
Downloading X tiles 19825 through 19831
Downloading Y tiles 24238 through 24242
Downloading a total of 35 tiles
Downloading https://b.tile.openstreetmap.org/16/19825/24238.png to 16_19825_24238.png
Downloading https://b.tile.openstreetmap.org/16/19826/24238.png to 16_19826_24238.png
Downloading https://b.tile.openstreetmap.org/16/19827/24238.png to 16_19827_24238.png
...
Download Complete!
Stitching images...
Changing tile width to 256
Changing tile height to 256
Stitching 16_19829_24242.png
Stitching 16_19830_24242.png
Stitching 16_19831_24242.png
...
Format to save as [Blank for suggested, or .jpg, .png, .tiff, etc]:
Saving to Map_16_19825-19831_24238-24242.png...
Stitched image saved to tiles/Map_16_19825-19831_24238-24242.png
Anaxi supports a number of tile servers out-of-the-box. You can find a full list of supported servers by running with the argument --printSourcesAndExit. To use them, pass their ID in place of the Tile Server URL when asked. I personally like MapTiler Cloud, Google Satellite Hybrid, and OpenStreetMap the best, though you should try several or look at the link below for samples and see which you like the best.
Below is a small list of sources for Tile Servers. Beware, some of the linked servers have restrictions on usage, zoom, and may throttle or deny service if you violate their terms.
To format the URL correctly, replace the zoom, x tile, and y tile spot with %zoom%, %xTile%, and %yTile% respectively. Ensure that the URL ends in a file extension (usually .jpg for satellite / terrain maps and .png for others), and that the tile server returns images that are 256px by 256px. You should have something that looks like this: https://tile.openstreetmap.org/%zoom%/%xTile%/%yTile%.png
- USA/NA Tiles
- Index of many TMS Servers
- MapTiler Cloud (free account for non-commercial use)
- https://wiki.openstreetmap.org/wiki/Tile_servers
- https://wiki.openstreetmap.org/wiki/Slippy_map_tilenames#Tile_servers
- https://www.trailnotes.org/FetchMap/TileServeSource.html
- https://raw.githubusercontent.com/klakar/QGIS_resources/master/collections/Geosupportsystem/python/qgis_basemaps.py
- Bounding Box generator / size estimator
- Alternate bounding box generator
- US National Map Service Advanced Map Biewer
- QGis: FOSS geographical information system
- Official Google Maps Tile API
- Alternative Map Tile Downloader
- Samples of tiles from various sources
- Unoficcial Google Maps Tile URL Schema
- TMS and Slippy standards
- https://wiki.osgeo.org/wiki/MapSlicer
- https://github.com/nst/gmap_tiles