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

Hedef

Geliştirici olarak genellikle iyi kalitede olmayabilecek müşteri adresleri içeren veri kümeleriyle çalışırsınız. Adreslerin, müşteri kimliği doğrulamasından teslimata kadar çeşitli kullanım alanları için 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 bu işlem tek seferde yalnızca bir adresi işler. Bu dokümanda, API testinden tek seferlik ve yinelenen adres doğrulamasına kadar farklı senaryolarda Yüksek Hacimli Adres Doğrulama'nın nasıl kullanılacağı ele alınacaktır.

Kullanım alanları

Şimdi Yüksek Hacimli Adres Doğrulaması'nın yararlı olduğu kullanım alanlarını inceleyeceğiz.

Test

Genellikle binlerce adres çalıştırarak Address Validation API'yi test etmek istersiniz. Adresler, virgülle ayrılmış değerler içeren bir dosyada olabilir ve adreslerin kalitesini doğrulamak isteyebilirsiniz.

Adreslerin tek seferlik doğrulanması

Address Validation API'ye ilk katılım sırasında mevcut adres veritabanınızı kullanıcı veritabanı ile doğrulamak istiyorsunuz.

Adreslerin tekrarlanan doğrulaması

Adreslerin tekrar tekrar doğrulanması gereken bazı senaryolar vardır:

  • Gün içinde yakalanan ayrıntılar (ör. müşteri kayıtları, sipariş ayrıntıları, teslimat programları) için adresleri doğrulayacak planlanmış işleriniz olabilir.
  • Satıştan pazarlamaya kadar farklı departmanlardan adresler içeren veri dökümleri alabilirsiniz. Adresleri alan yeni departman, genellikle bunları kullanmadan önce doğrulamak ister.
  • Anketler veya çeşitli promosyonlar sırasında adresleri toplayabilir ve daha sonra bunları online sistemde güncelleyebilirsiniz. Sisteme girerken adreslerin doğruluğunu doğrulamak istiyorsunuz.

Teknik ayrıntılı inceleme

Bu doküman kapsamında aşağıdakiler varsayılır:

  • Adres Doğrulama API'sini bir müşteri veritabanındaki (ör. müşteri ayrıntılarını içeren bir veritabanı) adreslerle çağırıyorsanız
  • Veritabanınıza ait adreslerin geçerlilik işaretlerini ayrı ayrı önbelleğe alabilirsiniz.
  • Bir müşteri giriş yaptığında geçerlilik işaretleri Address Validation API'den alınır.

Üretim kullanımı için önbelleğe alma

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ırlar. Ancak Address Validation API'den önbelleğe alınabilecek tüm veriler bir kullanıcı hesabına göre önbelleğe alınmalıdır. Bu, veritabanında adresin veya adres meta verilerinin, kullanıcının e-posta adresine ya da diğer birincil kimliğine göre önbelleğe alınması gerektiği anlamına gelir.

Yüksek Hacimli Adres Doğrulama kullanım alanı için veri önbelleğe alma, Bölüm 11.3'te belirtilen Adres Doğrulama API Hizmet Spesifik Şartları'na uygun olmalıdır. Bu bilgilere dayanarak, kullanıcının adresinin geçersiz olup olmadığını belirleyebilirsiniz. Bu durumda, kullanıcıdan uygulamanızla bir sonraki etkileşimi sırasında düzeltilmiş bir adres girmesini isteyebilirsiniz.

  • AddressComponent nesnesinden alınan veriler
    • confirmationLevel
    • inferred
    • spellCorrected
    • replaced
    • unexpected

Gerçek adresle ilgili bilgileri önbelleğe almak istiyorsanız bu veriler yalnızca kullanıcının izniyle önbelleğe alınmalıdır. Bu sayede kullanıcı, belirli bir hizmetin adresini neden depoladığını ve adresini paylaşma şartlarına uyup uymadığını bilir.

Kullanıcı rızası örneği olarak, ödeme sayfasındaki bir e-ticaret adres formu ile doğrudan etkileşim verilebilir. Paket göndermek amacıyla adresi önbelleğe alıp işleyeceğiniz anlaşılıyor.

Kullanıcının izniyle, yanıttaki formattedAddress ve diğer önemli bileşenleri önbelleğe alabilirsiniz. Ancak headless senaryoda, adres doğrulaması arka uçtan yapıldığı için kullanıcı izin veremez. Bu nedenle, bu headless senaryoda çok sınırlı bilgileri önbelleğe alabilirsiniz.

