Açık kaynak npm paketi @olism/bd-geo, yapılandırılmış Bangladeş coğrafi verilerini JS ve TypeScript'e getiriyor

Bir geliştirici, Bangladeş'in idari coğrafi yapısını JavaScript ve TypeScript projeleri için yapılandırılmış veri olarak sunan @olism/bd-geo adlı açık kaynak npm paketini yayımladı. dev.to'daki bir duyuru yazısında tanıtılan kütüphane, ülkenin konum hiyerarşisini bölge seviyesinden tek tek köylere kadar kapsıyor.

Veriler neyi kapsıyor

Duyuruya göre paket, Bangladeş coğrafi yapısını beş seviyede modelliyor: bölgeler (division), ilçeler (district), upazila ve thana'lar, alanlar (area) ve köyler (village). Bu seviyeler birbirinin içinde yer aldığından, veri doğal olarak kademeli seçicilere oturuyor — önce bir bölge, ardından onun ilçelerinden biri, sonra bir upazila veya thana, en sonunda da bir alan veya köy seçiliyor. Yazar bunu, veri seti aramak, temizlemek ve güncel tutmak gibi her ihtiyaç duyan projede tekrarlanan rutin işlere bir alternatif olarak konumlandırıyor.

Kurulum ve erişilebilirlik

Paket npm üzerinden erişilebilir ve npm ya da yarn ile tek bir komutla projeye eklenebiliyor. Hem JavaScript hem de TypeScript'i hedeflediğinden, coğrafi yapılar geçici JSON olarak ayrıştırılmak yerine tip bilgisiyle birlikte kullanılabiliyor. Geliştirme süreci herkese açık bir GitHub deposunda yürütülüyor; kaynak kodu incelemeye ve katkıya açık.

Nerede kullanılır

dev.to'daki yazı geniş bir kullanım alanına işaret ediyor: adres ve konum formları, e-ticaret ve teslimat sistemleri, emlak ilanları, konum temelli özellikler, veritabanı tohumlama (seeding), veri görselleştirme ile konum arama veya filtreleme. Bunların ortak noktası, güvenilir bir bölgeden yerelliğe kademeli yapı ihtiyacı — ki kütüphanenin sunduğu şekil tam olarak bu. Örneğin bir adres formu, kullanıcıdan yerel adı serbestçe yazmasını istemek yerine, onu hiyerarşide adım adım yönlendirebilir.

Erken aşamada bir proje

Yazar projenin olgunluğu konusunda açık sözlü; veri setinin, API'lerin, dokümantasyonun ve genel geliştirici deneyiminin henüz geliştirilmeye ihtiyacı olduğunu belirtiyor. Geri bildirim, hata raporları ve katkılar açıkça davet ediliyor ve Bangladeş odaklı uygulamalar geliştirenlerin, işlerine yarayacak ek veri setlerini veya özellikleri önermeleri teşvik ediliyor.

Neden önemli

Ülkeye özgü referans verileri, uygulama geliştirmede tekrar eden gizli bir maliyettir. Bangladeş için geliştirme yapan ekipler çoğu zaman elektronik tablolardan, eski depolardan veya kazıyarak elde edilmiş kaynaklardan konum tablolarını kopyalamakta ve bakım yükünü tek başlarına taşımaktaydı. Veriyi sürümlü bir npm modülü olarak dağıtmak bu ekonomiyi değiştiriyor: düzeltmeler bir dependency güncellemesine dönüşüyor, yapı projeler arasında tutarlı kalıyor ve TypeScript kullanıcıları tükettikleri verinin biçimi konusunda derleme zamanı güvencesi kazanıyor.

Bu aynı zamanda daha geniş bir eğilimin küçük bir örneği — ulusal ve bölgesel veri setlerinin tek seferlik indirmeler yerine sıradan paket kayıt defterleri üzerinden dağıtılması. Bu paketin başarılı olup olmayacağı, her açık veri setini ayakta tutan şeye bağlı: idari sınırlar değiştikçe katkıda bulunanların onu doğru tutması. Bu arada, Bangladeş'teki bir kullanıcıya nerede yaşadığını sorması gereken herhangi bir JavaScript veya TypeScript uygulaması için engeli düşürüyor.