Knowledge Base: Advanced usage

  • Advanced vector tiles generating

    The basic flow for simple vector tiles generating in a few steps is described in this how-to.

    In MapTiler Desktop, you can do more advanced operations with vector tiles. For example, you combine more data sources into one. Testing data used in our example can be found here and here: export them in any Geospatial data format. Drag and drop these two or more vector data into MapTiler Desktop or load them. In the case of this datasets, there is no need to set the coordinate system or change geographical location.

    In the next step, you can mix more layers together

  • Pick a color for transparency

    Transparency can switch off any color from the original image on the final map. This option is typically used to eliminate borders of multiple map sheets that are stitched together. You can set a specific color of the map to be considered fully transparent during rendering.

    It is available in Advanced image settings which can be accessed from the screen which is available prior to the rendering by clicking on the Advanced options button.

    If you set the Ignore alpha channel (4th band) check button on, the alpha channel from input images will be ignored.

    Picking own color for transparency

    In the Transparency settings

  • Advanced image settings

    Advanced image settings can be accessed from the screen which is available prior to the rendering by clicking on the “Advanced options” button. There are several options to be set. Tile format The produced tiles can be saved in one of several image format. MapTiler includes optimization of the final file size and uses a number of colors (quantization) to minimize the disk size occupied by the rendered maps as well as optimize the data transfer between clients and server once the tiles are served online. Formats which support transparency are: PNG 8-bit which is DEFAULT. Paletted RGBA PNG image

  • Submit a report

    Directly from the MapTiler Desktop

    In case of any issue with the rendering, it is possible to send us a report directly from the MapTiler application.

    The form can be found in Help -> Submit a report.

    Submitting a report on Mac

    Submitting a report on Windows 

    To successfully solve your issue, we need to have as much information as possible. Therefore, you will be asked to fill in the steps which precede your problem, because it will help us to reproduce the issue on our machine. Please, add some meaningful title to your problem which describes the issue in

  • Speed-up rendering

    MapTiler is a multi-threaded program. The modern CPUs has multiple cores and support of Hyperthreading which provides multiple logical CPUs per core. This way MapTiler can provide higher performance even on a dual-core computer. Buy more CPUs The Free version is limited to 1 CPU, MapTiler Start and Plus have a limit of 2 CPUs for rendering, which doubles the rendering speed. The Pro version is able to render on 4 or more CPUs depending on your license. With such power, it is easily able to render extremely large datasets (e.g. continents or the whole world). The number of purchased

  • Save and load project

    Saving and loading projects are available in MapTiler Desktop PRO version. A project in MapTiler Desktop is a work in progress process of turning an image into map tile.  To save your work, click in the main menu on File -> Save project…. Loading is similar: File -> Open project… or double-click on the saved file in your file browser (make sure MapTiler Desktop is associated with the .mtp files) The default save format is MapTiler Desktop Project file with .mtp extension. It consists of a set of commands for MapTiler Desktop (and MapTiler Engine). The file can be opened in any text format and particular commands are here visible in

  • Retina - HiDPI tiles

    If you need to provide your clients with small map images available on high-resolution devices, such as iPad, iPhone, Macbook Pro or a high-end Android device, you can use the retina option, which is available in MapTiler Plus and MapTiler Pro for Standard Tiles. This option will create a high-resolution (HiDPI) tiles with a size of 512x512px (instead of default 256x256px). Checkbox for Retina tiles is available on the first screen, or this function can be set up in the command line (MapTiler Pro only). Retina tile: Ordinary tile:

  • Keyboard shortcuts

    There are several keyboard shortcuts available to make the work with MapTiler more convenient (Alternative shortcuts for macOS are written in brackets): Right / Left or PageDown / PageUp keys - Continue / Back buttons Ctrl + O (Cmd + O) - Add / Open input file Delete - Remove file from the list Ctrl + N (Cmd + N) - New project [MapTiler Pro] Ctrl + S (Cmd + S) - Save project [MapTiler Pro] Ctrl + Q (Cmd + Q) - Quit application

  • Proxy settings

    If you use a computer without direct access to the internet, you can set up the proxy in MapTiler. In the menu, go to MapTiler -> Preferences. MapTiler loads the proxy settings from your system. If you are using a computer with a direct access to the Internet, you can uncheck this box.

  • MapTiler Pro in Docker

    Complete application with all its dependencies is available in a container compatible with any Linux system. Thanks to Docker it is very easy to install MapTiler on a node of a cluster or any Linux distribution even with a simple command. See MapTiler Docker Hub repository One command to run MapTiler Pro on the command-line anywhere where docker is available:   The actual directory is directly mapped to docker and is writeable. All relative paths and local bash autocomplete is usable. Your license can be passed with -e MAPTILER_LICENSE=… parameter to docker. Without a license, MapTiler runs in the demo mode (with