Yanıtı anlama

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

  • Verdict nesnesinde addressComplete işaretçisi true'tır.
  • Verdict nesnesinde validationGranularity değeri PREMISE veya SUB_PREMISE olmalıdır.
  • AddressComponent öğelerinin hiçbiri şu şekilde işaretlenmemelidir:
    • Inferred(Not: inferred=trueaddressComplete=true olduğunda gerçekleşebilir)
    • spellCorrected
    • replaced
    • unexpected ve
  • confirmationLevel: AddressComponent öğesindeki onay düzeyiCONFIRMED veyaUNCONFIRMED_BUT_PLAUSIBLE olarak ayarlanmıştır

API yanıtı yukarıdaki işaretçileri içermiyorsa giriş adresi muhtemelen düşük kalitelidir ve bunu yansıtmak için veritabanınızda işaretçileri önbelleğe alabilirsiniz. Önbelleğe alınmış işaretler, adresin bir bütün olarak kalitesinin düşük olduğunu gösterirken Yazım Düzeltildi gibi daha ayrıntılı işaretler, adres kalitesi sorununun türünü belirtir. Düşük kaliteli olarak işaretlenmiş bir adresle yapılan bir sonraki müşteri etkileşimde, mevcut adresle Address Validation API'yi çağırabilirsiniz. Adres Doğrulama API'si, 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ıttan aşağıdakileri önbelleğe alabilirsiniz:

  • formattedAddress
  • postalAddress
  • addressComponent componentNamesveya
  • UspsData standardizedAddress

Başsız adres doğrulaması uygulama

Yukarıdaki tartışmaya göre:

  • İş nedeniyle Address Validation API'den gelen yanıtın bir kısmını önbelleğe almak genellikle gereklidir.
  • Ancak Google Haritalar Platformu'ndaki Hizmet Şartları, hangi verilerin önbelleğe alınabileceğini kısıtlar.

Aşağıdaki bölümde, Hizmet Şartları'na uygunluk ve yüksek hacimli adres doğrulamasını uygulamayla 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 bir adres doğrulama komut dosyasının nasıl uygulanacağını inceleyeceğiz. Bu işlem, Adres Doğrulama API yanıtındaki belirli alanları Hizmet Şartları'na uygun şekilde depolamanıza olanak tanır.

A Şeması: 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'ten aşağıdaki verileri önbelleğe alabilirsiniz:

  • confirmationLevel
  • inferred
  • spellCorrected
  • replaced
  • unexpected

Bu nedenle, uygulamanın bu adımında yukarıda belirtilen alanları User-ID'ye göre önbelleğe alacağız.

Daha fazla bilgi için gerçek veri yapısı ile ilgili ayrıntıları inceleyin.

2. Adım:

1. adımda, giriş veri kümesindeki bazı adreslerin yüksek kaliteli olmayabileceğine dair geri bildirim topladık. Sonraki adımda, işaretlenen bu adresleri kullanıcıya sunar ve saklanan adresi düzeltmesi için kullanıcıdan izin alırız.

B şeması: Bu şemada, kullanıcı izni akışının uçtan uca entegrasyonu nasıl görünebileceği gösterilmektedir:

alt_text

  1. Kullanıcı giriş yaptığında, önce sisteminizde herhangi bir doğrulama işareti önbelleğe alıp almadığınızı kontrol edin.
  2. İşaret varsa kullanıcıya adresini düzeltmesi ve güncellemesi için bir kullanıcı arayüzü sunmanız gerekir.
  3. Adres Doğrulama API'sini güncellenmiş veya önbelleğe alınmış adresle tekrar çağırabilir ve düzeltilen adresi kullanıcıya onaylaması için sunabilirsiniz.
  4. Adres iyi kalitedeyse Address Validation API bir formattedAddress döndürür.
  5. Düzeltme yapılmışsa 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ğrulaması, birçok uygulamada karşılaşabileceğiniz yaygın bir kullanım alanıdır. Bu dokümanda, Google Haritalar Platformu Hizmet Şartları'na uygun bir çözümün nasıl uygulanacağına dair bazı senaryolar ve tasarım kalıbı gösterilmeye çalışılmaktadır.

Ayrıca, GitHub'da yüksek hacimli adres doğrulamasının açık kaynak kitaplığı olarak referans bir uygulamasını yazdık. Yüksek Hacimli Adres Doğrulaması ile hızlıca çalışmaya başlamak için bu makaleyi inceleyin. Ayrıca, kitaplığın farklı senaryolarda nasıl kullanılacağıyla ilgili tasarım kalıpları makalesini de ziyaret edin.

Sonraki Adımlar

Güvenilir adreslerle ödeme, teslimat ve işlemleri iyileştirin teknik belgesini indirin ve Adres Doğrulama ile ödeme, teslimat ve işlemleri iyileştirin webinar'ını izleyin.

Önerilen diğer kaynaklar:

Katkıda bulunanlar

Bu makale Google tarafından yönetilmektedir. Bu makaleyi ilk olarak aşağıdaki katkıda bulunanlar yazmıştır.
Başlıca yazarlar:

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