maptiles
maptiles copied to clipboard
jahed
Map tile generator. Converts an image into map tiles using ImageMagick. Map tiles can be used in Google Maps, Leaflet, FrontierNav, and other map rendering software.
NAME maptiles - converts an image to map tiles
SYNOPSIS
./maptiles <input_image> [
DESCRIPTION Converts an image to map tiles to be used in Google Maps, Leaflet and other map rendering software.
Version: v3.0.0 Homepage: https://github.com/jahed/maptiles Donate: https://jahed.dev/donate
OPTIONS <input_image> Image to convert into tiles. Must exist. Must be square, otherwise see --square option.
<output_directory> Output directory. Must NOT exist, to avoid polluting existing directories.
-f, --format
-b, --background
-o, --optimise (lossy|lossless)
Optimises tiles depending on the
* png uses pngquant (lossy) or optipng (lossless)
* jpg uses jpegtran (lossless)
Lossy optimisations may cause a size increase depending on each tile's
complexity. Only use it for maps which store a lot of detail per tile.
-s, --square Converts a non-square <input_image> into a square one, using whichever dimension is largest and centering the image.
-h, --help Prints this help message.
--version Prints the version.
OUTPUT
Tiles in the <output_directory> will take the format of:
<output_directory>/{zoom_level}/tile_{x}_{y}.
{zoom_level} will start at 0 and go up to the maximum zoom possible for the <input_image> rounding up to the next zoom level. An <input_image> with dimensions 2048x2048 will go up to 4 whereas an image with 3000x3000 will go up to 5. This is done to make the most out of the level of detail in the image without enlargening too much.
Each tile has a dimension of 256x256 and each {zoom_level} goes up in dimensions of 2 to the power of {zoom_level} (i.e. 1x1, 2x2, 4x4, 8x8, etc.). So overall, for each zoom level, the resulting map resolution will be 256x256, 512x512, 1024x1024, 2048x2048 and so on.
If you're using Leaflet, I suggest you set this maximum zoom as your map.maxNativeZoom so you can have higher zoom levels without the need to download larger, low quality, upscaled tiles.
EXAMPLES Take a detailed image and create optimised tiles to save space. ./maptiles detailed_map.png --optimise lossy ./tiles
Take an image, square it with a red background and output it as JPG tiles. ./maptiles map.png --square --format jpg --background #ff0000 ./tiles
DEPENDENCIES Required ImageMagick https://www.imagemagick.org Bash https://en.wikipedia.org/wiki/Bash_%28Unix_shell%29
Optional pngquant https://pngquant.org/ optipng http://optipng.sourceforge.net/ jpegtran https://jpegclub.org/jpegtran/
COPYRIGHT Copyright (C) 2020 Jahed Ahmed
This program is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or any later version.
This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Affero General Public License for more details.
You should have received a copy of the GNU Affero General Public License along with this program. If not, see https://www.gnu.org/licenses/.
jahed