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[extract] # OSM data extraction
pip install yoro-maps[django] # Django integration
pip install yoro-maps[tiles] # Tile downloading
Build a map database
yoromaps download ML --output mali.yoromaps
Route between Yoro codes
yoromaps route mali.yoromaps ML-4V7AK ML-5G62E
import yoromaps
conn = yoromaps.open_db("mali.yoromaps")
graph = yoromaps.get_graph("mali.yoromaps") # loaded once, cached per process
r = graph.route(12.639, -8.003, 14.489, -4.197) # Bamako → Mopti
print(f"{r.distance_km} km, {r.duration_min} min") # 551.8 km, 681.0 min
# Points of interest — every POI gets a Yoro code automatically
poi = yoromaps.add_poi(conn, 12.639, -8.002, "Grand marche", category="market")
print(poi["yoro_code"]) # "ML-4V7AK"
yoromaps.pois_near(conn, 12.64, -8.0, radius_m=500) # sorted by distance
yoromaps.pois_in_cell(conn, "ML-4V7AK") # who lives at this address?
Update maps
yoromaps update mali.yoromaps
# → Downloads only if OSM data has changed. POI and tiles are preserved.
Tested performance
| Route | Distance | Compute |
|---|---|---|
| Bamako → Mopti | 551.8 km | 6.3s |
| Bamako → Tombouctou | 812.2 km | 6.6s |
| Urban (Bamako) | 3.8 km | 0.5s |
Django integration
import yoromaps
DATABASES = {
"default": { ... },
"maps": yoromaps.db_config("/data/mali.yoromaps"),
}
License
MIT — Paul Guindo / Altius Academy SNC.
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
yoro_maps-0.3.0.tar.gz
(38.3 kB
view details)
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
yoro_maps-0.3.0-py3-none-any.whl
(23.9 kB
view details)
File details
Details for the file yoro_maps-0.3.0.tar.gz.
File metadata
- Download URL: yoro_maps-0.3.0.tar.gz
- Upload date:
- Size: 38.3 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.13.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
480951a87ede4d1bbab881bd6e9690d1de40f279147fa6da40d49b04c9b9d49c
|
|
| MD5 |
671360e20fc772141843db51f014cfe4
|
|
| BLAKE2b-256 |
18f2ac3cdee74eb233c5a9dc746ce04d049ea612ad9efa2d30c6091702cfb8b3
|
Provenance
The following attestation bundles were made for yoro_maps-0.3.0.tar.gz:
Publisher:
publish.yml on Altius-Academy-SNC/yoro-maps
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
yoro_maps-0.3.0.tar.gz -
Subject digest:
480951a87ede4d1bbab881bd6e9690d1de40f279147fa6da40d49b04c9b9d49c - Sigstore transparency entry: 2051120934
- Sigstore integration time:
-
Permalink:
Altius-Academy-SNC/yoro-maps@7568c0a29ee5343ee2d64d6bdb31b129e87a1081 -
Branch / Tag:
refs/tags/v0.3.0 - Owner: https://github.com/Altius-Academy-SNC
-
Access:
private
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish.yml@7568c0a29ee5343ee2d64d6bdb31b129e87a1081 -
Trigger Event:
release
-
Statement type:
File details
Details for the file yoro_maps-0.3.0-py3-none-any.whl.
File metadata
- Download URL: yoro_maps-0.3.0-py3-none-any.whl
- Upload date:
- Size: 23.9 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.13.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
202072c0b8e84762155cbe0276520c5996665d579187bf153841f508468f61f8
|
|
| MD5 |
6d9001b0b46299283ad7b2fd5201308e
|
|
| BLAKE2b-256 |
bbe5a00fb07f1ea5d65d92ee947217ed3afd625f70ed3b297fbef603bc2f3295
|
Provenance
The following attestation bundles were made for yoro_maps-0.3.0-py3-none-any.whl:
Publisher:
publish.yml on Altius-Academy-SNC/yoro-maps
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
yoro_maps-0.3.0-py3-none-any.whl -
Subject digest:
202072c0b8e84762155cbe0276520c5996665d579187bf153841f508468f61f8 - Sigstore transparency entry: 2051121002
- Sigstore integration time:
-
Permalink:
Altius-Academy-SNC/yoro-maps@7568c0a29ee5343ee2d64d6bdb31b129e87a1081 -
Branch / Tag:
refs/tags/v0.3.0 - Owner: https://github.com/Altius-Academy-SNC
-
Access:
private
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish.yml@7568c0a29ee5343ee2d64d6bdb31b129e87a1081 -
Trigger Event:
release
-
Statement type:
