Adresi onaylama - örnekler

Bu dokümanda, Address Validation API'nin, sisteminizden onay davranışı gerektiren adresler için yanıt sinyalleri sağladığı çeşitli gerçek dünya senaryoları açıklanmaktadır. Bağlam için Doğrulama mantığınızı oluşturma başlıklı makalenin İş akışına genel bakış bölümüne bakın.

Not: Buradaki örnekler açıklayıcıdır ancak olası her durumu kapsamaz.

Sık karşılaşılan örnekler: onayla

Aşağıdaki örnekte, benzer sokak adlarına sahip büyükşehir alanları gösterilmektedir. Bir kullanıcının ABD, Washington, Kirkland'daki Google D Binası adresini girmek istediğini varsayalım. Ancak şehir olarak Kirkland yerine yanlışlıkla Seattle'u girerler.

Adres girildi	Bölge
Building D, 451 7th Avenue South, Seattle, WA 98033	ABD

Değiştirilen veriler için karar

Aşağıdaki örnekte, yanıttaki önemli sinyaller vurgulanmıştır.

{
  "inputGranularity": "SUB_PREMISE",
  "validationGranularity": "PREMISE_PROXIMITY",
  "geocodeGranularity": "PREMISE_PROXIMITY",
  "addressComplete": true,
  "hasUnconfirmedComponents": true
  "hasReplacedComponents": true
}

PREMISE_PROXIMITY, bina düzeyinde bir adresin yaklaşımını gösterir ancak girişte sağlanan ayrıntı düzeyi olan SUB_PREMISE kadar ayrıntılı değildir. Yanıt hem onaylanmamış hem de değiştirilmiş bileşenler içerdiğinden bu kombinasyon, yanıtı onay kategorisine yerleştirir.

Adres bileşenleri sorgusunda aşağıdaki sorun alanları ortaya çıkar:

{
  "componentName": {
    "text": "451",
  },
  "componentType": "street_number",
  "confirmationLevel": "UNCONFIRMED_BUT_PLAUSIBLE",
}
...
{
  "componentName": {
    "text": "98104",
  },
  "componentType": "postal_code",
  "confirmationLevel": "CONFIRMED",
  "replaced": true
}
...
{
  "componentName": {
    "text": "Building D",
    "language_code": "en"
  },
  "componentType": "subpremise",
  "confirmationLevel": "UNCONFIRMED_BUT_PLAUSIBLE",
}
.......

    "unconfirmedComponentTypes": [
      "street_number",
      "subpremise"
    ]

Bu durumda Adres Doğrulama API'si, sağlanan Seattle adresine yakın bir adres buldu ve Seattle adresine çözüm bulmak için daha üst düzey bir bileşen olan posta kodunu değiştirdi. Bu geçerli bir değişim olabilir ancak bileşenlerin onaylanmamış olması nedeniyle kullanıcının Kirkland gibi başka bir adres değil, Seattle adresi girmek istediğini doğrulamak mantıklı olacaktır.

İpucu: Aslında amaçlanan adrese ait yanıtı görmek için demo'da 451 7th Avenue South, Kirkland, WA 98033 adresini kullanarak doğru adresi kontrol edin.

İşlem: Adres girişini müşteriyle onaylayın.

Uç durum örnekleri: onaylama

Aşağıdaki örneklerde aşağıdaki uç durum türleri gösterilmektedir:

• Onaylanmış küçük çıkarımlardır. Adres Doğrulama API'si ülkeyi, posta kodunu veya eyaleti tahmin eder ancak diğer her şey hem sağlanır hem de onaylanır. Hem ayrıntı düzeyi hem de onay düzeyinin bir kombinasyonu, onay işlemi gerektirmeyen küçük bir çıkarım sağlar.
• Beklenmedik adres bileşeni ONAYLANMADI. Onaylanmamış adres bileşenleri, adresin risk düzeyini artırır. Bu durum onay gerektirebilir.
• Doğrulanmış beklenmedik adres bileşeni. Bu bileşen, doğru bir adres için kesinlikle gerekli değildir ve Adres Doğrulama API'si bu bileşeni çıktıdan kaldırır. Biçimlendirme sorunları genellikle onay gerektirmez.

Onaylanmış küçük çıkarım

API, daha ayrıntılı düzeyde onaylanmış verilerle birleştirildiğinde, girişte aşağıdaki türlerden yalnızca bir bileşen eksikse doğru çıkarım yapabilir:

• Şehir
• Eyalet
• Posta kodu
• Ülke

Örneğin, bir müşteri Massachusetts, Springfield'deki bir McDonald's restoranı için geçerli bir sokak adresi sağlar ancak şehri girmeyi unutur ve 4 haneli uzantısı olmayan bir posta kodu sağlar.

Adres girildi	Bölge
1402 Allen St, MA 01118	ABD

Eksik şehir için sonuç

{
  "inputGranularity": "PREMISE",
  "validationGranularity": "PREMISE",
  "geocodeGranularity": "PREMISE",
  "addressComplete": true,
  "hasInferredComponents": true
}

Address Validation API'nin, teslim edilebilir bir adres oluşturmak için daha üst düzey bileşenleri çıkardığı durumlarda, sistemdeki verilerin doğru olduğuna dair daha yüksek düzeyde güvene sahip olabilirsiniz. Bunun nedeni, geniş bir coğrafi bölgeyi temsil eden çıkarsama bileşenlerinin, daha ayrıntılı olan onaylanmış adres bileşenleriyle daha kolay eşleşmesidir. ABD'deki Springfield gibi şehir adlarının tekrarlandığı ülkelerde bile, bu şehir adıyla birlikte kullanılan diğer bileşenler benzersiz bir adres sağlayabilir.

