HERE route (car/truck/bike/pedestrian, HGV profile)
here_routeCalculate HGV-aware routes honoring height, width, weight, and axle limits, with traffic-aware timing, multiple transport modes, and UK toll data.
Instructions
Calculate a route with HERE Routing v8. Supports transportMode car | truck | pedestrian | bicycle | scooter. HGV routing: set transportMode="truck" and pass "truck" — e.g. {"heightM":4.2,"widthM":2.55,"lengthM":16.5,"grossWeightKg":44000,"weightPerAxleKg":11500,"axleCount":6,"trailerCount":1} — to honour height/width/weight/axle/hazmat/tunnel restrictions. Dimensions are metres and weights kg; they are converted to HERE vehicle[height] centimetres etc. Origin/destination/via accept either "lat,lng" or a free-text address (auto-geocoded, UK focus). departureTime or arrivalTime (RFC 3339 WITH offset, e.g. "2026-11-03T08:30:00+00:00") makes the route traffic-aware; without it the route is traffic-free (baseDuration == duration). By default returns a compact summary only (distance, duration, traffic delay, legs, critical notices). Opt in to polyline, turn-by-turn instructions, spans and tolls with the include* flags — polylines are large. UK defaults: units=metric, lang=en-GB, currency=GBP.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"origin": "<origin>",
"destination": "<destination>"
},
"name": "here_route"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| via | No | Up to 10 intermediate waypoints ("lat,lng" or addresses), visited in order. | |
| lang | No | BCP-47 instruction language, default en-GB. | |
| avoid | No | Road/area avoidance options. | |
| truck | No | HGV profile. Only used when transportMode is "truck". | |
| units | No | Instruction units (default metric). | metric |
| origin | Yes | Start point: "lat,lng" (e.g. "53.4808,-2.2426") or an address (auto-geocoded, UK focus). | |
| traffic | No | Use live/typical traffic (default true). Set false for a traffic-free baseline. | |
| currency | No | ISO 4217 currency for toll costs, default GBP. | |
| spansMax | No | Maximum spans to return when includeSpans=true (default 200). | |
| billingTag | No | Optional HERE billing tag for cost allocation. | |
| arrivalTime | No | Desired arrival time, RFC 3339 with offset. Cannot be combined with departureTime. | |
| destination | Yes | End point: "lat,lng" or an address. | |
| routingMode | No | Optimise for fastest (default) or shortest route. | fast |
| alternatives | No | Number of alternative routes to return in addition to the best one (0-6). | |
| emissionType | No | Toll emission class (sent as tolls[emissionType]). Only meaningful together with includeTolls=true. | |
| includeSpans | No | Include route spans (speed limits, road names, functional class). | |
| includeTolls | No | Include toll costs for this route (UK HGV Levy, M6 Toll, etc.). | |
| departureTime | No | Departure time, RFC 3339 with offset, e.g. "2026-11-03T08:30:00+00:00". Makes the route traffic-aware. Cannot be combined with arrivalTime. | |
| transportMode | No | Travel mode (default car). Use "truck" for HGV routing with the truck profile. | car |
| includePolyline | No | Include the HERE Flexible Polyline per leg (encoded). Large — opt in. | |
| returnAttributes | No | Advanced: extra HERE "return" attributes to request verbatim (e.g. ["routeLabels","typicalDuration"]). | |
| includeTurnByTurn | No | Include HERE turn-by-turn action objects (advanced). | |
| includeInstructions | No | Include manoeuvre actions/instructions with offsets. | |
| includePolylinePoints | No | Also decode the polyline into [lat,lng] points (requires includePolyline). |