elara-route 0.1.0

Python SDK for the Elara Route API — road, drone, maritime, AV routing + geocoding + fleet tracking

elara-route — Python SDK

The official Python client for the Elara Route API — road, drone, maritime, AV routing + geocoding + fleet tracking.

No routing logic ships in this package. All algorithms run server-side at route.elara-cortex.com. Your IP stays protected.

Install

pip install elara-route

Or from source:

cd D:\elara_sdk
pip install -e ".[dev]"

Zero runtime dependencies. Pure Python 3.9+ standard library.

Quick start

from elara_route import ElaraClient

client = ElaraClient(api_key="elara_your_key_here")

route = client.route(
    from_=[-26.1076, 28.0567],
    to=[-26.2041, 28.0473],
)
print(f"{route['distance_km']:.1f} km — {route['eta_min']:.0f} min")

Or create an account programmatically:

client = ElaraClient.signup("[e-mail]", "your-secure-password")
route = client.route(from_=[-26.1, 28.0], to=[-26.2, 28.04])

All endpoints

Method	Endpoint	Description
route()	POST /v1/route	A→B road route
reroute()	POST /v1/reroute	Compact reroute delta (~80% smaller payload)
matrix()	POST /v1/matrix	Distance/time matrix
optimize()	POST /v1/optimize	Multi-stop VRP order
drone_route()	POST /v1/drone/route	Drone corridor routing
maritime_route()	POST /v1/maritime/route	Sea routing
av_route()	POST /v1/av/route	Autonomous-vehicle routing
geocode()	GET /v1/geocode	Address → coordinates
reverse()	GET /v1/reverse	Coordinates → address
nearby()	GET /v1/nearby	POIs by category
signup()	POST /v1/account/signup	Create account + API key
usage()	GET /v1/account/usage	Quota and usage
assets_list()	GET /v1/assets	List fleet assets
asset_create()	POST /v1/assets	Register asset
asset_route()	POST /v1/assets/{id}/route	Attach route to asset
asset_position()	POST /v1/assets/{id}/position	Push live GPS
asset_live()	GET /v1/assets/{id}/live	Live position vs plan

Nearby categories (OpenAPI enum)

atm, cafe, charging, checkpoint, food, fuel, hospital, hotel, parking, police, speed_camera

Error handling

from elara_route import ElaraAuthError, ElaraRateLimitError, ElaraValidationError

try:
    route = client.route(from_=[-26.1, 28.0], to=[-26.2, 28.04])
except ElaraValidationError as e:
    print("Bad input:", e.detail)
except ElaraRateLimitError as e:
    print(f"Retry in {e.retry_after}s")
except ElaraAuthError:
    print("Check your API key")

Run tests

pytest tests/ -v

Run example

set ELARA_API_KEY=elara_your_key
python examples/quickstart.py

Free tier

25,000 routes/month, no credit card. Get your key →

License

MIT — see LICENSE.

---

ELARA·CORTEX · Mathematical infrastructure for complex systems · Institute for Decision Systems & Number Theory

AUTHOR: .LEKOLA · CODE ATELIER · GitHub: ELARA-CORTEX-MATH-INFRA