Adresi düzeltme - örnekler

Bu belgede, Address Validation API'nin sisteminizden düzeltme davranışı gerektirebilecek yanıt sinyalleri sağladığı bazı gerçek dünya senaryoları açıklanmaktadır. Bağlam için Doğrulama mantığınızı oluşturma bölümündeki Örnek iş akışları'na bakın.

Yaygın örnekler: düzeltme

Bu bölümde, Address Validation API'nin 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, yalnızca açık adresin bulunduğu, şehir veya posta kodunun yer almadığı bir giriş gösterilmektedir.

Eksik şehir ve posta kodu için karar

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

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

possibleNextAction, adresin teslimat için uygun olmayabileceğine dair ilk göstergeyi sağlar. Vurgulanan diğer bileşenler de bu olasılığı destekler. Bu nedenle, daha fazla bilgi edinmek için addressComponents 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, yalnızca ülkeyi (ABD) CONFIRMED olarak döndürür. Diğer tüm adres bileşenlerini UNCONFIRMED_BUT_PLAUSIBLE olarak döndürür ve verilerde yerleşim yeri ve posta kodu gibi bazı önemli eksiklikler olur.

Sokak numarası eksik

Bu örnekte sokak numarası eksiktir.

Eksik sokak numarası için karar

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

possibleNextAction, adresin teslimat için uygun olmayabileceğine dair ilk göstergeyi sağlar. Ayrıca, validationGranularity ROUTE değerine sahip. Bu değer, sokakla eşleşme olduğunu ancak tesise ulaşmak için yeterli bilgi olmadığını gösterir. Ayrıca, addressComplete özelliği kararda 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 işletmenizin özel senaryosuna bağlıdır. Aşağıdaki örneklerde, tam 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,
  "possibleNextAction": "ACCEPT"
}

Doğrulama ayrıntı düzeyinin yalnızca tesis düzeyinde yaklaşık değerle ve onaylanmamış bileşenlerle birlikte kullanılması incelenmeye değerdir. addressComponents mülküyle ilgili bir sorgu, aşağıdaki onaylanmamış componentType öğesini gösteriyor:

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

Burada, street_number için confirmation_level, UNCONFIRMED_BUT_PLAUSIBLE olarak ayarlanmıştır. Onaylanmadı, hizmetin veri kümesindeki 84 numaralı sokakla eşleşemediği anlamına gelir. Makul ise bileşen verilerinin hâlâ geçerli olabileceği anlamına gelir.

Alt tesis eksik

Bu senaryoda, yalnızca alt tesis (ör. apartman dairesi veya bölüm numarası) bilgisi eksik olan bir adres açıklanmaktadır. Aksi takdirde Address Validation API, adresi tam olarak doğrulayabilir. Herhangi bir adres bileşeni eksik olduğunda olduğu gibi, addressComplete false olduğundan kararın manuel incelemesinde yer almaz.

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

Eksik alt tesis için karar

Bu örnekte, kararda addressComplete özelliği gösterilmediğinden false olarak kabul edilir. Bu nedenle, en az bir adres öğesinin beklenmedik, çözümlenmemiş veya eksik olduğunu bilirsiniz.

{
  "inputGranularity": "PREMISE",
  "validationGranularity": "PREMISE",
  "geocodeGranularity": "PREMISE",
  "hasInferredComponents": true,
  "possibleNextAction": "CONFIRM_ADD_SUBPREMISES"
}

address sorgusu aşağıdaki sonuçları verir:

"missingComponentTypes": [
        "subpremise"
      ]

Daha ayrıntılı bir inceleme yapıldığında USPS verilerinin dpvConfirmation kodunu (D) sağladığı görülür. Bu kod da alt tesisin eksik olduğunu gösterir.