Directions API
Multi-waypoint turn-by-turn navigation with bearing, alternatives, and exclusions
Turn-by-turn navigation with multi-waypoint support and road exclusions.
How it works
Set your waypoints
Origin, destination, and up to 25 via points.
Plaza calculates directions
Auto, bicycle, and pedestrian profiles with bearing and exclusion support.
Get step-by-step
Maneuver type, street name, distance, and instruction.
See it in action
A real API request, visualized.
Who uses this
Teams building with Directions API.
Navigation apps
Power in-app turn-by-turn navigation experiences.
Trip planning
Show route previews with multiple stops and alternatives.
Dispatch systems
Generate driver instructions with bearing constraints.
Start building
curl -X POST "https://plaza.fyi/api/v1/route" \
-H "Content-Type: application/json" \
-d '{
"origin": {"lat": 38.9, "lng": -77.03},
"destination": {"lat": 38.88, "lng": -77.01},
"steps": true
}'
View endpoints
| Method | Path | Description |
|---|---|---|
| POST | /api/v1/route | Calculate directions between two or more waypoints with turn-by-turn steps |
| GET | /api/v1/nearest | Snap a coordinate to the nearest road segment |
How it compares
Common questions
What's included in turn-by-turn steps?
Each step includes maneuver type (turn left, continue straight, etc.), bearing before and after, distance, duration, street name, and a human-readable instruction string.
How many alternative routes can I request?
Up to 3 alternatives. The API returns the optimal route plus alternatives ranked by duration, each with full geometry and step-by-step instructions.