Search for content

API Changes

This list shows all changes of the API between releases like new features, significant improvements and bug fixes. We recommend that API developers periodically check it for updates.

Version 1.8.1

  • Improvement: A route requested by the 'getRouteId' operation with a cumulated air-line distance exceeding 40000 km is rejected.

Version 1.8.0

  • Feature: Added operation 'getRouteId' returning a 'routeId' that can be used in combination with the Routing API to get more details about the route (e.g. polyline). This operation is in an experimental state and may change at any time.
  • Improvement: The explicit declaration 'nullable' is removed from the OpenAPI specification as it is no longer required for the C# client generation.

Version 1.7.0

  • Feature: Added request parameter 'DIRECT_DISTANCE_FLAGS' to provide the information which relations have been estimated by direct distance.
  • Feature: Added request parameter 'VIOLATION_FLAGS' to provide the information which relations have been calculated using roads, which are prohibited for the selected vehicle.
  • Feature: Added request parameters 'detourFactor' and 'averageSpeed' to customize the calculation of direct distances.

Version 1.6.0

  • Feature: The operations 'calculateMatrix' and 'getMatrix' return compressed responses if requested.
  • Feature: The operations 'startMatrixCalculation' and 'calculateMatrix' support compressed bodies.

Version 1.5.3

  • Feature: Added new vehicle profiles for TLN (Transport en Logistiek Nederland) to the predefined profiles. This is in a preview state.

Version 1.5.2

  • Improvement: The quality of error messages is improved by revising the request validation.

Version 1.5.1

  • Improvement: A 'GENERAL_VALIDATION_ERROR' error is returned when a malformed date and time is set in the request parameters 'startTime' or 'tollTime'.
  • Improvement: When using the request parameters 'startTime' or 'tollTime' without UTC offset, an error code 'ROUTING_UTC_OFFSET_CANNOT_BE_DETERMINED' is returned if the UTC offset cannot be determined solely from the origins.

Version 1.5.0

  • Feature: Added request parameter 'tollTime' to the operation 'startMatrixCalculation' to calculate tolls at the requested time.

Version 1.4.3

  • Bugfix: Improved stability when setting the destinations to null in the request.

Version 1.4.0

  • Feature: Combining the options 'startTime' and 'duration', a multiple time-dependent matrix is calculated. The results are available in the field 'travelTimeProfilesEncoded'.
  • Feature: Using the options 'startTime' and 'trafficMode', a time-dependent matrix is calculated.
  • Feature: Encoded response is available.

Version 1.3.0

  • Feature: When 'roadAccess' is specified but 'includeLastMeters' is false for at least one location, a warning is returned.
  • Feature: Added response parameter 'warnings' to return information on the validity of the result.

Version 1.2.0

  • Feature: New vehicle profiles for region IMEA.

Version 1.1.5

  • Bugfix: Improved stability when requesting toll costs.

Version 1.1.3

  • Improvement: Renamed error codes 'GENERAL_ACCESS_DENIED' to 'GENERAL_UNAUTHENTICATED' and 'GENERAL_UNAUTHORIZED' to 'GENERAL_FORBIDDEN'.

Version 1.1.1

  • Improvement: Time-dependent toll tariffs are considered when requesting the result type 'TOLL_COSTS'.

Version 1.1.0

  • Feature: The toll costs can be calculated in a specified currency by using the result type 'TOLL_COSTS' and the request parameter 'currency'.

Version 1.0.0

  • Feature: Calculation of the distances and travel times between a set of origins and destinations.