# GéoBénin — Atlas géographique interactif du Bénin
# https://www.geobenin.com

## About
GéoBénin is the most comprehensive interactive geographic atlas of Benin, covering all 77 communes and 12 departments. Developed by an independent collective of Beninese Data Engineers and Data Analysts.

## Content
- 77 communes with demographic, economic, geographic and infrastructure data
- 12 departments with aggregated statistics
- Interactive Leaflet map with 4 base layers and thematic overlays
- Citizen rating system (9 criteria per commune)
- Tourism directory with categorized sites
- Festivals & cultural events calendar (catalog + agenda views)
- Sorties & Découvertes — outdoor activities and local experiences directory
- Hôtels & Restaurants directory (hotels, guesthouses, restaurants, bars)
- Organisations directory — official institutes and civil society NGOs, classified by theme
- Villages and quartiers database sourced from OpenStreetMap
- Statistical dashboard with charts and CSV export
- Commune comparison tool — 3 modes: communes, arrondissements, villages (up to 3 side-by-side)
- "Ville Idéale" ranking — communes ranked by citizen ratings

## Data Sources
- INSAE (Institut National de la Statistique et de l'Analyse Économique du Bénin)
- RGPH 2013 (Recensement Général de la Population et de l'Habitation) + 2023 estimates
- IGN Bénin / ANDF (Agence Nationale du Domaine et du Foncier)
- GADM (Database of Global Administrative Areas)
- OpenStreetMap (POIs, villages, quartiers, infrastructure)
- Wikipedia FR (commune descriptions)
- Wikidata (structured population, area, elevation data)
- Nominatim (geocoding)

## API
REST API available at /api with endpoints:
- GET /api/communes — List all communes
- GET /api/communes/:id — Full commune profile
- GET /api/departements — List departments
- GET /api/tourisme — Tourism sites
- GET /api/tourisme/:id — Tourism site detail
- GET /api/festivals — Festivals & events calendar
- GET /api/festivals/prochain — Next upcoming festival
- GET /api/sorties — Outdoor activities & experiences
- GET /api/sorties/:id — Sortie detail
- GET /api/hebergements — Hotels, guesthouses & restaurants
- GET /api/hebergements/:id — Hébergement detail
- GET /api/ongs — Civil society NGOs directory
- GET /api/instituts — Official institutes directory
- GET /api/quartiers/search?q= — Search villages/quartiers
- GET /api/avis/:communeId — Citizen ratings

## License
Public data — Free to use with attribution.