globe Ülke Bilgisi (Bayrak, Başkent, Nüfus) star

Veri Nereden Geliyor

Ülke verisi ilk bakışta çözülmüş bir problem gibi görünür — ta ki canlı bir API üzerine bir şey inşa etmeye çalışana kadar. Bir zamanlar yaygın kullanılan restcountries.com REST servisi (önce v2, sonra v3.1) yıllar içinde güvenilmez ve hız sınırlı hale geldi, ona bağımlı sayısız projeyi bozdu. Bu araç bu kırılganlığı atlıyor: GitHub'da tutulan, her ülkenin resmî ve yerel adlarını, çevirilerini, başkentlerini, para birimlerini, telefon kodlarını ve komşularını içeren tek bir ~130KB'lık JSON dosyası olan açık mledoze/countries veri setini, hız sınırlı bir API uç noktası yerine jsDelivr CDN üzerinden yükler. Statik bir dosya kenarda (edge) önbelleklendiği için sorgular anında sonuçlanır ve asla çökmez.

Gerçekten güncel kalması gereken tek rakam nüfus olduğundan, bu bilgi ayrıca Dünya Bankası'nın SP.POP.TOTL göstergesinden — her ülkenin Bankaya yıllık bildirdiği standart "toplam nüfus" serisinden — çekilir. İstek mrnev=1 ("en güncel boş olmayan değer") parametresiyle yapılır; böylece yavaş raporlayan ülkelerde birkaç yıl eskimiş sabit bir yıl yerine her zaman o ülkenin yayınladığı en son rakam gelir. Bayraklar ise sayfayı hafif tutmak için gömülü görsel yerine, isteğe bağlı olarak flagcdn.com'dan SVG (her boyutta net) ya da PNG olarak çekilir.

Bu iki kaynaklı tasarım bilinçlidir: neredeyse hiç değişmeyen gerçekler (başkent, resmî dil, telefon kodu) GitHub'da katkıcılar tarafından sürümlenip gözden geçirilen bir veri setinden gelirken, yıldan yıla gerçekten değişen tek rakam, onu profesyonelce izleyen kurumdan taze çekilir. Verinin büyük kısmı sabitken yalnızca küçük bir dilimin güncel kalması gerektiğinde, statik bir veri setini canlı bir göstergeyle karıştırmak yaygın bir desendir — sayfa her açıldığında dünyanın tamamını yeniden çekmekten kaçınırken, insanların en çok önemsediği rakamı da makul ölçüde taze tutar.

Bilinmesi Gerekenler

• Neden doğrudan restcountries.com değil? API'si sürüm kırıklıkları ve erişim kısıtlaması/kesinti dönemlerinden geçti; sürümlenmiş statik bir veri seti, başkent gibi temel bilgiler için üçüncü bir tarafın çalışma süresine bağımlı olmaktan kaçınır.
• Nüfus gerçek zamanlı değildir. Dünya Bankası bunu, kendi takvimine göre raporlayan ulusal istatistik kurumlarından derler — genelde bir-iki yıllık gecikmeyle. "En güncel boş olmayan değer" yalnızca o ülkenin fiilen yayınladığı son yıl anlamına gelir.
• Çeviriler aynı veri setinden gelir. Yerel ve çevrilmiş ülke adları mledoze/countries içinde gömülüdür; "Almanya" ve "Germany" aramasının aynı kayda çıkmasının nedeni budur.
• Bayraklar varsayılan olarak vektöreldir. flagcdn.com'dan gelen SVG bayraklar yakınlaştırıldığında veya yazdırıldığında keskin kalır; PNG, SVG'yi iyi işlemeyen araçlar için yedek olarak sunulur.
• Yoğunluk hesaplanır, saklanmaz. Nüfusun yüzölçümüne bölünmesi, sorgu anında tarayıcınızda gerçekleşir; bu yüzden veri setine gömülü sabit bir sayı yerine her zaman az önce çekilen o yılın nüfus rakamını yansıtır.
• Kara sınırı olmayan ülkeler de belirtilir. Japonya gibi ada veya yarımada ülkelerinde komşu alanı boş bırakılmaz; kartta bunun bir eksiklik değil, coğrafi bir gerçek olduğu açıkça yazar.