Skip to main content

Maps service changelog

Additional Developer Resources

Vector Tiles API​

Mar 7, 2023​

  • Removed sortby parameter from list styles endpoint in Styles documentation

Jan 23, 2023​

  • Removed beta flag from MTS API

Oct 31, 2022​

  • Updated tileset ID's wording in MTS documentation

July 14, 2022​

  • Documented the Vector Tiles API's default cache headers and linked to new troubleshooting page with tips on working with caching.

May 4, 2022​

Jun 4, 2021​

  • Documented the Vector Tiles API's cache behavior when compositing multiple tileset IDs.

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​

July 14, 2022​

  • Documented the Raster Tiles API's default cache headers and linked to new troubleshooting page with tips on working with caching.

Jun 4, 2021​

  • Documented the Raster Tiles API's cache behavior when compositing multiple tileset IDs.

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​

July 14, 2022​

July 20, 2021​

  • Updated the maximum zoom value from 20 to 22.

April 16, 2021​

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

February 24, 2021​

  • Added 422: Overlay bounds are out of range. HTTP response code to 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​

July 14, 2022​

July 20, 2021​

  • Updated the maximum zoom value from 20 to 22.

April 16, 2021​

  • Updated the rate limit for the Static Tiles API from 5,000 to 6,000 requests per minute.

February 18, 2021​

  • Noted that the Static Tiles API will return a PNG if the queried tileset contains only vector layers.

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​

November 29, 2023​

  • Added the standard GA endpoint for Mapbox Standard and removed the standard-beta endpoint

August 2, 2023​

  • Added the standard-beta endpoint for Mapbox Standard

July 14, 2022​

  • Documented the Styles API's default cache headers and linked to new troubleshooting page with tips on working with caching.

January 11, 2022​

  • Added documentation for the new Protected endpoint.

August 3, 2021​

  • Updated the description for the Request embeddable HTML endpoint's optional hash parameter to show that it can also accept values for bearing and pitch.

May 19, 2021​

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​

Mar 13, 2024​

July 14, 2022​

  • Documented the Tilequery API's default cache headers and linked to new troubleshooting page with tips on working with caching.

Jun 4, 2021​

  • Documented the Tilequery API's cache behavior when compositing multiple tileset IDs.

April 24, 2018​

Uploads API​

January 25, 2021​

  • Removed the private property from the Uploads API since this is not an allowed property right now.

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​

June 21, 2023​

October 26, 2022​

  • Under Restrictions and limits, reduced MTS read rate limit from 100,000 to 3,000. Updated Delete a tileset with MTS write rate limit.

Aug 19, 2022​

  • Make the use of tileset_id, tilesets, tileset_name, id more consistent.

July 14, 2022​

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​

  • Updated the Mapbox Tiling Service List tilesets endpoint to have a maximum limit value of 100 instead of 500.

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​

July 14, 2022​

  • Documented the Datasets API's default cache headers and linked to new troubleshooting page with tips on working with caching.

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​

July 14, 2022​

  • Documented the Fonts API's default cache headers and linked to new troubleshooting page with tips on working with caching.

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​

Mapbox Standard Style​

December 18, 2024​

  • Added support for custom map color themes using a LUT (look-up table).
  • Added support to customize color for parts of the road network: colorMotorways, colorTrunks, and colorRoads.
  • Added taxi icon to indicate taxi stands.
  • Added support for basic interaction with place labels and poi labels using the experimental featuresets API.
  • Visual improvements by adjusting fog range and setting a higher minzoom for toilet POI types.
  • Fixed bug related to missing polygon roundabouts.

November 25, 2024​

  • Added support for language and worldview switching for labels and boundaries.

July 31, 2024​

  • Introduced Standard satellite style with additional configurations showRoadsAndTransit and showPedestrianRoads.
  • Added new theme configuration with default,faded and monochrome themes.
  • Added new show3dObjects config to toggle visibility for 3D layers, including shadows and ambient occlusion.
  • Style improvements for road label visibility and POI label and icon colors.
  • Set icon-occlusion-opacity and text-occlusion-opacity for all labels (except POI and transit labels).
  • Set fill-extrusion-cutoff-fade-range for 3D buildings and model-cutoff-fade-range for tree models.
  • Fixed fill-extrusion-base to ensure it is never below 0.

June 5, 2024​

  • Style improvements for transit label text and icon spacing, industrial land use color, building height fallback values, and landmark wall brightness.
  • Added skateparks
  • Added zoom based wind turbine blade rotation
  • Set a new low zoom default map location

January 24, 2024​

  • Fixed bugs for golf holes label layer styling issue, turning feature outline layer order and improved tunnel styling
Additional Developer Resources