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

Hedef

Bir geliştirici olarak genellikle iyi kalitede olmayabilecek müşteri adreslerini içeren veri kümeleriyle çalışırsınız. Müşteri kimliği doğrulamasından teslimata kadar çeşitli kullanım alanlarında adreslerin doğru olduğundan emin olmanız gerekir.

Address Validation API, bir adresi doğrulamak için kullanabileceğiniz Google Haritalar Platformu ürünüdür. Ancak aynı anda yalnızca bir adresi işler. Bu belgede, API testinden tek seferlik ve yinelenen adres doğrulamaya kadar farklı senaryolarda Yüksek Hacimli Adres Doğrulama özelliğini nasıl kullanacağınızı göreceğiz.

Kullanım alanları

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

Test

Adres Doğrulama API'sini genellikle binlerce adres çalıştırarak test etmek istersiniz. Adresler bir Virgülle Ayrılmış Değer dosyasında bulunuyor ve bu adreslerin kalitesini doğrulamak isteyebilirsiniz.

Adresleri tek seferlik 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 istiyorsunuz.

Adreslerin yinelenen doğrulaması

Çeşitli senaryolarda adreslerin tekrar tekrar doğrulanması gerekir:

  • Gün boyunca yakalanan ayrıntılar için (ör. müşteri kayıtları, sipariş ayrıntıları, teslimat programları) adresleri doğrulamak üzere planlanmış işleriniz olabilir.
  • Satıştan pazarlamaya kadar farklı departmanların adreslerini içeren veri dökümleri alabilirsiniz. Adresleri alan yeni departman genellikle bunları kullanmadan önce doğrulamak ister.
  • Adresleri anketler veya çeşitli tanıtımlar sırasında toplayabilir, sonra da online sistemde güncelleyebilirsiniz. Sisteme girilen adreslerin doğru olduğundan emin olmak istiyorsunuz.

Ayrıntılı teknik inceleme

Bu belgenin amaçları doğrultusunda, aşağıdakilerin kabul edildiğini varsayarız:

  • 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 farklı adreslere göre önbelleğe alabilirsiniz.
  • Geçerlilik işaretleri, bağımsız 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ırır ancak Address Validation API'den önbelleğe alınabilecek tüm veriler kullanıcı hesabına göre önbelleğe alınmalıdır. Bu, veritabanında adres veya adres meta verilerinin kullanıcının e-posta adresi ya da başka bir birincil kimliğe göre önbelleğe alınması gerektiği anlamına gelir.

Yüksek Hacimli Adres Doğrulama kullanım alanı için verileri önbelleğe almanın, Bölüm 11.3'te açıklanan Address Validation API Hizmete Özel Şartları'na uyması gerekir. Bu bilgilere dayanarak, bir kullanıcının adresinin geçersiz olup olmadığını belirleyebilirsiniz. Bu durumda, uygulamanızla bir sonraki etkileşimi sırasında kullanıcıdan doğru adresi girmenizi istersiniz.

  • AddressComponent nesnesinden alınan 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 izniyle önbelleğe alınmalıdır. Bu, kullanıcının belirli bir hizmetin adresini neden sakladığının bilincinde olmasını ve adresini paylaşma konusunda sorun yaşamamasını sağlar.

Kullanıcı iznine örnek olarak, bir ödeme sayfasındaki e-ticaret adres formuyla doğrudan etkileşim verilebilir. Paket gönderiminde adresi önbelleğe alıp işleyeceğinize dair bir anlayış var.

Kullanıcının izniyle, yanıttaki formattedAddress ve diğer temel bileşenleri önbelleğe alabilirsiniz. Ancak, gözetimsiz bir senaryoda adres doğrulaması arka uçtan gerçekleştiği için kullanıcılar izin veremez. Bu nedenle, bu gözetimsiz senaryoda çok sınırlı bilgiyi önbelleğe alabilirsiniz.

Yanıtı anlama

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

  • Karar nesnesindeki addressComplete işaretçisi true,
  • Sonuç nesnesindeki validationGranularity, PREMISE veya SUB_PREMISE şeklindedir.
  • 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üzeyiCONFIRMEDveyaUNCONFIRMED_BUT_PLAUSIBLE olarak ayarlanmıştır

API yanıtı yukarıdaki işaretçileri içermiyorsa giriş adresi büyük olasılıkla düşük kalitededir ve bunu yansıtacak şekilde veritabanınızda işaretleri önbelleğe alabilirsiniz. Önbelleğe alınan işaretler adresin bir bütün olarak düşük kaliteli olduğunu belirtirken, Yazım Düzeltildi gibi daha ayrıntılı işaretler, adres kalitesi sorununun belirli bir türünü belirtir. Müşterinin düşük kaliteli olarak işaretlenmiş bir adresle kurduğu bir sonraki müşteri etkileşiminde, Address Validation API'yi mevcut adresle çağırabilirsiniz. Address Validation API, 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 aşağıdakileri yanıttan önbelleğe alabilirsiniz:

  • formattedAddress
  • postalAddress
  • addressComponent componentNamesveya
  • UspsData standardizedAddress

Gözetimsiz Adres doğrulaması uygulama

Yukarıdaki tartışmaya göre:

  • İşle ilgili nedenlerle, Adres Doğrulama API'sinden gelen yanıtın bir kısmını önbelleğe almak 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 uyma ve yüksek hacimli adres doğrulamasını uygulama ile 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 şema, bir veri ardışık düzeninin Yüksek Hacimli Adres Doğrulama mantığıyla nasıl geliştirilebileceğini göstermektedir.

alt_text

Hizmet Şartları uyarınca aşağıdaki verileri addressComponent üzerinden ö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ı ile ilgili ayrıntılara bakın.

2. Adım:

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

B diyagramı: 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, önce 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üncellenen veya önbelleğe alınan adresle tekrar çağırabilir ve düzeltilmiş adresi onaylaması için kullanıcıya sunabilirsiniz.
  4. Adres iyi kalitedeyse Address Validation API, bir formattedAddress döndürür.
  5. Düzeltme yapıldıysa bu adresi kullanıcıya sunabilir veya 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 böyle bir çözümün nasıl uygulanacağına ilişkin bazı senaryolar ve bir tasarım kalıbı gösterilmektedir.

Ayrıca, GitHub'da açık kaynak kitaplık olarak Yüksek Hacimli Adres Doğrulama uygulamasının bir referans yöntemi de hazırladık. Yüksek Hacimli Adres Doğrulama ile hızlıca derlemeye başlamak için göz atın. Kitaplığın farklı senaryolarda nasıl kullanılacağına ilişkin tasarım kalıpları hakkındaki makaleyi de inceleyebilirsiniz.

Sonraki adımlar

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

Önerilen daha fazla bilgi:

Katılımcılar

Bu makale Google tarafından saklanmaktadır. Mesajı ilk olarak aşağıdaki katkıda bulunanlar yazmış.
Baş yazarlar:

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