Skip to content

Manethpak/cambo-gazetteer

Repository files navigation

Cambodia Gazetteer

License: MIT Data License: ODbL

Standardized geographical data for Cambodia's administrative divisions. Free, open-source API and datasets for research, applications, and data analysis.

🌐 Live API: https://cambo-gazetteer.manethpak.dev/
📚 Documentation: https://cambo-gazetteer.manethpak.dev/api/docs


What You Get

16,457 administrative units with bilingual names (Khmer/English) and hierarchical codes:

  • 25 Provinces & Municipalities
  • 210 Districts
  • 1,652 Communes
  • 14,570 Villages

Access via:

  • REST API with full-text search (Khmer & English)
  • JSON datasets (download and use offline)
  • Administrative codes for database normalization

Why it matters: Cambodia's location data is fragmented—different spellings, no standardization, scattered across systems. This creates inconsistencies in government databases, business applications, and research. This project provides a single source of truth.


Quick Start

Use the API (no setup required):

# Search for locations
curl "https://cambo-gazetteer.manethpak.dev/api/v1/search?q=Siem%20Reap"

# Get by administrative code
curl "https://cambo-gazetteer.manethpak.dev/api/v1/code/02"

# Autocomplete
curl "https://cambo-gazetteer.manethpak.dev/api/v1/search/autocomplete?q=Phnom"

Download raw data:
Visit cambo-gazetteer.manethpak.dev/data-source for JSON/Excel datasets.

Self-host (optional):

git clone https://github.com/Manethpak/cambo-gazetteer.git
cd cambo-gazetteer
pnpm install && pnpm db:setup:local && pnpm dev

Full documentation: cambo-gazetteer.manethpak.dev/api/docs


Use Cases

Research & Analytics
Clean, structured data for demographics, policy analysis, and academic research.

Applications
Build address forms, location pickers, mapping tools, and geospatial applications.

Data Integration
Standardize location data across government systems, business databases, and legacy applications.

Validation
Verify user-entered addresses against authoritative administrative divisions.


Administrative Codes

Replace fragmented storage (4-5 columns) with a single hierarchical code:

02        → Siem Reap Province
0202      → Siem Reap District  
020205    → Svay Leu Commune
02020501  → Specific Village

Each code lookup returns full details: Khmer name, English name, type, parent hierarchy.


Data Sources

Sourced from Open Development Cambodia and UNOCHA via HDX. Validated against NCDD Gazetteer. Processed, normalized, and made accessible via API and downloadable datasets.

Data License: ODbL - Free to use with attribution.


Contributing

Found an error? Want to improve the data? Contributions welcome.

  1. Fork the repo
  2. Make your changes
  3. Submit a pull request

Report issues: github.com/Manethpak/cambo-gazetteer/issues


License

Code: MIT License
Data: ODbL (Open Database License)

Attribution required when using the data. Credit Open Development Cambodia, UNOCHA/HDX, and this project.


Author

Maneth PAK
manethpak.dev@gmail.com | GitHub


Built for Cambodia's research and developer community

⭐ Star this project if you find it useful

WebsiteAPI DocsData DownloadIssues

About

Free Cambodia gazetteer API & Data

Topics

Resources

License

Stars

Watchers

Forks

Contributors

Languages