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: 244× faster checks, ~80% smaller route changes. Enter your email and get a key in seconds.
Send it as the X-API-Key header.
Free tier: 100 000 routes/month, 5 requests/second. Keys are off by default during beta — you can call the API
right now even without one.
curl -s https://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]}'
Get an SMS before you hit your monthly limit, and unlock the priority low-latency lane in the mobile app. We will never market to you.
| Method | Path | What it does |
|---|---|---|
| POST | /v1/route | A→B route: distance, turn-by-turn steps, geometry, alternatives, live ETA & incidents. |
| 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. |
| Plan | Web polls/s | API live polls/s | GPS push/s | Max assets |
|---|---|---|---|---|
| free | 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).
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 }
Uber, Amazon-scale or indie — /optimize + tiny /reroute on traffic.
Battery + LTE + on-route: push GPS, poll live vs plan (Pro up to 2/s).
/matrix + live /v1/assets — stay on corridor globally.
Small packets on patchy links; /track for ops vs plan.
Embed our map — skip building a full mapping layer.
High-fidelity distances + fast traffic reroute — kernel only, not homologation.