All docsAPIMapsMaps service changelog

Maps service changelog

Vector Tiles API

May 22, 2019

  • The endpoint that serves vector tiles generated from Mapbox Studio styles is now the Vector Tiles API.

October 28, 2016

  • Document .mvt extension for vector tiles, over .vector.pbf.

Raster Tiles API

May 22, 2019

  • The endpoint that serves raster tiles generated from satellite imagery tilesets and tilesets generated from raster data uploaded to Mapbox.com is now the Raster Tiles API.

August 3, 2016

  • Specifies that map tiles including mapbox.satellite are delivered as JPEG regardless of requested format.

Static Images API

December 10, 2020

  • Added documentation for requesting a static image using a bounding box with the Static Images API.

November 12, 2020

  • Added documentation for using the optional padding parameter with the Static Images API.

October 29, 2020

  • Added 422: invalid style source HTTP response code to the Static Images API to denote that styles will fail if the underlying source contains invalid values.

November 13, 2019

November 12, 2019

October 17, 2019

September 27, 2019

September 25, 2019

  • Updated the rate limit for the Static Images API from 600 requests per minute to 1,200 requests per minute.

August 5, 2019

  • Updated the Static Images API to reflect the fact that if the referenced style contains raster sources, the returned file will be a JPEG rather than a PNG.

May 22, 2019

  • The endpoint that serves static map images generated from vector map styles is now the Static Images API.

April 10, 2017

March 14, 2017

  • Added documentation for styling stroke width for encoded polyline static requests.

February 23, 2017

  • Added documentation for the Static API with overlays.

August 8, 2016

  • Corrected the maximum size of a custom icon placed on a static map.

April 5, 2016

  • Reiterates that even with the attribution=false option, attribution is required for static maps that include OpenStreetMap data.

Static Tiles API

October 29, 2020

  • Added 422: invalid style source HTTP response code to the Static Tiles API to denote that styles will fail if the underlying source contains invalid values.

September 25, 2019

  • Updated the rate limit for the Static Images API from 600 requests per minute to 1,200 requests per minute.

May 22, 2019

  • The endpoint that serves raster tiles generated from Mapbox Studio styles is now the Static Tiles API.

Styles API

January 5, 2021

December 11, 2020

October 29, 2020

  • Updated the Styles API documentation to include information about how to access immutable, versioned sprites.
  • Included note about supporting decimal values of scaled sprite displays.
  • Added 422: invalid style source HTTP response code to the Static Images API and Static Tiles API to denote that styles will fail if the underlying source contains invalid values.

August 6, 2020

August 5, 2020

  • Added note about sprite optimization in Styles API.

June 11, 2020

February 6, 2020

  • Removed metadata parameter documentation for the GET style endpoint: Styles API.

January 30, 2020

  • Increase limit of images per sprite from 500 to 1,000: Styles API.
  • Documented metadata parameter of the GET style endpoint: Styles API.

August 28, 2019

July 25, 2019

  • Updated Styles API to show parameters for mapboxGLVersion and mapboxGLGeocoderVersion.

June 26, 2019

May 23, 2019

  • Updated Styles API to show parameter for draft style.

August 24, 2018

August 24, 2017

  • Removed traffic-day-v2 and traffic-night-v2 from the list of available Mapbox styles in the Styles API.
  • Added navigation-preview-day-v2, navigation-preview-night-v2, navigation-guidance-day-v2, and navigation-guidance-night-v2 to the list of available Mapbox styles in the Styles API.

May 16, 2017

  • Updated the Styles API documentation with URLs to the Mapbox Streets v10, Mapbox Outdoors v10, and Mapbox Satellite Streets v10 styles.

April 11, 2017

July 18, 2016

  • Restore listing endpoint for styles.

July 11, 2016

  • Removed documentation for listing endpoint for styles.

June 20, 2016

  • Added documentation for the new OGC WMTS endpoint for maps.

May 10, 2016

  • Update the Styles API section with latest v9 styles, remove basic and bright styles from documentation.

Tilequery API

April 24, 2018

Uploads API

October 2, 2020

November 5, 2019

December 7, 2017

  • Added character limit notes to tileset and name parameters in the Uploads API create endpoint.

May 9, 2017

  • Added a POST request endpoint to Uploads API credentials POST /uploads/v1/{username}/credentials and updated documentation. GET requests will still work.

March 4, 2016

  • Increased public Upload limits

Mapbox Tiling Service

January 19, 2021

  • Added accept_invalid_sources as an optional parameter to the Mapbox Tiling Service Validate a recipe endpoint.

December 20, 2020

December 11, 2020

September 14, 2020

August 17, 2020

August 5, 2020

July 31, 2020

  • Added Mapbox Tiling Services PUT endpoint for replacing a tileset's source data.

June 22, 2020

June 11, 2020

May 28, 2020

  • The Tilesets API has a new name! It's now called Mapbox Tiling Service (MTS). The endpoints that you use to access MTS have not changed, and still follow the format /tilesets/v1/.

May 7, 2020

  • Documented new Tilesets API PATCH endpoint for updating tileset information, such as name, description, private, and attribution.

April 16, 2020

April 2, 2020

  • Changed the response for deleting tileset source from 201 to 204 in Tilesets API.

February 20, 2020

  • Limited the GET sources endpoint in the Tilesets API to 2000 results.

February 17, 2020

  • Changed the response of the GET status endpoint in the Tilesets API. Users relying on the last_completed_job, success, failed, queued, or processing attributes should update their applications to use latest_job and status.

February 03, 2020

  • Updated the rate-limits for various end-points associated with tilesets endpoints.
  • Fixed an invalid URL warning found during unit test

November 5, 2019

  • Updated the existing private property in the Tilesets API, which is now available to all Mapbox users and true by default.

September 24, 2019

August 26, 2019

August 1, 2019

June 5, 2019

  • Moved the Retrieve TileJSON metadata endpoint from the Maps API documentation to the Tilesets API documentation to better reflect the fact that TileJSON describes a tileset.

February 1, 2019

January 13, 2017

  • Document Tilesets API

Datasets API

May 13, 2020

  • Documented new Datasets API sortby query parameter on the list endpoint, which allows you to sort by modified or created (default) dates.

November 2, 2016

  • Removed preview label for Datasets API.

October 17, 2016

  • Removed documentation for the bulk write endpoint for datasets.

September 8, 2016

  • Update Datasets listing endpoint scope to be datasets:list, instead of datasets:read

August 1, 2016

  • Specifies that the feature endpoint of the Datasets API does not yet support GeometryCollection geometries or features without geometries.

March 30, 2016

  • Fixes documentation for the Datasets API batch endpoint: the URL ends with /features and is a POST endpoint, not a PUT endpoint as written earlier.

Fonts API

November 4, 2020

  • Added documentation for retrieving font metadata using the Fonts API.

October 30, 2020

  • Added documentation for updating font metadata using the Fonts API.

August 13, 2020

  • Added documentation for font deletion to the Fonts API.

January 8, 2020