RouteInfo
Route metadata: type, coordinates, difficulty, surface, and points of interest
The routeInfo object is carried by TRCItems with entity type ROUTE. It describes a geographical path — a walking trail, cycling route, or driving tour — including its coordinates, difficulty, and points of interest along the way.
Overview
{
"routeInfo": {
"type": "route_maker",
"routeType": "cycling",
"distanceInKilometers": 42.5,
"durationInMinutes": 150,
"difficulty": "moderate",
"primarySurface": "paved",
"start": { "city": "Amsterdam", "zipcode": "1012 AB" },
"end": { "city": "Haarlem", "zipcode": "2011 AB" },
"routeCoordinates": [...],
"calculatedCoordinates": [...],
"pois": [...]
}
}Fields
| Field | Type | Description |
|---|---|---|
type | string | Source system: eventConnectors, route_maker, route_iq, odp_routes, other |
routeType | string | driving_traffic, driving, walking, cycling |
distanceInKilometers | number | Total distance |
durationInMinutes | integer | Estimated duration |
difficulty | string | easy, moderate, challenging, difficult, expert |
primarySurface | string | paved, gravel, dirt, sand, grass, cobblestone, boardwalk, rock, snow, water, mixed |
start | Address | Start point address |
end | Address | End point address |
url | string | External URL for the route |
Route vs Calculated Coordinates
Routes have two coordinate arrays:
routeCoordinates— manually defined waypoints that describe the intended path. These are the points the route creator placed to define the route.calculatedCoordinates— a detailed path computed by a mapping service (e.g., snapped to roads, interpolated between waypoints). This is what you would draw on a map.
If both are present, use calculatedCoordinates for map rendering and routeCoordinates for the editorial waypoints.
Points of Interest (POIs)
The pois array lists notable stops along the route. Each POI follows a shape that mirrors the TRCItem pattern — with its own title, description, location, and coordinates. POIs let you highlight things like viewpoints, rest stops, or attractions along the path.
See the API Reference for the full RouteInfo schema.