Skip to main content

Loss of data precision or resolution at higher zoom levels

If you use the Mapbox Uploads API or upload data through the user interface in Mapbox Studio, you might notice that your data appears less detailed than expected at higher zoom levels. The uploads API automatically makes decisions about certain presentation details like simplification, minimum zoom, and maximum zoom based on the data you are uploading. These optimization make your map load faster and limit the file size of the resulting tileset.

Visually, this can result in:

  • Vector data being simplified at higher zoom levels
  • Raster data using a lower resolution than intended at higher zoom levels

Use Mapbox Tiling Service for more control

We suggest using Mapbox Tiling Service (MTS) to adjust the maximum zoom level for vector data. You can use MTS to set or update a tileset's zoom extent in its tileset recipe. Do this using the Tilesets CLI or by using MTS directly. For more information on zoom level configuration in tileset recipes, see the Tileset recipe reference and the Basic recipe using zoom levels example.

Was this page helpful?