Doğrulama mantığınızı oluşturun

Bu dokümanda, amacınız doğrultusunda bir adres denetim sistemi oluşturmak için Address Validation API'den gelen çeşitli yanıtları işleme. Bu videoda ise yanıtı doğru kullanmak, diğer sinyalleri incelemek ve hakkında daha fazla bilgi edinebileceğiniz hakkında daha fazla bilgi edinin.

Genel olarak API yanıtı, sisteminizin bunu yapması için aşağıdaki adımları şu adresi işle:

  • . Düzelt: Adresin kalitesi düşük. Daha fazla bilgi için istemde bulunmalısınız.
  • . Onayla: Adres yüksek kalitede ancak farklı olabilir. Bir ekip üyesine onayı.
  • . Kabul et: Adres yüksek kalitededir. Şunları yapabilirsiniz: sağlanan adresi kabul edin.

Temel amaç

Bu belge, sisteminizi API yanıtını en iyi şekilde analiz edecek ve sağlanan adreslerle ilgili yapılacak işlemleri belirler. Aşağıdakiler sözde kod olası bir akışı gösterir.

if (the API response indicates significant problems in the address)
    FIX - prompt the user to fix the address
else if (the API response indicates less significant problems in the address)
    CONFIRM - confirm with the user that the address is correct
else
    ACCEPT - continue with the address returned by the API.

Kesin mantık durumunuza göre değişir. Uygulama kılavuzu başlıklı makaleyi inceleyin. inceleyebilirsiniz. İsterseniz bu mantığın açık kaynak uygulamamızı kullanarak Genişletilmiş Bileşen Kitaplığı'nda bulabilirsiniz.

İş akışına genel bakış

Aşağıdaki tabloda sisteminiz için iki işlem özetlenmiştir:

  1. Düzeltmeye göre kullanılacak iş akışı, onaylama, kabul etme davranışı.
  2. Yanıtta kontrol edilmesi gereken ilk sinyaller. Sinyaller açıklamaları verdict özelliğinden gelir ve tek başına yeterli değildir. emin olmak için güvenli URL'ler, ancak adres için bir başlangıç kalitedir. Her davranış türü bu belgedeki bir bölüme karşılık gelir ve incelemeniz gerekebilecek diğer sinyalleri
Sistem davranışınız
. Adresi düzeltme

verdict tarafından verilen yanıt, önemli eksiklikleri gösteriyor bilgi verilmelidir. URL'nin döndürdüğü adres Address Validation API, teslimat kalitesinde olmayabilir.

İş akışı

  1. Gerekirse adres bileşenlerini araştırın.
  2. Müşteriden adres sorunlarını düzeltmesini isteyin.
  3. Güncellenen adres için doğrulama isteyin.
  4. (İsteğe bağlı) API'nin geri bildirim uç noktasına bir istek gönderin. Güncellenen adresleri işleme alma başlıklı makaleye göz atın.
  5. Adresle devam et.

Sonuç sinyalleri

Aşağıdakilerden herhangi biri geçerlidir:

. Adresi onaylayın

verdict'nin yanıtı, bir teslimat olduğunu gösteriyor ancak orijinal girişte değişiklik yaptı: yazımı düzeltildi veya verileri doğrulanabilir.

İş akışı

  1. Düzeltmeler gerekiyor:
    1. Gerekirse adres bileşenlerini araştırın.
    2. Güncellenen adres için doğrulama isteyin.
    3. (İsteğe bağlı) API'nin geri bildirim uç noktasına bir istek gönderin. Güncellenen adresleri işleme alma başlıklı makaleye göz atın.
    4. Adresle devam et.
  2. Düzeltme gerekmez:
    1. (İsteğe bağlı) API'nin geri bildirim uç noktasına bir istek gönderin. Güncellenen adresleri işleme alma başlıklı makaleye göz atın.
    2. Adresle devam et.

Sonuç sinyalleri

