Adresi düzeltme - örnekler

Bu belgede, Adres Doğrulama API'sinin sisteminizde düzeltme davranışını gerektiren yanıt sinyalleri sağladığı çeşitli gerçek dünya 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ış başlıklı makaleyi inceleyin.

Yaygın örnekler: düzeltme

Bu bölümde, Adres Doğrulama API'sinin daha 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 sokak adresi içeren bir giriş gösterilmektedir.

Eksik şehir ve posta kodu için karar

Aşağıdaki örnekte, yanıttaki ö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 sorgusunu kullanabilirsiniz:

{
  "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. Yerleşim yeri ve posta kodu gibi verilerde bazı önemli eksiklikler vardır.

Sokak numarası eksik

Bu örnekte, sokak numarasının eksik olduğu gösterilmektedir.

Eksik sokak numarasıyla ilgili karar

{
    "inputGranularity": "PREMISE_PROXIMITY",
    "validationGranularity": "ROUTE",
    "geocodeGranularity": "ROUTE"
}

validationGranularity, ROUTE olarak ayarlanmış. Bu, sokağın eşleştiğini ancak binaya ulaşmak için yeterli bilgi olmadığını gösterir. Ayrıca, kararda addressComplete özelliği eksik olduğundan false. address nesnesiyle ilgili başka bir sorgu, eksik bir bileşen türü olduğunu gösteriyor:

"missingComponentTypes": [
        "street_number"
      ]

Uç durum örnekleri: düzeltme

Bazı durumlarda, bir adresi düzeltmeniz, onaylamanız veya kabul etmeniz özel iş senaryonuza bağlıdır. Aşağıdaki örneklerde, kesin olarak bir düzeltme kategorisine girmeyebilecek senaryolar gösterilmektedir.

Onaylanmamış sokak numarası

Bu senaryoda, Address Validation API, sağlanan sokak numarasını doğrulayamaz ancak adresin eksiksiz olduğunu belirtir.

Onaylanmamış sokak numarası için karar

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

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

Yalnızca tesis düzeyinde yaklaşıma sahip bir doğrulama ayrıntı düzeyi ile onaylanmamış bileşenlerin kombinasyonunu incelemeniz önerilir. addressComponents özelliğiyle ilgili bir sorgu, aşağıdaki onaylanmamış componentType değerlerini 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. Onaylanmadı, hizmetin veri kümesindeki 84 numaralı sokakla eşleşemediği anlamına gelir. Olası ise bileşen verilerinin hâlâ geçerli olabileceği anlamına gelir.

Alt tesis eksik

Bu senaryoda, yalnızca bir alt tesisin (ör. apartman dairesi veya bölüm numarası) eksik olduğu bir adres açıklanmaktadır. Aksi takdirde, Adres Doğrulama API'si adresi tamamen doğrulayabilir. Herhangi bir adres bileşeni eksik olduğunda olduğu gibi, addressComplete false olduğundan kararın manuel olarak incelenmesinde yer almaz.

Örneğin, bir müşterinin San Francisco şehir değerlendirme ofisi için geçerli bir adres girdiğini ancak girişten oda numarasını atladığını varsayalım.

Eksik alt tesis için karar

Bu örnekte, kararda addressComplete özelliği gösterilmediği için false. Bu nedenle, en az bir adres öğesinin beklenmedik, çözümlenmemiş veya eksik olduğunu anlarsınız.

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

}

Bir address sorgusu şunları gösterir:

"missingComponentTypes": [
        "subpremise"
      ]

Daha fazla araştırma yapıldığında USPS verilerinin, alt tesisin eksik olduğunu da belirten dpvConfirmation D kodunu sağladığı görülüyor.