yoro-maps 0.1.1

Offline maps, routing, and POI for Africa — companion to yoro geocoding

Yoro Maps

Documentation | PyPI | GitHub

Offline maps, routing, and POI for Africa — companion to yoro geocoding.

Install

pip install yoro-maps
pip install yoro-maps[django]    # Django integration
pip install yoro-maps[tiles]     # Tile downloading

Build a map database

# Download OSM data and build road graph for Mali
yoromaps download ML --output mali.yoromaps

# With map tiles (slower, ~200+ MB)
yoromaps download ML --output mali.yoromaps --tiles --zoom-max 14

Route between Yoro codes

yoromaps route mali.yoromaps ML-ABC ML-XYZ

import yoromaps

conn = yoromaps.open_db("mali.yoromaps")
result = yoromaps.route(conn, start_lat=12.6, start_lon=-8.0, end_lat=14.5, end_lon=-4.0)
print(f"{result.distance_km} km, {result.duration_min} min")

Django integration

# settings.py
import yoromaps

DATABASES = {
    "default": { ... },
    "maps": yoromaps.db_config("/data/mali.yoromaps"),
}

DATABASE_ROUTERS = ["yoromaps.django.router.YoroMapsRouter"]

# urls.py
urlpatterns = [
    path("maps/", include("yoromaps.django.urls")),
]

License

MIT — Paul Guindo / Altius Academy SNC.