Aşağıdakilerin tümü geçerlidir:

  • validationGranularity, ROUTE değerini içeriyor veya daha iyisi olabilir. Ayrıntı düzeyini inceleyin değerler.
  • addressComplete true.
  • hasInferredComponents alanı true VEYA hasReplacedComponents alanı true.
. Adresi kabul edin

Address Validation API yanıtı, mükemmel kalite adresini gösteriyor.

İş akışı

Döndürülen adresle devam edin.

Sonuç sinyalleri

Aşağıdakilerin tümü geçerlidir:

  • validationGranularity, PREMISE değerini içeriyor veya daha iyisi olabilir. Ayrıntı düzeyi değerlerini inceleyin.
  • addressComplete true.
  • Tahmin edilen veya değiştirilen bileşen yoktur.

Uygulama kılavuzu

Sisteminizin Address Validation API'den gelen sinyallere nasıl yanıt vereceğini tasarlarken, aşağıdaki öneriler daha etkili bir yanıt oluşturmanıza yardımcı olabilir modeli. Ancak, bunlar yalnızca öneridir. Bu nedenle, iş modelinize uygun olması gerektiğini unutmayın.

Rehberlik Ayrıntılar
Risk düzeyi

Erişim düzeyini ikiniz için de uygun olan talep ve talep arasında bir denge kurarken ve adres girildiği şekliyle kabul edilir.

Address Validation API, çeşitli sinyaller döndürür doğrulamanızı optimize etmek için risk düzeyinize dahil edebileceğiniz bahsedeceğim.

Örneğin, bir adresin onaylanmamış sokak numarası varsa, şunları yapabilirsiniz: kabul etmelisiniz. Diğer yandan, işletmenizin faaliyetleri daha fazla adres kesinliği söz konusu olduğunda, kullanıcınıza istekte bulunabilirsiniz. Örneğin, herhangi bir kategoriye girebilir. ABD dışı onaylanmamış sokak numarası bölümüne bakın. Adresi kabul et - örnekler başlıklı makaleyi inceleyin.

Adresleri kabul et

Sisteminizin orijinal girişi kabul etmesine izin vermek iyi bir uygulamadır. müşteri istemlere yanıt vermiyorsa.

Bu durumlarda, müşteri aşağıdaki durumlarda olmayan bir adres girmiş olabilir: örneğin yeni inşaat için kullanılabilir.

Geri bildirim sağlama

Bir adres doğrulama isteğini yeniden gönderdiğinizde, provideValidationFeedback uç noktasına da istek gönderir.

Bu, Google'ın nihai yanıtı nasıl ele aldığınızı bildirir. Güncellenen adresleri işleme alma başlıklı makaleye göz atın.

Adres düzeltme

Sonuçlar, adresin farklı olduğunu açıkça gösterdiğinde bir adresi düzeltin teslimat olabilir. Ardından, sisteminiz müşteriden gerekli bilgileri sağlamasını isteyebilir. ve ardından bir teslimat almak üzere iş akışınızı yeniden girin.

Sinyalleri düzeltin

Address Validation API, bir düzeltilmelidir.

1. Doğrulama ayrıntı düzeyi ve eksik bileşenler

Aşağıdaki iki sinyal, sorunlu bir adres için en iyi göstergeyi sağlar:

  • validationGranularity alanı OTHER olduğunda, sisteminiz hatanın nerede olduğuyla ilgili daha fazla bilgi edinmek için adres bileşeni sinyallerini incelemek ve nasıl düzeltileceğini açıklayacağız.
  • İşlendikten sonra işlenen address nesnesi, missingComponentTypes alanında, sisteminizin bu bileşeni kontrol etmesi gerekir. Eksik bileşenler, ayrıca bir adresin eksik ve teslim edilememesine neden olur.

2. Diğer sinyaller

Address Validation API, kullanıcılara yardımcı olacak diğer sinyalleri de Belirli sorunları teşhis edin:

Şüpheli bileşenler Bir bileşenin onay düzeyi sıralaması UNCOMFIRMED_AND_SUSPICIOUS, muhtemelen bileşen yanlış.
Çözümlenmemiş bileşen unresolvedToken girişin, adresin geçerli bir bölümü olarak tanınmayan bir bölümüdür.

