Maps Directions API — IteraTools

About this tool

Calculate routes and directions between two geographic coordinates using OSRM (Open Source Routing Machine), one of the fastest open-source routing engines. Supports driving, walking, and cycling modes. Returns distance in km, duration in minutes, turn-by-turn step instructions, and full GeoJSON geometry for map rendering.

Quick Start

curl "https://api.iteratools.com/maps/directions?from_lat=48.8566&from_lng=2.3522&to_lat=48.8738&to_lng=2.2950&mode=walking" \
  -H "Authorization: Bearer YOUR_KEY"

Parameters

Param	Type	Required	Description
`from_lat`	number	required	Origin latitude
`from_lng`	number	required	Origin longitude
`to_lat`	number	required	Destination latitude
`to_lng`	number	required	Destination longitude
`mode`	string	optional	`driving` (default), `walking`, or `cycling`

Example Response

{
  "ok": true,
  "data": {
    "from": { "lat": -27.5969, "lng": -48.5495 },
    "to":   { "lat": -27.5910, "lng": -48.5452 },
    "mode": "driving",
    "distance_m": 1302,
    "distance_km": "1.30",
    "duration_s": 147,
    "duration_min": 2,
    "steps": [
      { "instruction": "depart", "name": "Rua Felipe Schmidt", "distance_m": 320, "duration_s": 38 },
      { "instruction": "turn right", "name": "Avenida Mauro Ramos", "distance_m": 680, "duration_s": 82 },
      { "instruction": "arrive", "name": "", "distance_m": 0, "duration_s": 0 }
    ],
    "geometry": { "type": "LineString", "coordinates": [[...]] }
  }
}

Use Cases

AI travel assistants that calculate routes between hotels and attractions
Delivery apps computing driving time and distance to customers
Fitness apps planning cycling or walking routes
Logistics systems optimizing multi-stop delivery routes
Chatbots answering "how far is X from Y and how long to drive?"
Map rendering using the GeoJSON geometry output

Pricing

$0.002 per request via x402 micropayment on Base (USDC). No subscription. No minimum.