Build on the routing API that re-routes live.
Routing, re-routing, matrices, multi-stop optimisation, geocoding, and live asset tracking, one thin API. Embed our map UI or bring your own tiles. Measured traffic reroute workload: 302× faster checks, ~80% smaller route changes. Enter your email and get a key in seconds.
Get your API key
Why trust a key from a small company? Two things you can check yourself: the founder holds first place of about 250 000 entrants for computational efficiency on the public GIMPS registry at mersenne.org, and the service behind this API runs from one small server, the same engine we run our own business on.
Your key
Send it as the X-API-Key header.
Trial (7 days): 25 000 routes/month, 2 requests/second. During the open beta the API is rate-limited and you can try it without a key; we may require a key at any time, and production use requires one.
curl -s https://route.elara-cortex.com/v1/route \
-H "Content-Type: application/json" \
-H "X-API-Key: YOUR_KEY" \
-d '{"from":[-26.1076,28.0567],"to":[-26.2041,28.0473]}'
✓Account created, here's your key
Optional: add your mobile
Get an SMS before you hit your monthly limit, and open the priority low-latency lane in the mobile app. We will never market to you.
Endpoints
| Method | Path | What it does |
|---|---|---|
| POST | /v1/route | A→B road route: distance, turn-by-turn steps, geometry, alternatives, live ETA & incidents. ELRT-API-ROAD |
| POST | /v1/drone/route | Drone Routing API. Air routing, follows drone corridors where they exist, else flies direct; bounded by range and no-fly zones. ELRT-API-DRONE |
| POST | /v1/maritime/route | Maritime Routing API. Sea routing between coastal/offshore points a road route cannot reach. ELRT-API-MARINE |
| POST | /v1/av/route | Self-Driving (AV) Routing API. Preview-only road geometry, restricted to mapped and permitted autonomous operational design domains. Outside the current ODD it returns 422 instead of engaging. ELRT-API-AV |
| POST | /v1/reroute | Small updates. When traffic or a stop changes, we send only what changed, typically a compact delta (MEASURED ~80% smaller payload on change in bench_pack_results.json; cold path may call upstream routing). |
| POST | /v1/matrix | Distance/time matrix between many points (dispatch, clustering). |
| POST | /v1/optimize | Best multi-stop order (single or multi-vehicle), fleet routing. |
| GET | /v1/geocode?q= | Address → coordinates (global, local-first cache). |
| GET | /v1/reverse?lat=&lon= | Coordinates → address. |
| GET | /v1/nearby?lat=&lon=&category= | Nearby fuel, food, parking, charging, hospitals… |
| GET | /v1/account/usage | Your plan, quota and usage (send your key). |
| POST | /v1/assets | Register an asset (drone, vehicle, robot). Category military available for gov/defence accounts. |
| GET | /v1/assets | List your assets and live-tracking limits for your subscription. |
| POST | /v1/assets/{id}/route | Plan and attach a route to that asset (same engine as /v1/route). |
| POST | /v1/assets/{id}/position | Ingest live GPS, optional battery_pct, heading. |
| GET | /v1/assets/{id}/live | Live position vs planned route. X-Elara-Live-Channel: web|api, poll rate capped by plan. |
Live tracking tiers (beta)
| Plan | Web polls/s | API live polls/s | GPS push/s | Max assets |
|---|---|---|---|---|
| trial | 0.2 | - | - | 5 |
| starter | 1 | 0.5 | 0.5 | 30 |
| pro | 2 | 2 | 2 | 500 |
| aviation | 2 | 10 | 10 | 200 |
| military | 2 | 10 | 10 | 200 |
Aviation & military: 10 Hz API live feed and 10 Hz GPS ingest on dedicated/VPS deploys.
Issue keys: python auth.py create aviation or military (not self-serve signup).
Watch assets on the live tracking page after you sign in, same API key. Enterprise / aviation / military: book a briefing (10 Hz live track on dedicated host).
Errors, SLA and support
| Code | Meaning | What to do |
|---|---|---|
| 400/422 | Request cannot be routed as sent: missing fields, non-numeric coordinates, out-of-range coordinates, null island, or outside the AV ODD. | Fix the request; do not retry unchanged. |
| 401/403 | API key missing, expired or not allowed for the endpoint. | Create a key at /register or contact support. |
| 429 | Rate limit hit. Trial/beta anonymous traffic has a burst allowance; production keys are metered by plan. | Back off using Retry-After, or use an API key. |
| 502/503 | Temporary upstream or capacity edge. | Retry after the indicated delay; persistent cases are treated as support issues. |
Support: email hello@elara-cortex.com with the endpoint, timestamp, request shape and response code. SLA: public beta is best-effort; paid enterprise/dedicated deployments get written availability and response terms in the service order. OpenAPI: /openapi.json.
Example, optimise a delivery run
POST /v1/optimize
{ "stops": [[-26.10,28.05],[-26.20,28.04],[-26.15,28.10],[-26.08,28.02]], "vehicles": 1 }
→ { "order": [0,3,1,2], "distance_km": 41.2, "solve_ms": 0.6 }
Built for these
Couriers & last-mile
Uber, Amazon-scale or indie, /optimize + tiny /reroute on traffic.
Motorcycle & moped
Battery + LTE + on-route: push GPS, poll live vs plan (Pro up to 2/s).
Fleets & logistics
/matrix + live /v1/assets, stay on corridor globally.
Drones
Small packets on patchy links; /track for ops vs plan.
Hobby & indie devs
Embed our map, skip building a full mapping layer.
Autonomy R&D
High-fidelity distances + fast traffic reroute, kernel only, not homologation.