Adresi düzeltme - örnekler

Bu dokümanda, Address Validation API'nin sisteminizde düzeltme davranışını gerektiren yanıt sinyalleri sağladığı çeşitli gerçek yaşam senaryoları açıklanmaktadır. Bağlam için Doğrulama mantığınızı oluşturma başlıklı makalenin İş akışına genel bakış bölümüne bakın.

Sık karşılaşılan ö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, şehir veya posta kodu olmadan yalnızca sokak adresinin bulunduğu bir giriş gösterilmektedir.

Adres girildi Bölge
21 45 40th street ABD

Eksik şehir ve posta kodu için sonuç

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

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

Bu sinyaller, teslim edilemeyen bir adresi gösterir. Daha fazla bilgi edinmek için addressComponents adresini 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, verilerde yerellik ve posta kodu gibi bazı önemli eksikliklerle birlikte UNCONFIRMED_BUT_PLAUSIBLE olarak döndürür.

Bina 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ı için karar
{
    "inputGranularity": "PREMISE_PROXIMITY",
    "validationGranularity": "ROUTE",
    "geocodeGranularity": "ROUTE"
}

validationGranularity, ROUTE değerini alır. Bu, caddeyle eşleşme olduğunu ancak tesise ulaşmak için yeterli bilgi olmadığını gösterir. Ayrıca, addressComplete mülkü kararda eksik olduğundan false. address nesnesi için yapılan başka bir sorgu, eksik bir bileşen türünü ortaya çıkarır:

"missingComponentTypes": [
        "street_number"
      ]

Uç durum örnekleri: düzeltme

Bazı durumlarda, bir adresi düzeltip düzeltmeyeceğiniz, onaylayıp onaylamayacağınız veya kabul edip etmeyeceğiniz işletme senaryonuza bağlıdır. Aşağıdaki örnekler, kesin bir şekilde düzeltme kategorisine girmeyebilecek senaryoları göstermektedir.

Onaylanmayan sokak numarası

Bu senaryoda, Address Validation API sağlanan sokak numarasını onaylayamaz ancak adresin tamamlandığını gösterir.

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

Onaylanmamış sokak numarası için karar

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

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

Onaylanmamış bileşenlerle birlikte yalnızca tesis düzeyinde bir yaklaşım için doğrulama ayrıntı düzeyinin kombinasyonunu incelemeye değer. addressComponents özelliğinin sorgusunda aşağıdaki onaylanmamış componentType gösterilir:

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

Burada street_number öğesinin confirmation_level değeri UNCONFIRMED_BUT_PLAUSIBLE olarak ayarlandı. Onaylanmadı, hizmetin veri kümesinde 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 bir alt tesis (ör. apartman veya departman numarası) eksik olan bir adres 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 karar manuel olarak incelendiğinde bu bileşen görünmez.

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

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

Eksik alt tesis için karar

Bu örnekte kararda addressComplete mülkü gösterilmediği için false değeri geçerlidir. 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ı ortaya çıkarır:

"missingComponentTypes": [
        "subpremise"
      ]

Daha ayrıntılı inceleme sonucunda USPS verileri, D için dpvConfirmation kodu sağlıyor. Bu kod, eksik bir alt bina olduğunu da gösteriyor.