The Mapbox Raster Tiles API serves raster tiles generated from satellite imagery tilesets and tilesets generated from raster data uploaded to Mapbox.com.
For information on how the Raster Tiles API is billed, visit the Pricing by product guide.
|Unique identifier for the raster tileset in the format |
|Specifies the tile's zoom level, as described in the Slippy Map Tilenames specification.|
|Specifies the tile's column |
|Specifies the format of the returned tiles: |
Note: Tiles that include
|Request a higher DPI version of the image.|
# Retrieve a 2x tile; this 512x512 tile is appropriate for high-density displays $ curl "https://email@example.com?access_token=YOUR_MAPBOX_ACCESS_TOKEN"
The response is a raster image tile in the specified format. For performance, image tiles are delivered with a
max-age header value set 12 hours in the future.
|Response body ||HTTP status code||Description|
|No token was used in the query.|
|Check the access token you used in the query.|
|Check the name of the tileset you used in the query.|
|Check the column and row of the tile requested in the query.|
|The zoom level specified in the query is larger than 30 or contains non-numeric characters.|
- The default rate limit for the Mapbox Raster Tiles API endpoint is 100,000 requests per minute. If you require a higher rate limit, contact us.
- If you exceed the rate limit, you will receive an
HTTP 429 Too Many Requestsresponse. For information on rate limit headers, see the Rate limit headers section.