WayMatrixWayMatrix
WayMatrix
  • Getting started
  • API reference
  • Your API keys
  • Your usage
  • Billing
  • Back to waymatrix.io
Information
Matrix
    Travel-time and distance matrixpostTravel-time and distance matrix (explicit JSON form)post
Directions
    Route between two pointsgetRoute with full optionspostRoute, JSON formpostRoute, GeoJSON formpostRoute, GPX formpost
Isochrones
    Reachability polygonspostReachability polygons (explicit GeoJSON form)post
Service
    LivenessgetLiveness, headers onlyheadEngine and graph provenancegetEngine and graph provenance, headers onlyhead
Schemas
powered by Zuplo
WayMatrix Routing API

WayMatrix Routing API

Travel-time matrices, routes and isochrones, compatible with the Openrouteservice API.

A drop-in replacement for Openrouteservice's public API, for three endpoint families: matrix, directions and isochrones. Point your Openrouteservice client at this base URL, change the key, and it works.

Before you start

Four things decide whether this API fits what you're building:

  • One profile. Every request names a routing profile in its path, such as /v2/matrix/driving-car, and driving-car is the only one served. Any other profile returns an "incorrect value" error; there are no truck, bike or foot profiles.
  • North America only, from OpenStreetMap data, with excellent coverage in cities.
  • No live traffic. Travel times are estimates from the road network, not current conditions.
  • Bring your own coordinates. There is no geocoding endpoint yet. Geocoding is coming soon; until then, send longitude and latitude.

What it costs

You're billed per element rather than per request, and failed calls are never charged.

  • Free — 50,000 elements a month (available now).
  • $29 a month — 1,000,000 elements, which covers most projects (available now).
  • $99 a month — 5,000,000 elements (available now).
  • $299 a month — 20,000,000 elements, for larger deployments (coming soon).

An element is one unit of that work:

  • A matrix costs |sources| × |destinations| elements.
  • Directions cost a flat 10 elements.
  • Isochrones scale with reach: locations × 100 × (largest range ÷ reference)².
Tags
Matrix
Travel-time and distance matrices.
Directions
Point-to-point routes with geometry and turn instructions.
Isochrones
Reachability polygons.
Service
Health checks and data versions. No key needed, and never charged.
Terms of service
ContactWayMatrix support[email protected]
Servers
https://api.waymatrix.io