Routing & Directions API
Point-to-point directions, isochrones, distance matrices, and turn-by-turn steps
How it works
Set origin and destination
Pass GeoJSON points. Geocode addresses first with /geocode.
Plaza routes it
Car, truck, motorcycle, scooter, bicycle, walking or transit.
Get directions
Turn-by-turn steps in 22 languages, distance, duration, and geometry.
See it in action
An example request and its response, drawn on the map.
Who uses this
Teams building with Routing & Directions API.
Fleet management
Route delivery vehicles with departure-time ETAs and road exclusions.
Fitness apps
Generate cycling and running routes with elevation profiles.
Ride-hailing
Calculate ETAs and fare estimates with departure-time routing.
7
Travel modes
22
Instruction languages
25
Waypoints per route
9
Endpoints
What you can build
Example apps powered by Routing & Directions API.
Delivery Tracker
Live ETAs and route visualization for package delivery.
Trip Planner
Multi-stop itinerary with optimized order and directions.
Ride Estimator
Fare and ETA calculator for ride-hailing apps.
Start building
curl -X POST "https://plaza.fyi/api/v1/route" \
-H "X-API-Key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"alternatives": 2,
"destination": {
"coordinates": [
-73.9855,
40.758
],
"type": "Point"
},
"origin": {
"coordinates": [
-74.006,
40.7128
],
"type": "Point"
},
"steps": true
}'
View endpoints
| Method | Path | Description |
|---|---|---|
| POST | /api/v1/route | Directions with waypoints, alternatives, steps, exclusions, and EV routing |
| POST | /api/v1/isochrone | Multi-contour travel time polygons with denoise and generalize |
| POST | /api/v1/matrix | Distance/duration matrix with fallback speed and annotation options |
| POST | /api/v1/elevation | Elevation for a point, or up to 50 points at once |
| POST | /api/v1/elevation/profile | Elevation profile along a path with ascent/descent |
| POST | /api/v1/map-match | Snap a GPS trace to the road network |
| POST | /api/v1/optimize | Best visiting order for 2 to 50 stops, with optional time windows and capacity |
| GET | /api/v1/optimize/:job_id | Poll async optimization job status |
| POST | /api/v1/nearest | Snap a coordinate to the nearest road |
How it compares
Common questions
What road exclusions are available?
Toll roads, ferries, unpaved roads, motorways, and trunk, primary, secondary or tertiary roads. Combine several in one request with the exclude parameter.
How many waypoints can I include?
Up to 25 per request. Each point can take a heading and a curb-side approach. Without waypoints, the API can also return up to 3 alternative routes.