Mapbox Tiling Service
Beta

Basic recipe using zoom levels

This is the least complex tileset recipe you can write.

There are two required top-level fields: the version of the recipe reference and the layers object.

The layers object can contain multiple individual layers, which are themselves objects. Each individual layer object must have a layer name and must contain a tileset source (source), the minimum zoom level at which you want your data to be tiled (minzoom), and the maximum zoom level at which you want your data to be tiled (maxzoom).

This example contains one layer in the layers object, named my_new_layer, and has a minzoom of 0 and a maxzoom of 8:

{
"version": 1,
"layers": {
"my_new_layer": {
"source": "mapbox://tileset-source/{username}/{id}",
"minzoom": 0,
"maxzoom": 8
}
}
}
FieldDescriptionData type
sourceThe source data to use for this layer. Tileset sources are created with the Create a tileset source endpoint of Mapbox Tiling Service (MTS).String
minzoomSpecify the minimum zoom at which your tileset will be available.Integer
maxzoomSpecify the maximum zoom at which your tileset will be available. (These tiles can be overzoomed to higher.)Integer

To learn more about zoom levels and how to configure them properly for your data, have a look at the Recipe reference's section on Zoom level configuration.

Was this page helpful?