Referans verileri ve zenginleştirme
Otuz dört milyon satır, tek bir adım olarak
Ülkeler, diller ve para birimleri. 13,4 milyon yerleşim yeri ve coğrafi özellik. 19 milyon isim varyantı. İki milyon posta kodu. Havalimanları, deniz limanları, araç markaları. Altmış beş uç nokta, kimlik doğrulama yok, ücret tarifesi yok — çünkü iş akışınızın zaten üzerinde çalıştığı platformun aynısı.
Bu neden alışılmadık
Diğer tüm otomasyon araçlarında "bu adresi doğrula" ücretli bir üçüncü taraf entegrasyonudur. Bir tedarikçi bulur, hesap açar, ücret tarifesi üzerinde anlaşırsınız, anahtar alır, anahtarı saklarsınız, kotası izlersiniz ve hacminiz değiştiğinde yeniden pazarlık edersiniz. Sorgunun kendisi yirmi milisaniye sürer; tedarik süreci iki hafta sürer.
Buradaki, seçicideki bir adımdır. Veri, kamuya açık referans verisidir — GeoNames, resmî kod listeleri, yayımlanmış kayıtlar — castomAPI tarafından temizlenir, dizinlenir ve sunulur; bu hizmet, bu ailedeki on iki ürünün aynı şeye ihtiyaç duyması ve on iki kez inşa etmek yerine bir kez inşa etmenin daha ucuz olması için vardır.
Arama üç karakterlik asgari sınırla trigram tabanlıdır; böylece eksik veya yanlış yazılmış bir ad bile yeri bulur. Bu asgari sınır kasıtlıdır: iki karakter her şeyle eşleşir ve her şeyle eşleşen bir arama, hiç arama olmamasından daha kötüdür.
İnsanların onunla yaptığı üç şey
Doğrulama — hatalı veriyi kapıda durdurun. Bu, o şehir için gerçek bir posta kodu mu? O ülke kodu var mı, yoksa 2019'da birinin yaptığı ve o zamandan beri yayılan bir yazım hatası mı? PLN bir para birimi mi ve bu müşterinin faturalanacağı para birimi o mu?
Normalleştirme — “Warsaw”, “Warszawa”, “Varsovie” ve “Варшава” tek bir tanımlayıcılı tek bir yerdir. On dokuz milyon ad varyantı vardır; böylece müşteri veritabanınız aynı şehrin dört yazımını tutup onları dört şehir gibi göstermek zorunda kalmaz.
Zenginleştirme — bir şehir adı koordinatlara, bir saat dilimine, bir idari bölgeye ve bir nüfus rakamına dönüşür. Bir havaalanı kodu bir ada ve bir konuma dönüşür. Bir posta kodu, hiyerarşideki üzerindeki her şeye dönüşür. Bir kişinin aksi halde elle yazacağı altı alan, yirmi milisaniyede, bedelsiz doldurulur.
Saat dilimi sessiz olanıdır
Bir yerin çözümlenmesi size saat dilimini verir ve saat dilimi, “bunu sabah dokuzda gönder” ifadesinin sizin sabah dokuzunuz değil, alıcının sabah dokuzu anlamına gelmesini sağlayan şeydir. Sessiz saatler, zamanlamalar ve hatırlatıcılar, kimsenin bir eşleme tablosu tutmasına gerek kalmadan uluslararası bir liste için doğru hale gelir.
- 1Girdi“ul. Powstańców Śląskich 5, 53-332 Wrocław, PL”
- 2Posta kodu eşleşti53-332 → Wrocław, Dolnośląskie, PL.
- 3Yer çözümlendi51.0938 K, 17.0226 D · Europe/Warsaw · nüfus 674 079.
- 4Geri yazıldıAksi halde bir kişinin elle yazacağı altı alan dolduruldu.
- §MaliyetDeterministik adım. Anahtar yok, kota yok, arama başına ücret yok.
Geçen süre: 40 ms65 uç nokta kullanılabilir

Otuz dört milyon satır. Tek adım.
Örnek uygulamalar
Nerede değer katar
Taşıyıcı görmeden önce
Gönderi etiketi satın alınmadan önce kontrol edilmiş ve normalleştirilmiş bir adres. Reddedilen bir etiket ücrete ve bir güne mal olur; reddedilen bir posta kodu yirmi milisaniyeye mal olur.
Muhasebeci görmeden önce
Fatura düzenlenmeden önce doğrulanmış bir para birimi kodu ve ülke kodu; bu, fatura gönderildikten sonra doğrulamaktan oldukça daha ucuzdur.
Bir listeyi tekilleştirme
Aynı müşteriye ait iki kayıt, aynı şehrin iki yazımıyla duruyorsa, her iki şehir de aynı tanımlayıcıya çözümlendiğinde doğru şekilde birleştirilir.
Coğrafyaya göre yönlendirme
Müşterinin koordinatları ve depolarınızın koordinatları; işlem, kimsenin posta kodu–depoyu eşleştiren bir tablo tutmasına gerek kalmadan en yakın depoyu seçer.
Dil, doğru şekilde
Bir ülke dillerine çözümlenir; böylece giden ileti, alıcının büyük olasılıkla okuduğu bir dilde olur — bir bayrak hakkındaki varsayımla değil, veriyle karar verilir.
Filolar ve lojistik
Araç markaları, havaalanları ve deniz limanları kanonik kayıtlar olarak; işi fiziksel olarak bir şeyin hareketini içeren iş akışları için.
Dürüst sınırlar
Bu, kamuya açık referans verisidir, ticari bir adres doğrulama hizmeti değil. 53-332'nin Wrocław'da gerçek bir posta kodu olduğunu ve yerleşimin koordinatlarını size söyler. 5 numarada 212 numaralı dairenin var olup olmadığını veya orada kimsenin yaşayıp yaşamadığını söylemez. Teslimat noktası düzeyinde doğrulama için ulusal bir posta operatörünün ürününe bakmanız gerekir; bir iş akışı bununla birlikte HTTP üzerinden birini çağırabilir.
Ayrıca kişisel veri kaynağı da değildir. İçinde insan yoktur. Yerler, kodlar, kayıtlar ve kamuya açık olgular içerir — kimlik doğrulaması olmadan sunulabilmesinin nedeni tam olarak budur.
Tazelik hakkında: referans verisi yavaş değişir ve bu, sürekli yerine zamanlamaya göre yenilenir. Yeni adı değişmiş bir köy aynı öğleden sonra görünmez. Saatlik ölçekte değişen her şey için, tam olarak bunun için inşa edilmiş olay akışına bakmanız gerekir.