2KAY-kat/malawi-districts

# Malawi Districts A geospatial + socio-economic dataset of Malawi districts, including GPS centroids, poverty metrics, population totals (2018 PHC census), and neighbor relationships. ## Installation ```bash npm install malawi-districts ``` ## Quick Start ```js const malawi = require('malawi-districts'); // full dataset const all = malawi.all; // capital district const capital = malawi.getCapital(); // districts by poverty tier const highPoverty = malawi.getByPovertyLevel('high'); // population totals const southernPop = malawi.getTotalPopulation('Southern'); // neighbors for a district const neighbors = malawi.getNeighbors('Blantyre City'); // fuzzy search by name or region const search = malawi.search('Mangochi'); ``` ## New Features (v2.0.0) - **Geospatial**: `lat` / `lng` centroid coordinates for each district. - **Socio-economic**: `poverty` (MPI %) and `population` (2018 PHC Census) fields. - **Administrative classification**: `type` (`City` / `District`) and `class` (`Urban` / `Rural`). - **Neighbor relationships**: `neighbors` lists adjacent districts. - **New query helpers**: - `getCapital()` — returns the capital district object. - `getByPovertyLevel('low'|'medium'|'high')` — poverty-tier filtering. - `getTotalPopulation(region?)` — population sums by region or nationwide. - `getNeighbors(name)` — returns the border districts for a given district. - `search(query)` — fuzzy search by district name or region. ## API ### `malawi.all` All districts as an array of objects. ### `malawi.getCapital()` Returns the district object where `isCapital === true`. ### `malawi.getByPovertyLevel(level)` - `low`: poverty 60% ### `malawi.getTotalPopulation(region)` Returns total population for a region (`Northern`, `Central`, `Southern`) or the entire country when no region is provided. ## Data Sources Data in this package is compiled from the following sources: - **NSO Malawi** – Multidimensional Poverty Index (MPI) and socio-economic data. - ** …