3. ABD adres sinyalleri

Yalnızca ABD'deki adresler için geçerli olan bazı alanlar, URL'lerin teslimat yapılamaz ve düzeltilmesi gerekir. Şunu gerektiren bir adres için: şu değişiklikleri görmeniz gerekir:

dpvConfirmation N, D veya boş.

dpvConfirmation hakkında ayrıntılı bilgi için bkz. ABD adreslerini işleyin.

Düzeltme adresi örnekleri

Bir adresi onaylayın

Karar, Address Validation API'nin olduğunu belirttiğinde bir adresi onaylarsınız. ya da bileşenler üzerinde tahminde bulunarak veya değişiklikler yapılarak doğrulanmış adrestir. Bu gibi durumlarda teslim edilebilir bir adresiniz olur ancak nihai adresin reklamveren tarafından hedeflenen adres olduğuna bir fırsattır.

Müşteriye doğru istemi sunmak için mantığınız, hangi işlemi belirlemek veya API'yi işaretlemek için hizmet tarafından işaretlenen bileşenler inferred, replaced veya spellCorrected gibi bileşene uygulanır. Referansta AddressComponent (Adres bileşeni) konusuna bakın.

Sinyalleri onaylama

Address Validation API, bir adresi onaylanmalıdır.

1. Doğrulama Ayrıntı Düzeyi

ROUTE veya daha iyi bir validationGranularity kabul edilir ancak İLK GÖSTERİM veya GÖNDERİM, teslim edilebilirliğe dair daha güçlü bir sinyal sağlar.

2. Diğer sinyaller

Müşteriyle adres girişini onaylamaya karar verirken karar, hangi bileşenlerin araştırılacağını belirlemek için aşağıdakileri sağlar:

Tahmin edilen veriler hasInferredComponents alanı true olduğunda, API'nin başka bir adresten topladığı bilgileri doldurduğunu biliyorsunuz bileşenlerine ayıralım.
Değiştirilen veriler hasReplacedComponents alanı true olduğunda, API, girilen verileri, adresi geçerli kıldığı verilerle değiştirdi.

3. ABD adres sinyalleri

Yalnızca ABD'deki adresler için geçerli olan belirli alanlar, mantığınızın Müşteriyle teyit almanız gerekir. Aşağıdakilerden biri geçerlidir:

dpvConfirmation S

dpvConfirmation hakkında ayrıntılı bilgi için bkz. ABD adreslerini işleyin.

Adres yanıtı Şu değere sahip missingComponentType alanı içerir: subpremise.

Adres örneklerini onaylama

Bir adresi kabul etme

Verilen karar, müşterinin o hususa dair güven derecesi yüksek olduğu için bir adresi adres, teslimat kapsamında olmalı ve müşterinin başka işlem yapmasına gerek kalmadan kullanılabilir. önemli bir parçasıdır.

Sinyalleri kabul et

Address Validation API, bir adresi onaylanmalıdır.

1. Doğrulama Ayrıntı Düzeyi

PREMISE veya daha iyi bir validationGranularity kabul edilir ancak bazı yerlerde durumlarda, ROUTE yine de teslim edilecek bir adresi belirtir.

2. Diğer sinyaller

Yüksek kaliteli adres kararı aşağıdakileri de sağlamalıdır:

  • Değiştirilen veri yok. Bu durumda, hasReplacedComponents: FALSE.
  • Tahmin edilen bileşen yok. Bu durumda, hasInferredComponents: FALSE.

3. ABD adres sinyalleri

Yalnızca ABD'deki adresler için geçerli olan belirli alanlar, yüksek kaliteli adres olduğunu gösterir. bir alan vardır. Kabul edilebilir bir ABD adresi için takip etmek için:

dpvConfirmation Y

dpvConfirmation hakkında ayrıntılı bilgi için bkz. ABD adreslerini işleyin.

Kabul etme adresi örnekleri