Adresi onaylama - örnekler

Bu belgede, Address Validation API'nin sisteminizden onay almayı garanti eden adresler için yanıt sinyalleri sağladığı bir dizi gerçek senaryo açıklanmaktadır. İçerik için Doğrulama mantığınızı oluşturma bölümündeki İş akışına genel bakış bölümüne bakın.

Not: Buradaki örnekler açıklama amaçlıdır ancak olası her örneğe yer verilmemiştir.

Yaygın örnekler: onaylama

Aşağıdaki örnekte benzer sokak adlarına sahip metropol bölgeleri gösterilmektedir. Bir kullanıcının Kirkland, WA, ABD'deki Google Binası D'nin adresini girmek istediğini varsayalım. Ancak şehir olarak Kirkland yerine yanlışlıkla Seattle'a girerler.

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

Değiştirilen verilerle ilgili karar

Aşağıdaki örnekte, yanıttan alınan önemli sinyaller vurgulanmaktadır.

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

PREMISE_PROXIMITY, bina düzeyindeki bir adresin yakınlaşması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, kombinasyon bunu onayla kategorisine ekler.

Adres bileşenleriyle ilgili bir sorgu şu alanları açığa çıkarır:

{
  "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 Address Validation API, Seattle'da sağlanan adrese yakın bir değer buldu ve daha üst düzey bir bileşen olan posta kodunu Seattle adresine çözümlemek için değiştirdi. Bu, geçerli bir değişim olabilir, ancak bileşenlerin onaylanmamış olmasıyla birlikte, kullanıcının Kirkland gibi başka bir bilgiyi değil Seattle adresini girmeyi amaçladığından emin olmak mantıklıdır.

İpucu: Başlangıçta hedeflenen adresle ilgili yanıtı görmek için demo bölümünde 451 7th Avenue, Kirkland, WA 98033 adresini kullanarak doğru adresi kontrol edin.

İşlem: Müşteriyle adres girişini onaylayın.

Uç durum örnekleri: onaylama

Aşağıdaki örneklerde şu uç büyük/küçük harf türleri gösterilmektedir:

• Onaylanmış küçük çıkarımlar. Address Validation API; ülke, posta kodu 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 kombinasyonu, onay işlemine gerek olmayan küçük bir çıkarıma yol açar.
• Beklenmeyen adres bileşeni ONAYLANMADI. Onaylanmamış adres bileşenleri, adresin risk düzeyini artırır. Bu, onay almanıza yardımcı olabilir.
• IS'nin onaylandığı, beklenmedik adres bileşeni. Bileşen, doğru adres için şart değildir ve Address Validation API tarafından çıkıştan kaldırılır. Biçimlendirme sorunları genellikle onay almayı garanti etmez.

ARE onaylı küçük çıkarımlar

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

• Şehir
• Eyalet
• Posta kodu
• Ülke

Örneğin, bir müşteri Springfield, Massachusetts'te bulunan bir McDonald's restoranı için geçerli bir açık adres giriyor, ancak şehri girmeyi unutuyor ve 4 haneli olmayan bir posta kodu veriyor.

Adres girildi	Bölge
Cumhuriyet Cad. No: 121, İstanbul 01118	ABD

Kayıp şehirle ilgili karar

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

Address Validation API'nin teslimat adresi oluşturmak için daha üst düzey bileşenler elde ettiği durumlarda, sistemden gelen verilerin doğru olduğuna daha fazla güvenebilirsiniz. Bunun nedeni, geniş bir coğrafi bölgeyi temsil eden tahmini bileşenlerin daha ayrıntılı onaylanmış adres bileşenleriyle daha kolay eşleştirilmesidir. ABD'deki Springfield gibi şehir adlarının tekrar edildiği ülkelerde bile, bununla birlikte kullanılan diğer bileşenler benzersiz bir adres sağlayabilir.

Yukarıdaki örneğimize göre, tüm adres bileşenlerine yapılan bir tarama her bileşenin onaylanmış olduğunu, yani Address Validation API tarafından depolanan verilerle eşleştiğini ve hizmetin ayrıca iki üst düzey bileşen için tahminde bulunduğunu gösterir.

{
  "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 gibi adresler, tahmin edilen bileşenlerin onayıyla birlikte, mantığınızın müşteriye sormadan bunları geçerli olarak kabul edebilmesi için yeterli onaylanmış ayrıntı düzeyi sağlar.

Beklenmeyen adres bileşeni ONAYLANMADI

Bu senaryo, bileşenlerin ne zaman onaylanmadığını kontrol etmenin önemini göstermektedir. Beklenmeyen bir adres bileşeni varsa Address Validation API bunu çıkıştan kaldırır. Bu gibi durumlarda risk düzeyinize ve güven düzeyinize bağlı olarak adresi kabul edebilir veya müşteriyle tekrar onaylayabilirsiniz.

Örneğin, adres, müşterilerin genellikle posta idaresi tarafından göz ardı edilen zararsız bilgileri girdiği bir bölgede olabilir. Bu durumda adresi kabul edersiniz. Ancak bazı durumlarda müşterinin istediği, onaylanmamış bir bileşen olabilir.

Adres girildi	Bölge
Büyükdere Caddesi No: 99, 34360 Şişli/İstanbul, 34630 Saint-Thibéry	Fransa

Beklenmeyen adres bileşeniyle ilgili karar onaylanmadı

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

Address Validation API, onaylanmamış bileşenlerle ilgili 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 bir tarama, API'nin döndürülen adresten la caritat 2'yi kaldırdığını göstermektedir:

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

İşlem: Onayla. Bu durumda, bir konut bölgesini veya mahalleyi belirtebilen alt konum doğru olabilir ancak posta idaresi tarafından dikkate alınmaz. Ancak bu bilgilerin Address Validation API tarafından **onaylanmadığı** için bu durumu müşteriyle teyit etmeniz faydalı olur. Bu noktada kaldırma işlemini yoksayar veya onaylarsınız.

IS'nin onayladığı beklenmeyen adres bileşeni

Bu örnekte, verilen adrese Birleşik Krallık'taki bir ilçenin dahil edilmesi yaygın bir uygulamadır. Ancak bu, Birleşik Krallık posta yetkilileri için bir gereklilik değildir ve esasen göz ardı edilir. postoffice.co.uk ve Birleşik Krallık ve uluslararası postaya nasıl hitap edilir? sayfalarına göz atın.

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

Adres girildi	Bölge
İstiklal Caddesi No:33, Çankaya, İstanbul, 34600	Birleşik Krallık

Onaylanan beklenmedik adres bileşeni kararı

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

Burada address_complete işlevi yanlış olarak değerlendirilir ve adres bileşeni analizinde beklenmeyen bir işaret görüntülenir.

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

Bu bileşen hem beklenmeyen hem de onaylanmıştır. Bu da şu anlama gelir:

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

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

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