Adresleri yüksek hacimde işlemek için Adres Doğrulama API'sini kullanma

Hedef

Geliştirici olarak, çoğu zaman müşteri adreslerini içeren veri kümeleriyle çalışırsınız. Bu veri kümeleri iyi kalitede olmayabilir. Müşteri kimliği doğrulamasından teslimata ve diğer birçok kullanım alanı için adreslerin doğru olduğundan emin olmanız gerekir.

Adres Doğrulama API'si, bir adresi doğrulamak için kullanabileceğiniz Google Haritalar Platformu ürünüdür. Ancak, bir defada yalnızca bir adresi işler. Bu belgede, Yüksek Hacimli Adres Doğrulaması'nın API testinden tek seferlik ve yinelenen adres doğrulamaya kadar farklı senaryolarda nasıl kullanılacağına bakacağız.

Kullanım alanları

Şimdi, Yüksek Hacimli Adres Doğrulama özelliğinin faydalı olduğu kullanım alanlarını öğreneceğiz.

Test

Genellikle binlerce adres çalıştırarak Address Validation API'yi test etmek istersiniz. Adresler, Virgülle Ayrılmış Değer dosyasında olabilir ve adreslerin kalitesini doğrulamak isteyebilirsiniz.

Tek seferlik adresleri doğrulama

Address Validation API'ye ilk katılım sırasında mevcut adres veritabanınızı kullanıcı veritabanına göre doğrulamak istersiniz.

Yinelenen adreslerin doğrulanması

Bazı senaryolarda, adreslerin yinelenen bir şekilde doğrulanması gerekir:

  • Gün içinde yakalanan ayrıntıların (örneğin, müşteri kayıtları, sipariş ayrıntıları, teslimat planları) doğrulanması için planlanmış işleriniz olabilir.
  • Satıştan pazarlamaya kadar farklı departmanlardan adresler içeren veri dökümleri alabilirsiniz. Adresleri alan yeni departman genellikle kullanmadan önce adresleri doğrulamak ister.
  • Anketler sırasında veya çeşitli tanıtımlar sırasında adres alabilir, daha sonra online sistemde güncelleme yapabilirsiniz. Sisteme girerken adreslerin doğru olduğunu doğrulamak istiyorsunuz.

Ayrıntılı teknik inceleme

Bu belgenin amaçları doğrultusunda, aşağıdaki hususları varsayıyoruz:

  • Address Validation API'yi bir müşteri veritabanındaki (ör. müşteri ayrıntılarını içeren bir veritabanı) adreslerle çağırıyorsunuz
  • Geçerlilik işaretlerini, veritabanınızdaki tek tek adreslerde önbelleğe alabilirsiniz.
  • Geçerlilik işaretleri, belirli bir müşteri giriş yaptığında Address Validation API'den alınır.

Üretim kullanımı için önbellek

Address Validation API'yi kullanırken genellikle API çağrısından gelen yanıtın bir kısmını önbelleğe almak istersiniz. Hizmet Şartlarımız hangi verilerin önbelleğe alınabileceğini sınırlandırsa da Address Validation API'de önbelleğe alınabilen tüm verilerin bir kullanıcı hesabına göre önbelleğe alınması gerekir. Bu da veritabanında adresin veya adres meta verilerinin kullanıcının e-posta adresine ya da başka bir birincil kimliğe göre önbelleğe alınması gerektiği anlamına gelir.

Yüksek Hacim Adres Doğrulama kullanım alanı için veri önbelleğe alma işlemi, Bölüm 11.3'te açıklanan Address Validation API Hizmete Özgü Şartları'na uygun olmalıdır. Bu bilgilere dayanarak bir kullanıcının adresinin geçersiz olup olmadığını belirleyebilirsiniz. Bu durumda, uygulamanızla bir sonraki etkileşiminde kullanıcıdan düzeltilmiş adresi isteyin.

  • AddressComponent nesnesindeki veriler
    • confirmationLevel
    • inferred
    • spellCorrected
    • replaced
    • unexpected

Gerçek adresle ilgili herhangi bir bilgiyi önbelleğe almak istiyorsanız bu veriler yalnızca kullanıcının izni olduğunda önbelleğe alınmalıdır. Bu, kullanıcının belirli bir hizmetin adresini neden sakladığının farkında olmasını ve adresini paylaşmakta bir sakınca görmemesini sağlar.

Kullanıcı iznine örnek olarak ödeme sayfasındaki e-ticaret adresi formuyla doğrudan etkileşim verilebilir. Paket göndermek amacıyla adresi önbelleğe alıp işleyeceğinize dair bir anlayış vardır.

Kullanıcının izniyle, formattedAddress ve diğer önemli bileşenleri önbelleğe alabilirsiniz. Ancak gözetimsiz bir senaryoda adres doğrulama işlemi arka uçtan yapıldığından kullanıcı izin veremez. Bu nedenle, bu gözetimsiz senaryoda çok sınırlı bilgileri önbelleğe alabilirsiniz.

Yanıtı anlama

Address Validation API yanıtında aşağıdaki işaretçiler varsa giriş adresinin teslimat kalitesinde olduğundan emin olabilirsiniz:

  • Sonuç nesnesindeki addressComplete işaretçisi true şeklindedir.
  • Sonuç nesnesindeki validationGranularity, PREMISE veya SUB_PREMISE
  • AddressComponent öğelerinin hiçbiri şu şekilde işaretlenmez:
    • Inferred(Not: inferred=trueşu durumlarda gerçekleşebilir: addressComplete=true)
    • spellCorrected
    • replaced
    • unexpected ve
  • confirmationLevel: AddressComponent'taki onay düzeyi CONFIRMEDveyaUNCONFIRMED_BUT_PLAUSIBLE olarak ayarlandı

