Toll Cost Extension API Developer's Guide

Toll Costs of a Pre-Calculated Route

User Story

The user wants to retrieve the toll costs for a route driven previously by a truck without a trailer.

Request

The parameter tollVehicleType defines the type of vehicle, as do the remaining vehicle specification parameters. The parameter route defines the route driven by the truck previously.

https://tce.cit.api.here.com/2/tollcost.json
?app_id={YOUR_APP_ID}
&app_code={YOUR_APP_CODE}
&tollVehicleType=3
&vehicleNumberAxles=2
&emissionType=6
&height=3.5m
&vehicleWeight=10.0t
&limitedWeight=10.0t
&passengersCount=1
&tiresCount=8
&route=748873330,50;68614309,40;17357322,30;748938713,20;76719821,10;17357323,0
&detail=1

Response

The response to the request contains the following information blocks:
  • the route links
  • the toll cost details of the route
  • the toll system information
{
  errors:[],
  warnings:[],
  routeTollItems: [
    {
      linkIds: [748873330,68614309],
      tollType: "p",
      country: "FRA",
      tollSystem: [
        {
          id: 5016,
          name: "APRR",
          languageCode: "ENG"
        }
      ]
    },
    {
      linkIds: [748938713],
      tollType: "p",
      country: "FRA",
      tollSystem: [
        {
          id: 5016,
          name: "APRR",
          languageCode: "ENG"
        }
      ]
    },
    {
      linkIds: [76719821],
      tollType: "S",
      country: "FRA",
      tollSystem: [
        {
          id: 5016,
          name: "APRR",
          languageCode: "ENG"
        }
      ],
      tollStructures: [
        {
          name: "LE TOURNEAU",
          languageCode: "FRE",
          latitude: 47.9931,
          longitude: 2.67762,
          linkIds: [748938713,76719821],
          conditionId: 703489345
        }
      ],
      tollCostAlternatives: [
        {
          amount: 3.3,
          currency: "EUR",
          amountInTargetCurrency: 3.3,
          methodOfPayment: 151,
          daylightHours: 2,
          discountAvailable: 0,
          vehicleSpecification: {
            trailerType: "ANY",
            emissionType: "ANY",
            tollVehicleType: "ALL VEHICLES",
            heightMax: 200,
            vehicleWeightMax: 3500,
            shippedHazardousGoods: "NONE"
          }
        }
      ]
    }
  ],
  onError:false
}