Toll Cost Extension API Developer's Guide

Input Interface

Resource URI

/calculateroute

Resource Parameters

Parameter Type Description
app_id String

Typically, but not guaranteed to be, 20 bytes Base64 URL-safe encoded string used for the authentication of the client application. See Acquiring Credentials.

app_code String

Typically, but not guaranteed to be, 20 bytes Base64 URL-safe encoded string used for the authentication of the client application. See Acquiring Credentials.

vspec (deprecated) or tollVehicleType, trailerType, trailersCount, vehicleNumberAxles, trailerNumberAxles, hybrid, emissionType, height, trailerHeight, vehicleWeight, limitedWeight, disabledEquipped, minimalPollution, hov, passengersCount, tiresCount, commercial, shippedHazardousGoods, heightAbove1stAxle String Semi-column separated string containing all the vehicle specifications (deprecated) or list of parameters that specify the vehicle. See detailed description of these parameters.
departure String Start date/time of the route - local wall clock time at start point. See detailed description of this parameter. Replaces the deprecated parameter start_ts.
cost_optimize Integer Select optimization mode. 0: No optimization. Simply calculate route and add costs. Default if neither driver_cost nor vehicle_cost provided. 1: Compute alternative routes and select the one with the lowest overall cost. Default if driver_cost or vehicle_cost provided. 2: Like 1, but consider more fine grained alternatives. This takes longer time, but might find an overall cheaper route by using a part of the toll sections.
driver_cost Float Cost per hour of driving. If driver_cost and/or vehicle_cost is specified, then a cost optimized route is computed. Otherwise the requested route is computed and toll cost is added to the result.
vehicle_cost Float Usage cost of the vehicle per kilometer driven. If driver_cost and/or vehicle_cost is specified, then a cost optimized route is computed. Otherwise the requested route is computed and toll cost is added to the result.
currency String 3 characters (ISO 4217) currency code in which the costs will be given. See here for more details.
alternatives Integer Specifies the maximum number of route alternatives to be returned. Default is 0, meaning only one route, no alternatives.
detail number Set detail to 1 to get the same detailed toll cost information as tollcost.json returns.
* *

HERE Routing API parameters, at least the mandatory ones to make a valid request to the router. HERE Routing API documentation is available here. If a cost optimized route is requested (i.e. driver_cost and/or vehicle_cost is specified), then some Routing API parameters will be ignored, e.g. shortest/fastest.