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

Hedef

Bir geliştirici olarak, çoğu zaman Google'a ait olmayan ve kalitesi iyi olmayabilir. URL'ler için adreslerin doğruluğundan gibi birçok kullanım alanı bulunur.

Adres Doğrulama API, Adres doğrulamak için kullanabileceğiniz Google Haritalar Platformu'nu kullanabilirsiniz. Ancak yalnızca tek seferde bir adres işler. Bu belgede, bu özelliği nasıl API testinden farklı senaryolarda Yüksek Hacimli Adres Doğrulaması tek seferlik ve yinelenen adres doğrulamasına.

Kullanım alanları

Şimdi, Yüksek Hacimli Adres Doğrulama özelliğinin faydalı olur.

Test

Genellikle Adres Doğrulama API'sini binlerce farklı kod adres. Adresler, Virgülle Ayrılmış Değer dosyasında olabilir ve emin olmak için testler yapın.

Tek seferlik adresleri doğrulama

Address Validation API'ye ilk katılım sırasında mevcut adres veritabanını kapsamaz.

Yinelenen adreslerin doğrulanması

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

  • Yakalanan ayrıntılar için adresleri doğrulamak üzere planlanmış işleriniz olabilir (ör. müşteri kayıtlarından, sipariş ayrıntılarından, teslimattan) hakkında bilgi edindiniz.
  • Farklı departmanlardan, çeşitli departmanlardan çeşitli alanlarda eğitim vermiştir. Sertifikayı alan yeni departman genellikle kullanmadan önce bunları doğrulamak ister.
  • Anketler sırasında veya çeşitli tanıtımlar sırasında ve daha sonra bu adresleri toplayabilirsiniz sistemde de güncelleme yapılmasını sağlar. Adreslerin şu şekilde olduğunu doğrulamak istiyorsunuz: doğru olduğundan emin olun.

Ayrıntılı teknik inceleme

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

  • Bir müşterinin sağladığı adreslerle Address Validation API'yi çağırıyorsunuz veritabanı (ör. müşteri ayrıntılarını içeren bir veritabanı)
  • Geçerlilik işaretlerini, veritabanınızdaki tek tek adreslerde önbelleğe alabilirsiniz.
  • Geçerlilik işaretleri, aşağıdaki durumlarda Address Validation API'den alınır: giriş yaptığından emin olun.

Üretim kullanımı için önbellek

Address Validation API kullanırken genellikle API çağrısından gelen bir yanıt alınır. Şartlarımız Hizmet sınırı hangi verilerin önbelleğe alınabileceğini, Address Validation API'de önbelleğe alınabilen tüm verileri bir kullanıcı hesabına göre önbelleğe alınmalıdır. Bu durum, veritabanında adres veya adres meta verileri, kullanıcının e-posta adresine göre önbelleğe alınmalıdır birincil kimlik olabilir.

Yüksek Hacim Adres Doğrulaması kullanım alanında, verileri önbelleğe alma aşağıdaki şartlara uygun olmalıdır: Address Validation API Hizmete Özgü Şartlar, Bölüm 11.3’te açıklandığı şekilde inceleyin. Bu bilgiler doğrultusunda şunları yapabilirsiniz: kullanıcının adresinin geçersiz olup olmadığını belirler. Bu durumda, daha sonra tekrar etkileşime girmesi durumunda düzelteceğiniz bir adres kabul edersiniz.

  • AddressComponent üzerindeki veriler nesne
    • confirmationLevel
    • inferred
    • spellCorrected
    • replaced
    • unexpected

Gerçek adresle ilgili herhangi bir bilgiyi önbelleğe almak isterseniz, söz konusu veriler yalnızca kullanıcının izniyle önbelleğe alınmalıdır. Böylece kullanıcılar belirli bir hizmetin, adresini neden sakladığını ve bu adresi sakladığını adresini paylaşmalarını ister.

Kullanıcı iznine örnek olarak bir e-ticaret adresiyle doğrudan etkileşim verilebilir. ödeme sayfasındaki form. Program boyunca bilgileri önbelleğe alıp bir paketi göndermek amacıyla adresi işleme alabilir.

Kullanıcının izniyle formattedAddress ve diğer önemli bileşenleri önbelleğe alabilirsiniz kullanıcı olabilir. Ancak gözetimsiz bir senaryoda kullanıcı, olduğundan emin olun. Dolayısıyla, 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 kalitesi olduğundan emin olmalıdır:

  • Sonuç'taki addressComplete işaretçisi nesne true,
  • Karar'daki validationGranularity nesne PREMISE veya SUB_PREMISE
  • AddressComponent öğesinin hiçbiri şu şekilde işaretlenir:
    • Inferred(Not: inferred=true, addressComplete=true)
    • spellCorrected
    • replaced
    • unexpected ve
  • confirmationLevel: Sayfadaki onay düzeyi AddressComponent CONFIRMEDveyaUNCONFIRMED_BUT_PLAUSIBLE olarak ayarlandı

