To price a lane properly you need three answers: how far, what it costs in toll, and what it emits. Those often live in three different systems, and they only agree if each one assumes the same vehicle on the same road.
POST /route/calculate:georeferences answers all three in one response. You send a vehicle and coordinates in driving order. Nothing is saved.
{
"vehicle": { "fuelType": "diesel", "emissionStandard": "euro6" },
"geoReferences": [
{ "type": "latLonPointGeoReference", "lat": 51.9244, "lon": 4.4777 },
{ "type": "latLonPointGeoReference", "lat": 52.3676, "lon": 4.9041 }
]
}What comes back
The route has its distance in metres, driving time in seconds and geometry. Two blocks make it more useful than a plain routing call.
Toll
toll gives the total and currency, split by country, by toll system and by road section. An approximated flag tells you when the figure is an estimate. If the routing engine doesn't price toll, the block is empty rather than zero, so you can tell "no toll" from "unknown".
Emissions
additionalInfo holds tank-to-wheel and well-to-wheel CO2e, plus a report per leg.
How those figures are made matters. With PTV Developer, they are the engine's own ISO 14083 values. With other engines, they are estimates from the distance, fuel type and Euro class. Send vehicle.fuelType, because without it those estimates come back as 0.
Comparing routes
The fastest route is often not the cheapest. POST /route/calculate:alternatives takes the same input and returns candidates side by side, each with a label, its engine, toll total and CO2e. Depending on your routing settings, the variants come from one engine or from several engines calculating the same route.
Which engine answers
Transportial doesn't try to be the only road network you can use. These endpoints use the engine set on your platform: PTV by default, with PTV Developer, HERE, Google and OSRM also supported. You keep one request format and one response format if you change provider later.
For modes beyond road, POST /routing/calculate/route uses our in-house engine, which picks its routing by the vehicle's transport mode: road, rail, inland waterway, sea or air.
Dangerous goods
Set dangerousGoods, and tunnelRestrictionCode for the load's ADR tunnel category, and the engine routes around what the load may not use. You can look up the tunnel code by UN number with our public ADR endpoint.
Try it
See the routing and cost page for the endpoints and limits, or follow the step-by-step guide.
