Route API Overview
The Route API provides fast, accurate turn-by-turn directions between multiple waypoints. Built for high-performance applications, it delivers sub-50ms response times with detailed geometry data for map visualization.Key Features
🚗 Turn-by-Turn Directions
Generate detailed navigation instructions with:- Precise geometry in GeoJSON format for map rendering
- Step-by-step instructions with maneuver details
- Distance and duration calculations for each route segment
- Multi-waypoint support for complex routing scenarios
⚡ Batch Processing
Process multiple route requests efficiently:- Single API call for multiple route calculations
- Reduced network overhead and improved performance
- Concurrent processing with optimized resource usage
🌍 Multi-Engine Support
Choose from multiple routing map data:- OpenStreetMap — open data, traffic-unaware
- TomTom — predictive traffic via historical patterns. Pair with
departureTimeto get an estimate for any future moment. - TomTom real-time — live traffic conditions on the road right now. Set
"engine": "TOMTOM_REAL_TIME";departureTimeis ignored.
Real-Time Traffic
Set"engine": "TOMTOM_REAL_TIME" on POST /route to compute a route that reflects current traffic. The request always uses now as the departure time — any client-supplied departureTime is ignored.
Live traffic is combined with TomTom historical traffic patterns by default: patterns improve estimates outside peak hours and cover road segments without live traffic data. To compute against live traffic only, set "includeTrafficPatterns": false.
POST /route/batch. Use the standard TOMTOM engine with predictive traffic for batch scenarios.
Available Endpoints
POST /route
Calculate a single route between 2 or more coordinates with full turn-by-turn directions
POST /route/batch
Process multiple route requests efficiently in a single API call