Place Search & Mapping for Africa
Self-improving geospatial platform built on OpenStreetMap. Ships with 54,000+ Cameroon places. Contributors validate, correct, and rank — data gets better with every delivery.
54,000+
Cameroon Places
51
Cities
<50ms
Search Latency
5
Microservices
360°
Nearby View
⚡ Quick Start
git clone https://github.com/vimex/geosplaf
cp .env.example .env
docker compose up -d
curl http://localhost:8088/health
# → {"status":"ok","service":"geosplaf-api"}
curl -H "X-API-Key: your-key" \
"http://localhost:8088/api/search/autocomplete?q=yaounde&lat=3.848&lon=11.502"🏗️ Architecture
┌─────────┐
│ Nginx │ :8088 (gateway)
└────┬────┘
┌──────────────┼──────────────┐
│ │ │
┌────▼────┐ ┌─────▼─────┐ ┌─────▼─────┐
│ API │ │ Docs │ │ Worker │
│ :8000 │ │ :8001 │ │ (Asynq) │
└────┬────┘ └───────────┘ └─────┬─────┘
│ │
┌────▼────┐ ┌────▼────┐
│PostGIS │ │ Redis │
│ :5432 │ │ :6379 │
└─────────┘ └─────────┘🔗 Key Endpoints
GET/api/search/autocomplete?q=...
Search-as-you-type across 54,000+ Cameroon places. Fuzzy matching via pg_trgm. Location-biased results.
POST/api/contributor/points
Submit a new place with GPS coordinates. Automatic duplicate detection within 500m.
POST/api/contributor/validate
The self-improving loop. Confirm, correct, or reject points from your location.
GET/api/places/{id}
Full place detail with dynamic parent hierarchy and 360° nearby view.
GET/api/geocode/reverse?lat=...&lon=...
GPS coordinates to nearest place. Contributor data checked first, OSM as fallback.