> For the complete documentation index, see [llms.txt](https://docs.mapbox.com/api/llms.txt) # Navigation service changelog ## EV Platform API ### February 21, 2024 - Removed token property from the OCPI "StartSession". ### August 29, 2023 - Add examples for Retrieve CDR, Retrieve Session, define Session structure. ### June 6, 2023 - Initial version of the EV Platform API, now beta released as EV Charge Finder API & EV Charge Pay API respectively. This is beta documentation and is hidden in the sidebar navigation. ## Directions API ### May 11, 2026 - Added `toll` subtype to the [notification object](https://docs.mapbox.com/api/navigation/directions/#notification-object). Emitted as an `alert` when a route uses a toll road, and as a `violation` when `exclude=toll` is specified but a toll-free route cannot be found. ### October 9, 2024 - Added a lane attribute to distinguish lanes designated for specific vehicle types. ### February 26, 2024 - Added support for two more ISO 8601 date time formats with specified timezone for `depart_at` and `arrive_by` parameters. ### Aug 23, 2023 - Notes charging curve should span from 0 to max charge, and charge rate assumptions if that requirement is not met ### Aug 18, 2023 - Adds note that 10 is EV's coordinate limit ### June 7, 2023 - Adds 'ev_add_charging_stops' parameter for EV-routing - Adds reference to EV's fallback behavior to standard routing ### June 5, 2023 - Changes SOC definition to note values can be negative ### May 5, 2023 - Adds `chademo` connector-type for EV-routing ### Mar 15, 2023 - Add HTTP 401 response code documentation when invalid tokens are passed ### Oct 31, 2022 - Added documentation for `south`, `west`, `north` and `east` to [incident object](https://docs.mapbox.com/api/navigation/directions/#incident-object). ### Oct 10, 2022 - Added request example for Matrix API `depart_at` parameter. ### Sept 16, 2022 - Publish Optimization v2 API documentation for public beta. ### Sept 1, 2022 - Adds `ev_pre_conditioning_time` and `ev_unconditioned_charging_curve` optional parameters for EV-routing. ### Aug 28, 2022 - Corrects `directions` `intersections.geometry_index` description. ### Aug 3, 2022 - Adds `auxiliary_consumption` optional parameter for EV-routing. ### Jul 14, 2022 - Added documentation for `snapping_include_static_closures` ### May 9, 2022 - Removed incorrect "then" component in banner instruction example. Replaced with "sub" instead. ### May 5, 2022 - Added documentation for `intersections.toll_collection.name` ### April 22, 2022 - Adds `annotations=state_of_charge` for EV-routing. ### April 7, 2022 - For map-matching: added `voice_instructions`, `voice_units`, `language`, `roundabout_exits` and `banner_instructions` flags to the along with explanations for the new content returned. ### April 4, 2022 - Added documentation for `intersections.traffic_signal`, `intersections.stop_sign` and `intersections.yield_sign`. - Added documentation for Electric Vehicle Routing private preview. ### Mar 24, 2022 - Added documentation for `en-SG` - English (Singapore) ### Mar 15, 2022 - Added parameter `max_weight` for the `mapbox/driving` and `mapbox/driving-traffic` profiles. ### Mar 07, 2022 - Added documentation for `affected_road_names` to [incident object](https://docs.mapbox.com/api/navigation/directions/#incident-object). ### Feb 28, 2022 - Added documentation for `intersections.railway_crossing`. ### Feb 16, 2022 - Added documentation for `exclude`-ing specific locations. ### Jan 28, 2022 - Added `depart_at` option for `driving-traffic` profile to the Directions API documentation. ### Dec 21, 2021 - For map-matching:`linear_references` parameter: Removes wording about one reference per edge in road-graph and mentions it is also available on `driving-traffic`. ### November 22, 2021 - Added `via_waypoints` array to the Navigation Route Leg Response object. ### November 3, 2021 - Added `layers` parameter. ### September 27, 2021 - Added `avoid_maneuver_radius` documentation to the Directions API. ### August 31, 2021 - Document increased default coordinate limit for the Directions API on the `mapbox/driving-traffic` profile. - Added `unpaved` to the list of options available with the `exclude` parameter for Directions API requests using the `mapbox/driving` and `mapbox/driving-traffic` routing profiles. ### July 15, 2021 - Added parameters `max_height` and `max_width` for the `mapbox/driving` and `mapbox/driving-traffic` profiles. ### July 6, 2021 - Added new attributes, `iso_3166_1_alpha2` and `iso_3166_1_alpha3`, to the [incident object](https://docs.mapbox.com/api/navigation/directions/#incident-object) ### July 5, 2021 - Added documentation for `intersections.rest_area.name` in the Directions API. ### May 31, 2021 - Added support for `mapbox/driving-traffic` to the Isochrone API - Added support for `contours_meters` to the Isochrone API ### March 22, 2021 - Added documentation for the `congestion_numeric` option in the `annotations` parameter in the Directions API. ### February 23, 2021 - Added `closure` annotations to the Direction API's [route leg object](https://docs.mapbox.com/api/navigation/directions/#route-leg-object). ### January 19, 2021 - Added an optional parameter to the Directions API for use with the `mapbox/driving-traffic` profile: [`snapping_include_closures`](https://docs.mapbox.com/api/navigation/directions/#optional-parameters-for-the-mapboxdriving-traffic-profile). ### January 8, 2021 - Added `incidents` to the Direction API's [route leg object](https://docs.mapbox.com/api/navigation/directions/#route-leg-object). ### December 3, 2020 - Added `active_direction` to the Direction API's [banner instruction object](https://docs.mapbox.com/api/navigation/directions/#banner-instruction-object). ### November 30, 2020 - Documented the `speedLimitSign` and `speedLimitUnit` properties in the Directions API [route step object](https://docs.mapbox.com/api/navigation/directions/#route-step-object). ### October 30, 2020 - Added continuous lane guidance documentation for the [Directions API](https://docs.mapbox.com/api/navigation/directions/#route-step-object). ### October 1, 2020 - Added documentation for several new intersection-related properties returned by the [Directions API](https://docs.mapbox.com/api/navigation/directions/#route-step-object). ### August 10, 2020 - Added two optional parameters to the Directions API for use with the `mapbox/driving` profile: [`arrive_by` and `depart_at`](https://docs.mapbox.com/api/navigation/directions/#optional-parameters-for-the-mapboxdriving-profile). ### February 7, 2019 - Created a shared guide in the [Navigation service introduction](https://docs.mapbox.com/api/navigation/) on making requests using HTTP `POST`, since both [Map Matching](https://docs.mapbox.com/api/navigation/map-matching/) and [Directions](https://docs.mapbox.com/api/navigation/directions/) APIs support this ability now. ### February 1, 2019 - Document the `waypoints` parameter on the Directions API. ### January 25, 2019 - Updated the [Waypoint object](https://docs.mapbox.com/api/navigation/directions/#waypoint-object) (returned by the [Directions](https://docs.mapbox.com/api/navigation/directions/) and [Matrix](https://docs.mapbox.com/api/navigation/matrix/) APIs) to include the optional `distance` parameter. ### August 24, 2018 - The Directions API now supports Burmese, Finnish, Korean, and Norwegian (Bokmål) for turn-by-turn instructions. ### April 18, 2018 - Added examples of using the Map Matching API in Objective-C or Swift using [MapboxDirections.swift](https://github.com/mapbox/mapbox-directions-swift). ### April 13, 2018 - Added European Portuguese to the list of instruction languages available in the Directions API. ### March 2, 2018 - Added `voice_instructions`, `voice_units` and `banner_instructions` flags to the `/directions/v5` endpoint along with explanations for the new content returned. ### February 27, 2018 - Added Danish and Hebrew to the list of instruction languages available in the Directions API. ### November 29, 2017 - Added the `driving_side` step property to the Directions API ### November 14, 2017 - Computing alternative routes in the Directions API is supported on the traffic profile by now. ### September 29, 2017 - Added Brazilian Portuguese, Castilian Spanish, Esperanto, Italian, Polish, Romanian, Turkish, and Ukrainian to the list of instruction languages available in the Directions API. ### August 15, 2017 - Added documentation for the `congestion` option in the `annotations` parameter in the Directions API. ### July 28, 2017 - Added documentation for the `classes` response field in the Directions API. - Added documentation for the `exits` response field in the Directions API. ### May 15, 2017 - Added documentation for `weight` and `weight_name` properties of Directions API. ### March 10, 2017 - Added support for `?annotations=speed` in the Directions API. ### September 22, 2016 - Adds documentation for the `bearings` parameter in the Directions API. ### August 15, 2016 - Link to Directions API Playground interface. ### June 9, 2016 - Updated the `radius` parameter of the Directions API to clarify that it is measured in meters. ### May 11, 2016 - 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` ## Isochrone API ### February 26, 2024 - Add documentation on `depart_at` parameter. ### May 1, 2020 - Added link to the Isochrone API Playground. ### July 19, 2019 - Added error messages for HTTP status code `200` to the Isochrone API. ### June 13, 2019 - Documented error messages for the Isochrone API. ### October 18, 2018 - Updated the returned polygon parameter descriptions for the Isochrone API. ### September 17, 2018 - Added a new section for the [Isochrone API](https://docs.mapbox.com/api/navigation/isochrone/). ## Map Matching API ### February 26, 2024 - Add documentation on `depart_at` parameter. ### Mar 15, 2023 - Add HTTP 401 response code documentation when invalid tokens are passed ### January 5, 2020 - Documented the `ignore=access,oneways,restrictions` query parameter. - Documented the OpenLR `linear_references` query parameter. ### May 23, 2018 - Added HTTP `POST` support for the `/matching/v5` endpoint. ### July 28, 2017 - Added documentation for the `tidy` parameter in the Map Matching API. ### May 15, 2017 - Added documentation for `alternative_count` properties of Map Matching API. ### March 10, 2017 - Added support for `?annotations=speed` in the Map Matching API. ### March 8, 2016 - **Adds** new `distance` and `duration` properties to the responses of the Map Matching API. ## Matrix API ### February 26, 2024 - Added support for two more ISO 8601 date time formats with specified timezone for the `depart_at` parameter. ### Mar 15, 2023 - Add HTTP 401 response code documentation when invalid tokens are passed ### September 23, 2020 - Added the max number of coordination for `mapbox/driving-traffic` profile in Matrix API. ### April 25, 2019 - Fixed rate limits for Matrix API and added Matrix traffic rate limit. ### May 22, 2018 - Added documentation about `annotation=distance` parameter in the Matrix API. ### August 25, 2017 - Add traffic documentation in the Matrix API. ### May 6, 2017 - Renamed Directions Matrix API to Matrix API. ### March 9, 2017 - Added documentation for Directions Matrix API. ## Optimization API ### Mar 15, 2023 - Add HTTP 401 response code documentation when invalid tokens are passed ### January 7, 2020 - Added support for `mapbox/driving-traffic` profile in the Optimization API. ### October 14, 2019 - Added documentation on `NoSegment` error in the Optimization API. ### June 22, 2017 - Added documentation for the `distributions` parameter in the Optimization API. ### June 8, 2017 - Added documentation for the `language` parameter in the Optimization API. ### May 6, 2017 - Renamed Optimized Trips API to Optimization API. ### April 5, 2017 - Moved Optimized Trips API out of preview. ### April 3, 2017 - Added documentation for the `roundtrip`, `source`, and `destination` in the Optimized Trips API. ### March 10, 2017 - Added support for `?annotations=speed` in the Optimized Trips API. ### February 7, 2017 - Added documentation for Optimized Trips API.