Tile Margin in MapTiler Server

This article provides a quick overview of the Tile Margin option that can be used as part of the rasterization process in MapTiler Server.

Bear in mind, that this functionality will be useful only with the data not coming from the
MapTiler platform. MapTiler Data is prepared in the way, to not have issues like that, although they may occur with the data coming from other sources.

Rasterization is only supported on Windows and Linux. Mac users have to use Docker image.

What is it?

Tile Margin is adding additional image side length during tile rendering that is cropped from the delivered tile. It’s very useful for resolving the issue with cropped labels. 

Here is an example:

*Issue of cropped labels in Luxembourg area after map rasterization

The same area after map rasterization with Tile Margin option*

It’s worth mentioning that but it does come with a performance degradation because additional adjacent vector tiles need to be loaded to generate a single tile. That’s why the Tile Margin is turned off by default in MapTiler Server (value set to 0).

Where to find it?

In order to turn it on, you need to navigate to MapTiler Server. Under settings, please select the “Rasterization” tab.

The value can be set from 0 to 100 px.

To enable Tile Margin to work, just set the value anywhere from 1 to 100 px.

After the Tile Margin option is on, it will do its magic with the map rasterization process meaning it will be also applied to the WMTS feature.

Much appreciation for “Administration du cadastre et de la topographie” and Luxembourg Geoportal for letting us use their data as an example in this article.