Skip to main content

Documentation Index

Fetch the complete documentation index at: https://maps.solvice.io/llms.txt

Use this file to discover all available pages before exploring further.

​
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 departureTime to get an estimate for any future moment.
  • TomTom real-time — live traffic conditions on the road right now. Set "engine": "TOMTOM_REAL_TIME"; departureTime is ignored.
Contact sales@solvice.io for commercial TomTom access.

​
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. 
{
  "coordinates": [
    [4.3517, 50.8503],
    [2.3522, 48.8566]
  ],
  "engine": "TOMTOM_REAL_TIME"
}
Real-time traffic is not supported on 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

​
Quick Start

​
Basic Route Request

{
  "coordinates": [
    [4.3517, 50.8503],  // Brussels
    [2.3522, 48.8566]   // Paris
  ]
}

​
Response Structure

{
  "routes": [{
    "distance": 264100,    // meters
    "duration": 8790,      // seconds
    "legs": [...],         // detailed route segments
    "weight": 8790
  }]
}