A comprehensive TypeScript/JavaScript library providing structured data for all Kenyan administrative divisions including counties, constituencies, wards, localities, and areas with powerful search and lookup capabilities.
- Complete Coverage: All 47 counties, constituencies, wards, localities, and areas
- Fast Search: Efficient lookup by code or name
- Hierarchical Queries: Get all constituencies in a county, wards in a constituency, etc.
- TypeScript Support: Full type definitions included
- Optimized Performance: Map-based lookups for O(1) time complexity
- Case Insensitive: All searches work regardless of case
- Referential Integrity: Maintain relationships between administrative levels
npm i ke-locations-dataimport { kenyaLocations } from 'ke-locations-data';
// Search for locations
const results = kenyaLocations.search('Nairobi');
// Get county by name
const county = kenyaLocations.getCountyByName('Mombasa');
// Get all constituencies in a county
const constituencies = kenyaLocations.getConstituenciesByCounty('47');
// Get all wards in a constituency
const wards = kenyaLocations.getWardsByConstituency('290');Search across all location types or filter by specific type.
// Search all types
const results = kenyaLocations.search('Westlands');
// Search with limit
const results = kenyaLocations.search('Nairobi', 5);
// Search specific type
const counties = kenyaLocations.search('Mombasa', 'county');
// Search specific type with limit
const wards = kenyaLocations.search('Park', 'ward', 3);Parameters:
query: Search query stringtypeOrLimit: Either aSearchType('county' | 'constituency' | 'ward' | 'locality' | 'area') or a number for limitlimit: Maximum number of results (default: 10)
Returns: Array of SearchResult objects containing type and item data
Get all locations of a specific type.
const allCounties = kenyaLocations.getByType('county');
const allWards = kenyaLocations.getByType('ward');Get all location data combined.
const allLocations = kenyaLocations.getAllData();Get a county by its code.
const nairobi = kenyaLocations.getCountyByCode('47');
// Returns: { code: '47', name: 'Nairobi', type: 'county' }Get a county by its name (case-insensitive).
const mombasa = kenyaLocations.getCountyByName('Mombasa');
const sameMombasa = kenyaLocations.getCountyByName('MOMBASA'); // Works too!Get all 47 counties.
const counties = kenyaLocations.getAllCounties();
console.log(counties.length); // 47Get a constituency by its code.
const westlands = kenyaLocations.getConstituencyByCode('290');Get a constituency by its name (case-insensitive).
const westlands = kenyaLocations.getConstituencyByName('Westlands');Get all constituencies.
const constituencies = kenyaLocations.getAllConstituencies();Get all constituencies within a specific county.
// Get all constituencies in Nairobi
const nairobiConstituencies = kenyaLocations.getConstituenciesByCounty('47');Get a ward by its code.
const ward = kenyaLocations.getWardByCode('1366');Get a ward by its name (case-insensitive).
const parklands = kenyaLocations.getWardByName('Parklands/Highridge');Get all wards.
const wards = kenyaLocations.getAllWards();Get all wards within a specific constituency.
// Get all wards in Westlands constituency
const westlandsWards = kenyaLocations.getWardsByConstituency('290');Get all wards within a specific county.
// Get all wards in Nairobi county
const nairobiWards = kenyaLocations.getWardsByCounty('47');Get a locality by its code.
const locality = kenyaLocations.getLocalityByCode('2853');Get a locality by its name (case-insensitive).
const karen = kenyaLocations.getLocalityByName('Karen');Get all localities.
const localities = kenyaLocations.getAllLocalities();Get all localities within a specific county.
const nairobiLocalities = kenyaLocations.getLocalitiesByCounty('47');Get an area by its code.
const area = kenyaLocations.getAreaByCode('3125');Get an area by its name (case-insensitive).
const kilimani = kenyaLocations.getAreaByName('Kilimani');Get all areas.
const areas = kenyaLocations.getAllAreas();Get all areas within a specific county.
const nairobiAreas = kenyaLocations.getAreasByCounty('47');Get all areas within a specific locality.
const karenAreas = kenyaLocations.getAreasByLocality('Karen');interface ICounty {
code: string;
name: string;
type: string;
}
interface IConstituency {
code: string;
name: string;
county_code: string;
county_name: string;
type: string;
}
interface IWard {
code: string;
name: string;
constituency_code: string;
constituency_name: string;
county_code: string;
county_name: string;
type: string;
}
interface ILocality {
code: string;
name: string;
county_code: string;
county_name: string;
type: string;
}
interface IArea {
code: string;
name: string;
locality: string;
county_code: string;
county_name: string;
type: string;
}
type SearchType = 'county' | 'constituency' | 'ward' | 'locality' | 'area';
interface SearchResult {
type: SearchType;
item: ICounty | IConstituency | IWard | ILocality | IArea;
}The library uses Map-based lookups for optimal performance:
- Lookup by Code/Name: O(1) time complexity
- Hierarchical Queries: O(n) where n is the filtered subset
- Search Operations: Optimized with early returns
- Memory Efficient: Data loaded once and reused
Works in all modern browsers and Node.js environments that support:
- ES6+ features
- Map/Set data structures
- TypeScript 4.0+
Contributions are welcome! Please feel free to submit a Pull Request.
Data is compiled from official Kenyan government sources and regularly updated to ensure accuracy.
MIT License - see LICENSE file for details
Gerald Mumo
- GitHub: @gerismumo
If you encounter any issues or have questions, please file an issue on the GitHub repository.