Adresi onaylama - örnekler

Bu belgede, Address Validation API'nin sisteminizden onay davranışı gerektiren adresler için yanıt sinyalleri sağladığı gerçek hayattan senaryolar açıklanmaktadır. Buradaki örnekler açıklayıcıdır ancak olası her durumu kapsamaz. Bağlam için Doğrulama mantığınızı oluşturma bölümündeki İş akışına genel bakış konusunu inceleyin.

Yaygın örnekler: onayla

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

Girilen adres Bölge
Building D, 451 7th Avenue South, Seattle, WA 98033 ABD

Değiştirilen veriler için karar

Aşağıdaki örnekte, karardaki önemli sinyaller vurgulanmaktadır.

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

PREMISE_PROXIMITY ayrıntı düzeyi, bina düzeyindeki bir adresin yakınlığını gösterir ancak girişte sağlanan ayrıntı düzeyi olan SUB_PREMISE kadar ayrıntılı değildir. Yanıtta hem onaylanmamış hem de değiştirilmiş bileşenler de yer aldığından bu kombinasyon, yanıtı onayla kategorisine taşır.

Adres bileşenlerinin sorgulanması, aşağıdaki sorunlu alanları ortaya çı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 adres buldu ve Seattle adresine çözümlenmesi için daha üst düzey bir bileşen olan posta kodunu değiştirdi. Bu geçerli bir değişiklik olabilir ancak bileşenlerin onaylanmamış olması nedeniyle, kullanıcının Kirkland gibi başka bir yer değil, Seattle adresi girmek istediğinden emin olmak mantıklıdır.

Uç durum örnekleri: Onaylama

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

  • Onaylanan küçük çıkarımlar. Address Validation API; ülke, posta kodu veya eyalet bilgisini tahmin eder ancak diğer tüm bilgiler hem sağlanır hem de onaylanır. Ayrıntı düzeyi ve onay düzeyinin birleşimi, onay işlemi gerektirmeyen küçük bir çıkarım sağlar.
  • Beklenmeyen adres bileşeni onaylanmadı. Onaylanmamış adres bileşenleri, adresin risk düzeyini artırır. Bu durumda onay gerekebilir.
  • Onaylanan beklenmedik adres bileşeni. Bileşen, doğru bir adres için kesinlikle gerekli değildir ve Address Validation API, bileşeni çıktıdan kaldırır. Biçimlendirme sorunları genellikle onay gerektirmez.

Onaylanan küçük çıkarımlar

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

  • Şehir
  • Eyalet
  • Posta kodu
  • Ülke

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

Girilen adres Bölge
1402 Allen St, MA 01118 ABD

Eksik şehir için karar

{
  "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 tahmin ettiği durumlarda, sistemden gelen verilerin doğru olduğundan daha emin olabilirsiniz. Bunun nedeni, geniş bir coğrafi bölgeyi temsil eden tahmini bileşenlerin, daha ayrıntılı olan onaylanmış adres bileşenleriyle daha kolay eşleştirilmesidir. ABD'deki Springfield gibi şehir adlarının tekrarlandığı ülkelerde bile diğer bileşenlerle birleştirildiğinde benzersiz bir adres elde edilebilir.

Yukarıdaki örneğimizi kullanırsak tüm adres bileşenlerinde yapılan bir tarama, her bileşenin onaylandığını gösterir. Bu, Address Validation API 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
}

Beklenmeyen adres bileşeni onaylanmadı

Bu senaryo, bileşenlerin onaylanmadığı durumları kontrol etmenin önemini gösterir. Address Validation API, beklenmeyen adres bileşenlerini çıktıdan kaldırır. Bu durumlarda, risk ve güven düzeyinize bağlı olarak adresi kabul edebilir veya müşteriyle yeniden onaylayabilirsiniz.

Örneğin, bir adres, müşterilerin genellikle posta yetkilisi tarafından yok sayı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 şey olmayabilir.

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

Beklenmeyen adres bileşeni için karar onaylanmadı

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

Address Validation API, onaylanmamış bileşenler içeren bir kararın yanı sıra 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 tarama, API'nin döndürülen adresten la caritat 2 ifadesini kaldırdığını gösteriyor:

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

Onaylanan beklenmedik adres bileşeni

Bu örnekte, sağlanan adrese Birleşik Krallık'taki bir ilçenin dahil edildiği gösterilmektedir. Bu, yaygın bir uygulamadır. Ancak bu, Birleşik Krallık posta yetkililerinin bir şartı değildir ve genellikle dikkate alınmaz. postoffice.co.uk ve How to address UK and international mail (Birleşik Krallık ve uluslararası postalar nasıl adreslenir?) sayfalarına bakın.

Bu nedenle, bir müşteri Birleşik Krallık adresinde ilçe belirttiğinde hizmet bunu beklenmedik bir giriş olarak değerlendirir.

Girilen adres Bölge
33 Dunalley St, Cheltenham, Gloucestershire, GL50 4AP Birleşik Krallık

Onaylanan beklenmedik adres bileşeni için karar

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

Burada, address_complete yanlış 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
}

Gloucestershire, girilen adres için 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 hatırlayın.