Skip to main content

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, this is beta documentation and is not accessible from the Navigation landing page.

Directions API

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

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

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

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

January 19, 2021

  • Added an optional parameter to the Directions API for use with the mapbox/driving-traffic profile: snapping_include_closures.

January 8, 2021

December 3, 2020

November 30, 2020

  • Documented the speedLimitSign and speedLimitUnit properties in the Directions API route step object.

October 30, 2020

  • Added continuous lane guidance documentation for the Directions API.

October 1, 2020

  • Added documentation for several new intersection-related properties returned by the Directions API.

August 10, 2020

  • Added two optional parameters to the Directions API for use with the mapbox/driving profile: arrive_by and depart_at.

February 7, 2019

February 1, 2019

  • Document the waypoints parameter on the Directions API.

January 25, 2019

August 24, 2018

  • The Directions API now supports Burmese, Finnish, Korean, and Norwegian (Bokmål) for turn-by-turn instructions.

April 18, 2018

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

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.