Skip to content
geolith

Routing · Route API · In development

Route API: Valhalla-compatible /route

/route takes Valhalla’s request body and returns Valhalla’s trip object, so a client written for Valhalla needs a new base URL. On Berlin the responses were byte-identical to Valhalla 3.9.1 on 100/100 auto, 30/30 pedestrian, 30/30 bicycle routes, on tiles geolith built.

Status · In development

In development, not deployed: there is no routing endpoint to call yet, on geolith.app or api.geolith.app, and no routing plan, price or key.

Read the routing docsSee status and roadmap

Berlin · same data, same requests

Against the reference engine

Measured on geolith/routing main. Only sets that were run are shown; no speed or cost is measured.

Route · /route · Berlin, byte-identical to Valhalla 3.9.1
SetRequests Byte-identical
Auto100100/100
Pedestrian3030/30
Bicycle3030/30

Detail

Request

A POST to /route with a JSON body, as Valhalla documents it. ROUTER_HOST stands for a router you run; there is no hosted one.

locations: two or more points with lat and lon; more than two make a multi-leg trip.
costing: auto, pedestrian or bicycle.
date_time: optional; with it, the router uses historical and live speeds (see Traffic and live data).
units: kilometers (default) or miles.
Request shape (no hosted endpoint)
curl -X POST "https://ROUTER_HOST/route" \
  -H "Content-Type: application/json" \
  -d '{
    "locations": [
      { "lat": 52.5163, "lon": 13.3777 },
      { "lat": 52.5079, "lon": 13.3376 }
    ],
    "costing": "auto",
    "units": "kilometers"
  }'

Detail

Response

A Valhalla trip object: length and time in total and per leg, the shape as an encoded polyline with precision 6, and maneuvers with English instructions. Spoken (verbal_*) instructions are in progress.

Detail

Errors

Errors use Valhalla’s error body (error_code, error, status_code, status) with the HTTP status of the same number.

Questions

Route API: questions

Routing · In development

More on routing

Routing overviewA Valhalla-compatible router that answers from a .glx file.Matrix/sources-to-targets: times and distances between many points.Isochrones/isochrone: the area reachable within a time or a distance.Map matching/trace-route and /trace-attributes: GPS traces snapped to roads.Traffic & live dataHistorical speeds in the file; live speeds and closures from you.Self-hostingOne .glx file, in a Worker on R2 or next to a local file.AccuracyByte-identical to Valhalla 3.9.1 on every measured Berlin request.Routing guidesBuild a routing .glx, self-host the router, migrate a Valhalla client.

Sources

  1. Routing API (planned), geolith docs (read 2026-11-08)
  2. Valhalla turn-by-turn API reference, Valhalla (open source, MIT) (read 2026-11-08)

Routing · In development

Follow routing progress.

Read how the router works today and what has to pass before it is deployed.

Read the routing docsSee status and roadmap