API yanıtı yukarıdaki işaretçileri içermiyorsa giriş adresi muhtemelen düşük kalitelidir ve bunu yansıtmak için veritabanınızdaki işaretleri önbelleğe alabilirsiniz. Önbelleğe alınan işaretler, adresin tamamının düşük kaliteli olduğunu gösterir. Yazım Düzeltildi gibi daha ayrıntılı işaretler ise adres kalitesi sorununun belirli türünü belirtir. Müşterinin düşük kaliteli olarak işaretlenen bir adresle bir sonraki etkileşiminde, Address Validation API'yi mevcut adresle çağırabilirsiniz. Address Validation API, bir kullanıcı arayüzü istemi kullanarak görüntüleyebileceğiniz düzeltilmiş adresi döndürür. Müşteri biçimlendirilmiş adresi kabul ettikten sonra, yanıttaki bilgileri önbelleğe alabilirsiniz:

  • formattedAddress
  • postalAddress
  • addressComponent componentNamesveya
  • UspsData standardizedAddress

Gözetimsiz Adres doğrulaması uygulama

Yukarıdaki tartışmaya göre:

  • İşle ilgili nedenlerle, AddressValidation API'den gelen yanıtın bir kısmının önbelleğe alınması genellikle gerekir.
  • Ancak Google Haritalar Platformu'ndaki Hizmet Şartları, hangi verilerin önbelleğe alınabileceğini kısıtlamaktadır.

Aşağıdaki bölümde, Hizmet Şartları'na uygunluk ve yüksek hacimli adres doğrulamasının nasıl uygulanacağıyla ilgili iki adımlı bir süreci ele alacağız.

1. Adım:

İlk adımda, mevcut bir veri ardışık düzeninden yüksek hacimli adres doğrulama komut dosyasının nasıl uygulanacağına bakacağız. Bu işlem, Address Validation API yanıtındaki belirli alanları Hizmet Şartları'na uygun bir şekilde depolamanıza olanak tanır.

A diyagramı: Aşağıdaki şemada, bir veri ardışık düzeninin Yüksek Hacimli Adres Doğrulama mantığıyla nasıl geliştirilebileceği gösterilmektedir.

alt_text

Hizmet Şartları uyarınca addressComponent üzerinden aşağıdaki verileri önbelleğe alabilirsiniz:

  • confirmationLevel
  • inferred
  • spellCorrected
  • replaced
  • unexpected

Dolayısıyla, uygulamanın bu adımında yukarıda bahsedilen alanları UserID'ye göre önbelleğe alırız.

Daha fazla bilgi için gerçek veri yapısındaki ayrıntılara bakın.

2. Adım:

1. adımda, giriş veri kümesindeki bazı adreslerin yüksek kaliteli olmayabileceğine dair geri bildirim topladık. Bir sonraki adımda, bu işaretli adresleri alıp kullanıcıya sunacağız ve kayıtlı adresin düzeltilmesi için kullanıcıdan izin alacağız.

B şeması: Bu şema, kullanıcı izin akışının uçtan uca entegrasyonunun nasıl görünebileceğini gösterir:

alt_text

  1. Kullanıcı giriş yaptığında, öncelikle sisteminizde herhangi bir doğrulama işaretini önbelleğe alıp almadığınızı kontrol edin.
  2. İşaretler varsa kullanıcıya adresini düzeltmesi ve güncellemesi için bir kullanıcı arayüzü sunmanız gerekir.
  3. Address Validation API'yi güncellenmiş veya önbelleğe alınmış adresle tekrar çağırabilir ve onaylaması için düzeltilmiş adresi kullanıcıya sunabilirsiniz.
  4. Adres iyi kalitedeyse Address Validation API bir formattedAddress döndürür.
  5. Düzeltmeler yapıldıysa bu adresi kullanıcıya sunabilir ya da düzeltme yoksa, sessizce kabul edebilirsiniz.
  6. Kullanıcı kabul ettikten sonra, formattedAddress öğesini veritabanında önbelleğe alabilirsiniz.

Sonuç

Yüksek Hacimli Adres Doğrulama, birçok uygulamada karşılaşabileceğiniz yaygın bir kullanım alanıdır. Bu belgede, Google Haritalar Platformu Hizmet Şartları'na uygun olarak bu tür bir çözümün nasıl uygulanacağıyla ilgili bazı senaryoları ve tasarım kalıbını göstermeye çalışılmaktadır.

Ayrıca, GitHub'da Yüksek Hacimli Adres Doğrulaması'nın bir açık kaynak kitaplık uygulaması olan referans uygulamasını da yazdık. Yüksek Hacimli Adres Doğrulaması ile derlemeye hızlıca başlamak için göz atın. Ayrıca, kitaplığın farklı senaryolarda nasıl kullanılacağını gösteren tasarım modelleri ile ilgili makaleyi de inceleyin.

Sonraki adımlar

Güvenilir adreslerle ödeme, teslimat ve işlemleri iyileştirme teknik belgesini indirin ve Adres doğrulaması ile ödeme, teslimat ve işlemleri iyileştirme web seminerini görüntüleyin.

Önerilen ek okuma:

Katılımcılar

Bu makale Google tarafından saklanır. İlk olarak aşağıdaki katkıda bulunanlar yazmış.
Ana yazarlar:

Henrik Valve | Çözüm Mühendisi
Thomas Anglaret | Çözümler Mühendisi
Sarthak Ganguly | Çözüm Mühendisi