Routing & Directions API

Point-to-point directions, isochrones, distance matrices, and turn-by-turn steps

See it in action Get API Key

How it works

1

Set origin and destination

Pass coordinates, an address, or a place name.

2

Plaza routes it

Full OSM road network with auto, bicycle, and pedestrian profiles.

3

Get directions

Turn-by-turn steps, distance, duration, and geometry.

See it in action

A real API request, visualized.

terminal
$

Who uses this

Teams building with Routing & Directions API.

Fleet management

Route delivery vehicles with time-based traffic estimates and road exclusions.

Fitness apps

Generate cycling and running routes with elevation profiles.

Ride-hailing

Calculate ETAs and fare estimates with departure-time routing.

3

Vehicle profiles

Full OSM

Road network

Full OSM

Topology

9

Endpoints

What you can build

Example apps powered by Routing & Directions API.

Delivery Tracker

Live ETAs and route visualization for package delivery.

Routing Map Matching Distance Matrix

Trip Planner

Multi-stop itinerary with optimized order and directions.

Routing Optimization Geocoding

Ride Estimator

Fare and ETA calculator for ride-hailing apps.

Routing Geocoding

Start building

curl -X POST "https://plaza.fyi/api/v1/route" \

  -H "Content-Type: application/json" \

  -d '{

    "origin": {"type":"Point","coordinates":[-74.006,40.7128]},

    "destination": {"type":"Point","coordinates":[-73.9855,40.758]},

    "steps": true,

    "alternatives": 2

  }'
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 lookup for a single coordinate
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 Route optimization (TSP/VRP) for up to 25 stops
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

Google: $5-10/1K requests
Plaza: from $1.50/1K (premium)
Mapbox: $2/1K requests
Plaza: from $1.50/1K (25% cheaper)
Mapbox: Separate APIs for matching, optimization
Plaza: Everything under one roof, one key
OSRM: self-host required
Plaza: managed, no infrastructure to run

Common questions

What road exclusions are available?

Toll roads, ferries, unpaved roads, and motorways. Combine multiple exclusions in a single request via the exclude parameter.

How many waypoints can I include?

Up to 25 per request. Each waypoint can include bearing constraints for approach direction. The API also returns up to 3 alternative routes if requested.

Try it yourself

Open in Playground Read the docs