Yukarıdaki örneğimizi kullanarak tüm adres bileşenleri üzerinde yapılan bir tarama, her bileşenin onaylandığını gösterir. Bu, bileşenlerin Adres Doğrulama API'si tarafından depolanan verilerle eşleştiği ve hizmetin iki üst düzey bileşeni de çıkardığı anlamına gelir.

{
  "componentName": {
    "text": "Springfield",
    "languageCode": "en"
  },
  "componentType": "locality",
  "confirmationLevel": "CONFIRMED",
  "inferred": true
},
{
  "componentName": {
    "text": "1806"
  },
  "componentType": "postal_code_suffix",
  "confirmationLevel": "CONFIRMED",
  "inferred": true
}

İşlem: Kabul edin. Bu tür adresler, mantığınızın müşteriye sormadan bunları geçerli olarak kabul edebilmesi için, varsayılan bileşenlerin onayıyla birlikte yeterli onaylanmış ayrıntı düzeyi sağlar.

Beklenmeyen adres bileşeni ONAYLANMADI

Bu senaryo, bileşenlerin onaylanmadığında kontrol edilmesinin önemini göstermektedir. Beklenmedik bir adres bileşeni varsa Adres Doğrulama API'si bu bileşeni çıktıdan kaldırır. Bu durumlarda, risk düzeyinize ve güven düzeyinize bağlı olarak adresi kabul edebilir veya müşteriyle tekrar doğrulayabilirsiniz.

Örneğin, bir adres, müşterilerin genellikle posta idaresi tarafından yoksayılan zararsız bilgiler girdiği bir bölgeden olabilir. Bu durumda adresi kabul edersiniz. Ancak bazı durumlarda, onaylanmamış bir bileşen müşterinin istediği bileşen olmayabilir.

Adres girildi	Bölge
1 Rue Grenache, la caritat 2, 34630 Saint-Thibéry	Fransa

Beklenmedik adres bileşeni için karar onaylanmadı

{
  "inputGranularity": "PREMISE",
  "validationGranularity": "PREMISE",
  "geocodeGranularity": "PREMISE",
  "unconfirmedComponents": true
}

Address Validation API, doğrulanmamış bileşenleri içeren bir karara ek olarak aşağıdaki biçimlendirilmiş adresi döndürür:

"formattedAddress": "1 Rue Grenache, 34630 Saint-Thibéry, France",

Onaylanmamış bileşenler için yapılan taramada, API'nin döndürülen adresten la caritat 2 öğesini kaldırdığı görülüyor:

{
  "componentName": {
    "text": "la caritat 2",
    "languageCode": "fr"
  },
  "componentType": "sublocality_level_1",
  "confirmationLevel": "UNCONFIRMED_BUT_PLAUSIBLE",
  "unexpected": true
}

İşlem: Onaylayın. Bu durumda, bir konut bölgesini veya mahalleyi belirtebilen alt bölge doğru olsa bile posta idaresi tarafından yoksayılabilir. Ancak bu bilgilerin Adres Doğrulama API'si tarafından **onaylanmadığı** göz önüne alındığında, bu bilgiyi müşteriyle doğrulamanız mantıklı olacaktır. Bu noktada kaldırma işlemini yoksayabilir veya onaylayabilirsiniz.

Onaylanmış beklenmedik adres bileşeni

Bu örnekte, sağlanan adrese Birleşik Krallık'taki bir ilçenin eklenmesi gösterilmektedir. Bu, yaygın bir uygulamadır. Ancak bu, Birleşik Krallık posta idaresi tarafından zorunlu tutulan bir koşul değildir ve genellikle yoksayılır. postoffice.co.uk adresine ve Birleşik Krallık ve uluslararası posta adresleri başlıklı makaleye bakın.

Sonuç olarak, bir müşteri Birleşik Krallık adresinde ilçe sağladığında hizmet bunu beklenmedik giriş olarak değerlendirir.

Adres girilir.	Bölge
33 Dunalley St, Cheltenham, Gloucestershire, GL50 4AP	Birleşik Krallık

Onaylanmış beklenmedik adres bileşeni için karar

{
   "inputGranularity": "PREMISE",
   "validationGranularity": "PREMISE",
   "geocodeGranularity": "PREMISE"
}

Burada address_complete false olarak değerlendirilir ve adres bileşeninin analizi beklenmedik bir işaret gösterir.

{
  "componentName": {
    "text": "Gloucestershire",
    "languageCode": "en"
  },
  "componentType": "administrative_area_level_2",
  "confirmationLevel": "CONFIRMED",
  "unexpected": true
}

Bu bileşen hem beklenmedik hem de onaylanmış. Bu durum aşağıdakileri ifade eder:

• Doğru veri olarak onaylandı. Bu, bileşenin adresi içeren doğru ilçe olduğunu gösterir.
• Giriş olarak beklenmedik. Adresin doğru biçimlendirilmesi için gerekli olmayan bir bileşeni gösterir.

Girilen adres için Gloucestershire doğru ilçe olsa da adresin kendisi yanlış biçimlendirilmiş. Address Validation API'nin, bilgileri doğru biçimlendirme açısından da değerlendirdiğini unutmayın.

İşlem: Bu senaryoda önerilen işlem, bu sinyali yok sayıp adresi kabul etmektir.