---
title: "Choosing a tiling scheme in Folder output | Guides | Map tiling hosting | Data processing"
description: "Overview of tiling schemes and naming standards in MapTiler Engine."
---

> For AI agents: a documentation index is available at [/llms.txt](https://docs.maptiler.com/llms.txt). Markdown versions of all pages are available by appending .md to any URL.

# Choosing a tiling scheme in Folder output

This article will show you how to work with the tiling scheme for the Folder output in MapTiler Engine. You will learn what a tiling scheme is and what options MapTiler Engine offers for its utilization.

_The global settings dialog is available since MapTiler Engine 11.3 (TO-BE-RELEASED). Alternative with command line for MapTiler Engine is available publicly now, see the link to the manual below._

You can select a tiling scheme [in the settings](https://docs.maptiler.com/guides/map-tiling-hosting/data-processing/global-settings/), either globally or just for a specific rendering task.

## What is a tiling scheme?

The map of the world is divided into small squares, each with a fixed geographic area and scale, called the **map tiles**. Displaying any dynamic map using map tiles requires a system for naming these map tiles - simply called **tiling scheme** (or shortly `scheme`, in MapTiler platform).

There were defined multiple world-known standards for naming map tiles. The most popular and world-used scheme used by many map providers (such as OpenStreetMap, Google Maps, MapTiler, Mapbox, …) was defined by Open Geospatial Consortium (OGC) in the WMTS standard definition released in 2010 and is simply called **XYZ**, or sometimes precisely **ZXY** (see later).

![Figure 2 - Tile Space from WMTS specification](./4409540577297_9962f454ae.png)

The map tiles are structured into folders, and the final tile image is a file within one of these folders. Each zoom level is a folder, each column is a subfolder, and each tile in that column is a file. The folder structure depends directly on the tiling scheme and will be defined below for each available scheme in MapTiler Engine.

### Top-Left vs Bottom-Left origin

The important part of the tiling scheme definition is the location of origin = the first tile in the defined area and vertical/horizontal orientation for the following tiles (referred to as increasing numbers).

**Top-Left** origin describes:

-   X goes from the **left** edge, starting with 0 to the right edge of the map
-   Y goes from the **top** edge, starting with 0 to the bottom edge of the map

**Bottom-Left** origin describes:

-   X goes from the **left** edge, starting with 0 to the right edge of the map
-   Y goes from the **bottom** edge, starting with 0 to the top edge of the map

The difference can be visible in the image below, where **Google is Top-Left**, and **TMS is Bottom-Left**.

![](./4409540577937_5360a6fdfd.png)

### OpenGIS WMTS / OpenStreetMap / Google XYZ / ZXY

Google Maps was one of the first systems to display dynamic maps on the web. They chose a Spherical Mercator projection because it preserves shape and angles. The entire world looks like a square, which makes it easy to work with on a computer. Almost every open source and commercial Maps API provider as well as OpenStreetMap and [MapTiler Maps APIs](https://docs.maptiler.com/cloud/api/) are now using this projection and tiling profile and the tiles are therefore compatible with each other.

The folder path is `{z}/{x}/{y}.{ext}`, where `{ext}` is the extension of tile format (`png`, `jpg`, `webp`, …). Therefore, the alternative name for `XYZ` is `ZXY`, as it reads the folder structure for these tiles.

![](./4409540578193_1d37a89ac4.png)

### OSGEO TMS

Tile Map Service (TMS) is a specification for tiled web maps, developed by the Open Source Geospatial Foundation. This specification is very similar to Google XYZ, describe above, with one important difference. TMS has origin **bottom-left**, which means it has flipped Y-axis as opposed to XYZ. This tiling scheme is defined as a standard for the MBTiles package.

The equation to calculate Y: `y = (2^z - 1) - y`

![](./4409540578449_cebff9be95.png)![](./4409532398481_56b06fd59d.png)

### Microsoft Bing QuadKey

Microsoft Bing Maps introduced two specifications for naming tiles - QuadKey and ZYX.

To optimize the indexing and storage of tiles, the two-dimensional tile XY coordinates are combined into one-dimensional strings called quadtree keys, or **quadkeys** for short. Each **quadkey** uniquely identifies a single tile at a particular level of detail, and it can be used as a key in common database B-tree indexes.

![](./4409532398737_7aabf897fc.webp)

Quadkeys have several interesting properties:

-   The length of a quadkey (the number of digits) equals the level of detail (zoom) of the corresponding tile
-   The quadkey of any tile starts with the quadkey of its parent tile (the containing tile at the previous level)
-   Quadkeys provide a one-dimensional index key that usually preserves the proximity of tiles in XY space. In other words, two tiles that have nearby XY coordinates usually have quadkeys that are relatively close together. This is important for optimizing database performance, because neighboring tiles are usually requested in groups

![](./4409532398993_a238a41664.png)

### Microsoft Bing ZYX

Bing Maps also supports custom tile layers that use a hierarchical directory structure and custom file names, rather than the native quadkey file naming structure. In the hierarchical Bing Maps structure, all of the tile files for each zoom level are stored in a correspondingly named directory. This scheme is same as ZXY, but Y-axis is swapped with X-axis. Y-axis are folder names, while X-axis are file names.

The folder path is `{z}/{y}/{x}.{ext}`.

![](./4409532399249_441b9198af.png)

## Conclusion

MapTiler Engine provides some tiling scheme - the naming of map tiles for Folder output. The differences and short history were introduced for each supported tiling scheme. To see different in a fast way, you can look at the GIF below:

![](./4409532399505_9678309562.webp)

## Useful links

[Tiling scheme in MapTiler Engine](https://docs.maptiler.com/engine/advanced-options/#tiling-scheme---naming-of-tiles)  
[Tiles à la Google Maps](https://www.maptiler.com/google-maps-coordinates-tile-bounds-projection/)  
[OpenGIS WMTS Standard](https://www.ogc.org/standards/wmts)  
[Slippy map tile names (OSM)](https://wiki.openstreetmap.org/wiki/Slippy_map_tilenames)