📌 Bangladesh Geo Data (Divisions, Districts, Upazilas)

🏆 Overview

bangladeshi-geo-data provides Bangladesh's geographical data, including Divisions, Districts, and Upazilas, in a structured and searchable format.

✅ Supports English & Bangla names
✅ Efficient search functionality
✅ Lightweight & easy to use

---

📦 Installation

Using NPM

npm install bangladeshi-geo-data

Using Yarn

yarn add bangladeshi-geo-data

---

🚀 Usage Examples

1️⃣ Importing the Package

import { getDivisions, getDivision, getDistricts, getUpazilas, searchGeoData } from "bangladeshi-geo-data";

---

2️⃣ Get All Divisions

console.log(getDivisions());

---

3️⃣ Get Division by ID or Name

console.log(getDivision(1)); // Fetch division by ID
console.log(getDivision("Dhaka")); // Fetch division by name
console.log(getDivision("ঢাকা")); // Fetch division by Bangla name

---

4️⃣ Get Districts by Division ID or Name

console.log(getDistricts(1)); // Fetch districts in division ID 1
console.log(getDistricts("Dhaka")); // Fetch districts in Dhaka division

---

5️⃣ Get Upazilas by District Name

console.log(getUpazilas("Dhaka", "Dhaka")); // Fetch Upazilas in Dhaka District

---

6️⃣ Search for Any Division, District, or Upazila

console.log(searchGeoData("Gazipur"));
console.log(searchGeoData("সাভার")); // Bangla search

---

🎯 Real-Life Use Cases

1️⃣ E-commerce Address Management

If you're building an e-commerce platform, you can use bangladeshi-geo-data to allow users to select their division, district, and upazila while filling out their shipping address.

const userDivision = getDivision("Dhaka");
const userDistricts = getDistricts("Dhaka");
const userUpazilas = getUpazilas("Dhaka", "Dhaka");

2️⃣ Government & NGO Data Analysis

Organizations working in rural development can filter and analyze data by region.

const floodProneDistricts = ["Sunamganj", "Sylhet", "Kurigram"];
const districtsData = floodProneDistricts.map((name) => getDistricts(name));

3️⃣ Location-Based Filtering in Apps

If you're building a real estate, healthcare, or service-based app, you can filter data based on users' locations.

const userSearch = searchGeoData("Comilla");
console.log("Matching Locations:", userSearch);

---

🎯 Features

• 📍 Accurate Geo Data (Bangladesh's Divisions, Districts, and Upazilas)
• 🔍 Searchable (Find by ID, English name, or Bangla name)
• 🚀 Lightweight & Fast
• 🔄 Regularly Updated
• 🏆 Well-structured TypeScript support

---

⚙️ API Methods

Method	Description	Input Type	Example Input
getDivisions()	Get all divisions	()	getDivisions()
getDivision()	Get a division by ID or Name	`number	string`	getDivision(1) / getDivision("Dhaka")
getDistricts()	Get districts by Division ID or Name	`number	string`	getDistricts("Dhaka")
getUpazilas()	Get upazilas by District Name & Division	string,string	getUpazilas("Dhaka", "Dhaka")
searchGeoData()	Search for any division, district, or upazila	string	searchGeoData("Gazipur")

---

🛠️ Contributing

Contributions are welcome! 🎉
To contribute:

1. Fork this repository
2. Create a new feature branch
3. Submit a Pull Request (PR)

📌 If you find any missing data or incorrect names, please open an issue.

---

📜 License

Licensed under the MIT License.
You are free to use, modify, and distribute this package.

📌 Maintainer: Mehedi Hasan Khairul
📌 NPM Package: bangladeshi-geo-data

---

📢 Contact & Support

🔗 GitHub: GitHub Repo
🔗 NPM: NPM Package
🔗 Facebook: Facebook Profile

🚀 Enjoy using bangladeshi-geo-data! Let us know if you have any suggestions or feedback! 🚀