souravio

A lightweight npm package providing comprehensive administrative data about Bangladesh, including divisions, districts, and upazilas.

Installation

npm install souravio

Usage

const souravio = require("souravio");

// Get all divisions
const divisions = souravio.getAllDivisions();

// Get districts in a specific division (e.g., Dhaka - ID 3)
const districts = souravio.getDistrictsByDivisionId(3);

// Get upazilas in a specific district (e.g., Barguna - ID 34)
const upazilas = souravio.getUpazilasByDistrictId(34);

// Search for a district by name
const feni = souravio.searchDistrict("Feni");
console.log(feni.bn_name); // 'ফেনী'

// Search using Bengali name
const dhaka = souravio.searchDivision("ঢাকা");

API Reference

Divisions

• getAllDivisions(): Returns all 8 divisions.
• getDivisionById(id): Returns a division by its ID.
• searchDivision(name): Search by English or Bengali name.

Districts

• getAllDistricts(): Returns all 64 districts.
• getDistrictById(id): Returns a district by its ID.
• getDistrictsByDivisionId(divisionId): Returns districts under a division.
• searchDistrict(name): Search by English or Bengali name.

Upazilas

• getAllUpazilas(): Returns all upazilas.
• getUpazilaById(id): Returns an upazila by its ID.
• getUpazilasByDistrictId(districtId): Returns upazilas under a district.
• searchUpazila(name): Search by English or Bengali name.

Data Source

Data is sourced from reliable open-source repositories mapping Bangladesh administrative boundaries.

License

MIT