API yanıtı yukarıdaki işaretçileri içermiyorsa giriş adresi olduğunu ve zaman çizelgesine uyabilmeniz için veritabanınızda bulunan işaretleri gerekir. Önbelleğe alınan işaretler, bütün olarak adresin düşük kaliteli olduğunu gösterir. Yazım Düzeltildi gibi daha ayrıntılı işaretler belirli kalite sorununu çözmek. İşaretlenen bir adresle yapılan sonraki müşteri etkileşiminde adresini düşük kaliteli olacak şekilde ayarlayarak girin. Address Validation API, gönderdiğiniz düzeltilmiş adresi kullanıcı arayüzü istemi kullanarak görüntülenebilir. Müşteri, biçimlendirilmiş adresi kabul ettikten sonra yanıttaki şu bilgileri önbelleğe alabilirsiniz:

  • formattedAddress
  • postalAddress
  • addressComponent componentNamesveya
  • UspsData standardizedAddress

Gözetimsiz Adres doğrulaması uygulama

Yukarıdaki tartışmaya göre:

  • Genellikle Adres alanından yanıtın bir kısmının önbelleğe alınması İşle ilgili nedenlerle Validation API.
  • Ancak Şartlar ve Koşullar Hizmet: Google Haritalar Platformu, hangi verilerin önbelleğe alınabileceğini kısıtlamaktadır.

Aşağıdaki bölümde, uygunluk koşullarının nasıl karşılanacağına dair Hizmet Şartları'nı kabul edin ve yüksek hacimli adres doğrulaması uygulayın.

1. Adım:

İlk adımda, yüksek hacimli bir adresin nasıl uygulanacağına bakacağız doğrulama komut dosyasıyla düzenlemenizi sağlar. Bu süreç, Address Validation API yanıtındaki belirli alanları Hizmetle uyumluluk.

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

alt_text

Hizmet Şartları'na göre aşağıdaki verileri Google addressComponent:

  • confirmationLevel
  • inferred
  • spellCorrected
  • replaced
  • unexpected

Dolayısıyla, uygulamanın bu adımında yukarıda bahsedilenler değerlerini UserID'ye göre düzenleyin.

Daha fazla bilgi için gerçek verilerle ilgili ayrıntılara hakkında daha fazla bilgi edinin.

2. Adım:

1. adımda, giriş veri kümesindeki bazı adreslerin olması gerekir. Bir sonraki adımda, bu işaretli adresleri alacağız ve bunları kullanıcıya gösterip depolanan girin.

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

alt_text

  1. Kullanıcı giriş yaptığında öncelikle herhangi bir doğrulama işaretini önbelleğe alıp almadığınızı kontrol edin. inceleyebilirsiniz.
  2. İşaretler varsa kullanıcıya düzeltmesi ve adresini güncelleyebilir.
  3. Address Validation API'yi güncellenmiş veya önbelleğe alınmış konumla tekrar çağırabilirsiniz. ve düzeltilmiş adresi kullanıcıya onaylaması için sunun.
  4. Adres iyi kalitedeyse Address Validation API, bir formattedAddress
  5. Düzeltmeler yapılmışsa bu adresi kullanıcıya veya düzeltme yapılmazsa sessizce kabul edebilir.
  6. Kullanıcı kabul ettikten sonra, formattedAddress öğesini veritabanında önbelleğe alabilirsiniz.

Sonuç

Yüksek Hacimli Adres Doğrulama, karşılaşabileceğiniz yaygın bir kullanım alanıdır birçok uygulamada kullanılıyor. Bu belgede, bazı senaryoları ve bir projeyi Google Haritalar'a uygun olarak, böyle bir çözümün nasıl uygulanacağına ilişkin tasarım kalıbı Platform Hizmet Şartları.

Ayrıca, Yüksek Hacimli Adres uygulamasının bir referans uygulamasını da yazdık GitHub'da açık kaynak kitaplık olarak doğrulama. Başlamak için göz atın ile hızlıca oluşturabilirsiniz. Ayrıca, kitaplığın farklı senaryolarda nasıl kullanılacağını gösteren tasarım örüntüleri ortaya koymalıdır.

Sonraki Adımlar

Güvenilir adreslerle ödeme, teslimat ve işlemleri iyileştirme Teknik belge ve Adresle ödeme, teslimat ve işlemleri iyileştirme Doğrulama Web semineri.

Önerilen ek okuma:

Katkıda bulunanlar

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ühendis
Sarthak Ganguly | Çözümler Mühendis