Mapbox API Documentation Changelog

↩︎ Back to API Documentation

August 15, 2017

  • Added documentation for the congestion option in the annotations parameter in the Directions API

August 7, 2017

  • Added documentation for the proximity parameter in the Geocoding API
  • Added documentation for the interpolated response field in the Geocoding API

July 28, 2017

  • Added documentation for the classes response field in the Directions API
  • Added documentation for the tidy parameter in the Map Matching API
  • Added documentation for the exits response field in the Directions API

July 7, 2017

  • Added documentation for the response object of the Geocoding 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.

May 15, 2017

  • Added documentation for weight and weight_name properties of Directions API.
  • Added documentation for alternative_count properties of Map Matching API.

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.

April 11, 2017

April 10, 2017

April 4, 2017

March 14, 2017

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

March 10, 2017

  • Added support for ?annotations=speed in the Directions, Map Matching and Optimized Trips APIs.

February 23, 2017

  • Added documentation for the Static API with overlays.

February 21, 2017

January 13, 2017

  • Document Tilesets API

November 7, 2016

  • Document the geocoding limit parameter

November 2, 2016

  • Removed preview label for Datasets API and Tokens API.

October 31, 2016

  • Document poi.landmark value for geocoding types query parameter.

October 28, 2016

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

October 17, 2016

  • Removed documentation for the bulk write endpoint for datasets.

September 30, 2016

  • Add Scopes API
  • Add temporary tokens to Tokens API
  • Indicate Tokens List is paginated

September 22, 2016

  • Adds documentation for the bearings parameter in the Directions API.

September 8, 2016

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

August 15, 2016

  • Link to Directions API Playground interface

August 8, 2016

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

August 3, 2016

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

August 1, 2016

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

July 28, 2016

  • Documents word and length limits of queries to the Geocoding API.

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.

June 16, 2016

  • Updated JS, Python, and CLI geocoding examples to include the {bbox} parameter

June 9, 2016

  • Made it clear that the radius parameter of the Directions API is measured in meters

June 6, 2016

May 22, 2016

May 16, 2016

  • Updated Swift classic Static API example for MapboxStatic.swift v0.6.0.
  • Added Objective-C examples for MapboxGeocoder.swift and MapboxStatic.swift.

May 13, 2016

  • Updated Swift classic Static API example for MapboxStatic.swift v0.5.0.
  • Adds new types off ramp, on ramp and roundabout turn which were added in OSRM v5.1.0.

May 11, 2016

  • Adds documentation for Swift & Java languages using mapbox-java, MapboxDirections.swift, MapboxStatic.swift, and MapboxGeocoder.swift
  • Adds the new {bbox} parameter of the Geocoding API.
  • Updated documentation from Directions API v4 to v5

    • Changed: URL format change:

      • old: /v4/directions/mapbox.driving/{lon,lat};{lon,lat}.json
      • new /directions/v5/mapbox/driving/{lon,lat};{lon,lat}
    • Removed: no more html text instructions, instead it is plain text instructions only. The client may compile text instructions themselves
    • Added: response body has code and message properties to signify errors
    • Added: response body has routes split into several legs
    • Added: response body has legs split into steps, each with a maneuver
    • Added: response body has every step with a geometry
    • Changed: response body has for every step bearing_before and bearing_after instead of only heading
    • Added: response body has every step with a geometry
    • Changed: query parameter geometry was renamed to geometries
    • Changed: by default, return polyline geometries
    • Added: query parameter overview can be full, simplified or false
    • Changed: polyline geometries have a precision of 5 (instead of 6 before)
    • Changed: by default, steps and alternatives are disabled
    • Changed: uturns query parameter was renamed to continue_straight

May 10, 2016

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

May 6, 2016

  • Added a wikidata property to the Geocoding output example.

April 26, 2016

  • Document the maximum length of a period in the Analytics API as 1 year.

April 22, 2016

  • The Reverse Geocoding API documentation said that a reverse geocode returns at most one result per mode. It actually returns at most one result per type.

April 5, 2016

  • Separates Parameters & Options in all documentation sections for consistency
  • Adds new topic section on how to read documentation
  • Reiterates that even with the attribution=false option, attribution is required for static maps that include OpenStreetMap data.

April 4, 2016

  • Adds documentation for the new Analytics API, which is a preview for Premium and Enterprise accounts only.

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 previously written.

March 15, 2016

  • Fixes the {country} parameter of the Geocoding API that was previously documented incorrectly as {cc}
  • Adds the new {autocomplete} parameter of the Geocoding API

March 8, 2016

  • Adds new distance and duration properties to the responses of the Map Matching API

March 4, 2016

  • Made it clear that Link is header required for pagination, not just recommended
  • Increased public Upload limits