GuidesAPI Reference
Guides

API changes

API Version 8.46.0

  • Deprecated avoid[features]=difficultTurns.

API Version 8.45.0

  • Added vehicle[commercial] parameter.

API Version 8.44.0

  • Added ev[airDensity] parameter.

API Version 8.43.0

  • Added support for calculating consumptions in matrixAttributes. Supports consumption calculation of Electric Vehicles (EV). Added parameters in vehicle to support consumption calculation.

API Version 8.42.1

  • restriction type in violationMapping must specify at least one of the concrete restrictions (for example, grossWeight, currentWeight or

height) with a value of either include or ignore.

API Version 8.42.0

  • Added vehicle[tiresCount] parameter

API Version 8.41.0

  • Added vehicle[emptyWeight] parameter.

API Version 8.40.0

  • Added arrivalTime for N x 1 matrix (multiple origins, single destination) calculation in flexible mode.

API Version 8.39.0

  • Renamed speedCapPerFrc to speedCapPerFc in vehicle options, and renamed the property frc to fc.

API Version 8.38.0

  • Added speedCapPerFrc in vehicle options.

API Version 8.37.0

  • Added new violation mapping type avoidAreasAndSegments.

API Version 8.36.7

  • Requests that time out due to their complexity cause a code E601505 error.

API Version 8.36.6

  • API specification updated to ensure compliance with HERE API Standards.

API Version 8.36.5

  • Remove MatrixResponse.error. The field was only returned from the legacy /v1 endpoint, which is no longer supported.

API Version 8.36.4

  • Clarify 429 error code description.

API Version 8.36.3

  • Clarification for avoid[zoneCategories] and avoid[zoneIdentifiers] added.

API Version 8.36.2

  • "Alpha" label removed from the transportMode=taxi mode and taxi[*] parameter.

API Version 8.36.1

  • Clarify default behavior vehicle[occupancy] parameter.

API Version 8.36.0

  • Enabled vehicle[trailerCount] for car transport mode.

API Version 8.35.1

  • Updated maximum limit of vehicle[currentWeight] for car and taxi transport modes.

API Version 8.35.0

  • Added pedestrian[speed] parameter.

API Version 8.34.0

  • Added exclude[areas] parameter.

API Version 8.33.0

  • Added exclude feature exclude states.

API Version 8.32.1

  • Added avoid feature seasonalClosure.

API Version 8.32.1

  • Increased the max number of penalized segments to 1000.

API Version 8.32.0

  • Beta: Added vehicle parameters support for transport modes car and taxi.

API Version 8.31.1

  • Combined usage of incompatible parameters radiusPenalty and snapRadius will cause an error with error code E601247.
  • Range for radiusPenalty increased to [0..10000]. Conditions apply. Unsupported values for the parameter cause an error with error code E601246.

API Version 8.31.0

  • Added quad and quint axle group configurations.

API Version 8.30.0

  • Added vehicle[licensePlate]and avoid[tollTransponders] parameters.

API Version 8.29.1

  • Update description for error code E601504. Remove unused timeout error codes E601502 and E601503.

API Version 8.29.0

  • Added new error code E601504 for router validation error message.

API Version 8.28.0

  • Added vehicle[currentWeight] parameter

API Version 8.27.0

  • Added vehicle[payloadCapacity] parameter

API Version 8.26.0

  • Added allow[hov] parameter
  • Added allow[hot] parameter
  • Added onRoadThreshold and segmentIdHint waypoint parameters.

API Version 8.25.1

  • Empty nameHint waypoint parameters are ignored

API Version 8.25.0

  • Added traffic[mode] parameter

API Version 8.24.0

  • Added new vehicle parameter kpraLength as "vehicle": { "kpraLength" : $Value }

API Version 8.23.0

  • Alpha: added new vehicle parameter engineSizeCc as "vehicle": { "engineSizeCc" : $Value }
  • Alpha: added new vehicle parameter occupancy as "vehicle": { "occupancy" : $Value }

API Version 8.21.1

  • Added new supported shape format encodedPolygon to avoid[areas] parameter

API Version 8.21.0

  • Added new supported shape format polygon to avoid[areas] parameter

API Version 8.20.0

  • Allowed avoid feature uTurns for transport modes car, taxi, and bus in addition to truck. It remains forbidden for pedestrian, bicycle, and scooter.

API Version 8.19.0

  • Added snapRadius parameter to waypoint places

API Version 8.18.0

  • Added speedCap as "vehicle": { "speedCap" : $Value }

API Version 8.16.1

  • Added 250 items limit for avoid[areas] parameter.

API Version 8.14.0

  • Added avoid features difficultTurns and uTurns.

API Version 8.13.0

  • Added avoid[zoneCategories] option.

API Version 8.12.0

  • Added avoid[carShuttleTrain].

API Version 8.11.0

  • Added avoid[zoneIdentifiers] and avoid[truckRoadTypes] options.

API Version 8.10.0

  • Added exclude[countries].

API Version 8.9.2

  • Added allowDriveThroughTaxiRoads in taxi options.

API Version 8.9.1

  • Added weightPerAxleGroup in truck options.

API Version 8.9.0

  • Added maxRadius parameter to the autoCircle region definition option.

API Version 8.8.0

  • Added radius, nameHint and minCourseDistance waypoint parameters.

API Version 8.7.0

  • Added truck category (lightTruck versus default)

API Version 8.6.0

  • Added scooter mode support

API Version 8.5.0

  • Increased matrix size limit for Profile mode sync requests. Now also allowing matrix sizes up to 1 x 2000 or 2000 x 1. (Previous limit allowed matrix sizes up to 500 x 500.)

API Version 8.4.0

  • Added (Alpha) taxi mode support

API Version 8.3.0

  • Increased matrix size limit for Flexible mode sync requests. Now allowing matrix sizes up to 15 x 100 or 100 x 1. (Previous limit allowed matrix sizes up to 15 x 15, 1 x 100, or 100 x 1.)

API Version 8.2.0

  • Added new truck options type, axleCount and trailerCount.

API Version 8.1.0

  • Added bicycle mode support