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 UNCONFIRMED_BUT_PLAUSIBLE olarak döndürür. Bu işlemde, bölge ve posta kodu gibi bazı önemli veriler atlanı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 örneklerde, tam olarak bir düzeltme kategorisine girmeyen senaryolar gösterilmektedir.

Onaylanmayan sokak numarası

Bu senaryoda Adres Doğrulama API'si, sağlanan sokak numarasını doğrulayamaz ancak adresin eksiksiz olduğunu belirtir.

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 mülküne yapılan bir sorgu, aşağıdaki onaylanmamış componentType'ı gösterir:

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

Burada, street_number öğesinin confirmation_level özelliği UNCONFIRMED_BUT_PLAUSIBLE olarak ayarlanmıştır. 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 Adres Doğrulama API'si adresi tam olarak doğrulayamaz. 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 belediyesi değerleme uzmanı ofisi için geçerli bir adres girip girişe oda numarasını eklemediğini 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 özelliği gösterilmediği için sonuç false olarak görünür. 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 aşağıdakileri gösterir:

"missingComponentTypes": [
        "subpremise"
      ]

Daha ayrıntılı bir incelemenin ardından USPS verileri, D olan bir dpvConfirmation kodu sağlar. Bu kod, eksik bir alt tesis olduğunu da gösterir.