nusantara_data 1.0.0
nusantara_data: ^1.0.0 copied to clipboard
A comprehensive Flutter library for Indonesia location data (Province → City → District → Village → Postal Code) with BPS (Badan Pusat Statistik) codes. Complete data for all 38 provinces, 514 cities, [...]
Changelog #
All notable changes to this project will be documented in this file.
The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.
1.0.0 - 2026-01-31 #
Added #
- Initial release
- Complete Indonesia location data:
- 38 Provinces
- 514 Cities/Regencies
- 7,265 Districts (Kecamatan)
- 83,202 Villages (Kelurahan/Desa)
- 83,762 Postal Codes
- Province operations:
getAllProvinces()getProvinceById(id)getProvinceByName(name)searchProvinces(query)
- City operations:
getAllCities()getCitiesByProvinceId(provinceId)getCityById(id)getCityByName(name)searchCities(query)
- District operations:
getAllDistricts()getDistrictsByCityId(cityId)getDistrictById(id)getDistrictByName(name)searchDistricts(query)
- Village operations:
getAllVillages()getVillagesByDistrictId(districtId)getVillageById(id)getVillageByName(name)searchVillages(query, districtId)
- Postal code operations:
getPostalCodesByVillageId(villageId)getPostalCodesByDistrictId(districtId)getLocationByPostalCode(postalCode)
- Metadata operations:
getVersion()getLastUpdated()getStatistics()
- FuzzySearch utility for typo-tolerant search:
- Levenshtein distance algorithm
- Adaptive tolerance based on query length
- Similarity ranking
Data Source #
- Kepmendagri No 300.2.2-2138 Tahun 2025
- Badan Pusat Statistik (BPS) official codes