Adresi düzeltme - örnekler

Bu belgede, Address Validation API'nin sisteminizden bir fix davranışı garanti eden 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.

Yaygın örnekler: düzeltme

Bu bölümde, Address Validation API'nin düşük kaliteli adres bilgilerini gösteren yanıt sinyalleri sağladığı yaygın örnekler açıklanmaktadır.

Şehir ve posta kodu eksik

Bu örnekte, şehir veya posta kodu olmadan yalnızca açık adresi içeren bir giriş gösterilmektedir.

Adres girildi Bölge
21 45 40. sokak ABD

Eksik şehir ve posta kodu kararı

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

{
  "inputGranularity": "PREMISE",
  "validationGranularity": "OTHER",
  "geocodeGranularity": "OTHER",
  "hasUnconfirmedComponents": true
}

Bu sinyaller, teslim edilemeyen bir adresi gösterir. Daha fazla bilgi edinmek için addressComponents öğesini sorgulayabilirsiniz:

{
  "componentName": {
    "text": "21",
    "languageCode": "en"
  },
  "componentType": "street_number",
  "confirmationLevel": "UNCONFIRMED_BUT_PLAUSIBLE"
},
{
  "componentName": {
    "text": "45 40th street",
    "languageCode": "en"
  },
  "componentType": "route",
  "confirmationLevel": "UNCONFIRMED_BUT_PLAUSIBLE"
},
{
  "componentName": {
    "text": "United States",
    "languageCode": "en"
  },
  "componentType": "country",
  "confirmationLevel": "CONFIRMED"
}

Address Validation API, CONFIRMED olarak yalnızca ülkeyi (ABD) döndürür. Diğer tüm adres bileşenlerini UNCONFIRMED_BUT_PLAUSIBLE olarak döndürür ve verilerde yerellik ve posta kodu gibi bazı önemli eksiklikler bulunur.

Sokak numarası eksik

Bu örnekte eksik bir sokak numarası gösterilmektedir.

Adres girildi Bölge
Buckingham Palace Road, SW1W 9TQ Londra Birleşik Krallık
Eksik sokak numarasıyla ilgili karar
{
    "inputGranularity": "PREMISE_PROXIMITY",
    "validationGranularity": "ROUTE",
    "geocodeGranularity": "ROUTE"
}

validationGranularity, ROUTE değeridir. Bu, sokakla eşleşmeyi gösterir ancak mekana ulaşmak için yeterli bilgi değildir. Buna ek olarak, kararda addressComplete özelliği eksik olduğu için false özelliği kullanılıyor. address nesnesine yapılan başka bir sorguda, eksik bir bileşen türü ortaya çıkar:

"missingComponentTypes": [
        "street_number"
      ]

Uç durum örnekleri: düzeltme

Bazı durumlarda bir adresi düzeltmeniz, onaylamanız veya kabul etmeniz, iş senaryonuza bağlı olarak farklılık gösterir. Aşağıdaki örneklerde, tam olarak "düzeltme" kategorisinde yer almayabilecek senaryolar gösterilmektedir.

Onaylanmamış sokak numarası

Bu senaryoda Address Validation API, sağlanan sokak numarasını onaylayamıyor ancak adresin tamamlandığını belirtir.

Adres girildi Bölge
84 Buckingham Palace Road, SW1W 9TQ, Londra Birleşik Krallık

Onaylanmamış sokak numarasıyla ilgili karar

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

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

Doğrulama ayrıntı düzeyinin, onaylanmamış bileşenlerle birlikte yalnızca bina düzeyinde yaklaşık tahminle kombinasyonunu araştırmak işe yarayabilir. addressComponents özelliğinin sorgusu, aşağıdaki onaylanmamış componentType değerini gösterir:

{
  "componentName": {
    "text": "84",
    "languageCode": "en"
  },
  "componentType": "street_number",
  "confirmationLevel": "UNCONFIRMED_BUT_PLAUSIBLE"
}

Burada street_number öğesinin confirmation_level değeri UNCONFIRMED_BUT_PLAUSIBLE olarak ayarlanmıştır. Onaylanmamış ifadesi, hizmetin veri kümesindeki 84 olan sokak numarasıyla eşleştirilemeyeceği ve makul, bileşen verilerinin hâlâ geçerli olabileceği anlamına gelir.

Alt önerme eksik

Bu senaryoda, yalnızca bir alt binanın eksik olduğu bir adres (apartman veya departman numarası gibi) açıklanmaktadır. Aksi takdirde Address Validation API, adresi tamamen doğrulayabilir. Herhangi bir adres bileşeni eksik olduğunda olduğu gibi, addressComplete false olduğundan manuel olarak karar incelemesinde yer almaz.

Örnek vermek gerekirse, bir müşterinin İstanbul şehir eksperinin ofisi için geçerli bir adres girdiğini ancak girişte oda numarasını girmediğini varsayalım.

Adres girildi Bölge
Doctor Carlton B Goodlett Place, San Francisco, CA 94102 ABD

Eksik alt önerme ile ilgili karar

Bu örnekte, sonuç addressComplete özelliğini göstermez. Bu nedenle, false olur. Bu nedenle, en az bir adres öğesinin beklenmedik, çözülmemiş veya eksik olduğunu bilirsiniz.

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

}

address sorgusu şunları gösterir:

"missingComponentTypes": [
        "subpremise"
      ]

Daha ayrıntılı yapılan araştırmanın ardından USPS verileri, D kodlu bir dpvConfirmation kodu sağlar. Bu kod, eksik bir alt önerme olduğunu da gösterir.