Mapbox Tiling Service
- Create highly customized vector tilesets
- Specify IDs for each feature in a tileset
- Reuse uploaded data across multiple tilesets
- Generate tilesets with multiple layers to optimize for performance
Mapbox Tiling Service (MTS) is a tool for creating vector tilesets. With MTS, you use sets of configuration options (tileset recipes) to transform your geospatial data into vector tiles. The resulting tiles are hosted on Mapbox servers for use in your applications.
Vector tilesets are helpful if you want to visualize a large amount of data on a map quickly. When creating vector tiles, you can turn gigabytes of raw geospatial data into mere kilobytes, which can be critical for complex data visualizations since most modern browsers support loading about 100 MB of data at a time. And when you use MTS to create vector tiles, you have precise control over how your geospatial data is reduced into tiles.
Use cases
You can use MTS for many use cases. For example, you could use it to:
- Tile census boundaries to make interactive election visualizations.
- Add hiking paths, trails, or other roadways not included by default in Mapbox Streets to your map.
- Visualize activity data like runs or bike rides on a map.
- Add hotel or real estate properties and their attributes to a map.
- Create multi-layer tilesets (tilesets that contain up to 20 different data layers).
Because MTS is hosted by Mapbox and designed to scale, you can build full, end-to-end data pipelines with it. It's the same service Mapbox uses internally to create our global, daily-updating basemap Mapbox Streets.
How to use MTS
MTS requires two inputs to make tiles: a tileset source (your geospatial data) and a tileset recipe (a JSON document that specifies the configuration options for turning the tileset source into tiles). Learn more about tileset sources in the Tileset sources guide. Learn about how to format tileset recipes using the Recipe specification
You can interact with MTS in three ways:
- MTS Data Sync: A no-code MTS pipeline
- Tilesets CLI: Flexible, powerful tool for preparing and uploading data
- MTS API endpoints: Access the API endpoints directly
MTS Data Sync
MTS Data Sync is a command-line tool that allows you to publish data directly to MTS without writing any code. For many use-cases, MTS Data Sync provides the most straightforward way to use MTS. For example, it only takes one command to convert a standard GeoJSON file to line-delimited GeoJSON to use as a tileset source and to generate a tileset recipe. MTS Data Sync also provides a command that lets you estimate the cost of a tileset processing job.
For more information about the MTS Data Sync tool, including all available commands, see the MTS Data Sync documentation.
Tilesets CLI
The Tilesets CLI is a command-line Python tool that allows you to prepare and upload data for MTS. To create an example tileset using the Tilesets CLI, follow the Get started using Mapbox Tiling Service and the Tilesets CLI tutorial.
We recommend using the Tilesets CLI instead of MTS Data Sync if:
- You have a large dataset that needs multipart uploads
- Your use-case requires multiple tileset source files
- You prefer a less opinionated pipeline and want a more flexible tool
For more information about the Tilesets CLI, including all available commands, see the Tilesets CLI documentation.
MTS API endpoints
MTS has API endpoints for creating and interacting with tileset sources and tilesets. These endpoints are generally accessed using MTS Data Sync or the Tilesets CLI tool, but you can also access them directly instead (for example, if you want to integrate MTS into an application so that you can make vector tilesets programmatically).
To learn more about these API endpoints, see the MTS API documentation.