> ## 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.

# Introduction

> High-performance routing API for turn-by-turn directions and batch route calculations

# 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](mailto: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.

```json theme={null}
{
  "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

<CardGroup cols={2}>
  <Card title="POST /route" icon="route" href="/route/post-route">
    Calculate a single route between 2 or more coordinates with full turn-by-turn directions
  </Card>

  <Card title="POST /route/batch" icon="list" href="/route/post-route-batch">
    Process multiple route requests efficiently in a single API call
  </Card>
</CardGroup>

## Quick Start

### Basic Route Request

```json theme={null}
{
  "coordinates": [
    [4.3517, 50.8503],  // Brussels
    [2.3522, 48.8566]   // Paris
  ]
}
```

### Response Structure

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