Adresi düzeltme - örnekler

Bu dokümanda, Address Validation API'nin sisteminizde düzeltme davranışı gerektirebilecek yanıt sinyalleri sağladığı çeşitli gerçek dünya 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.

Not: Buradaki örnekler açıklayıcıdır ancak tüm senaryoları kapsamaz.

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,
  "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. Daha fazla bilgi edinmek için addressComponents bileşenini 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.

İşlem: Bu adres için kullanıcınızdan eksik bilgileri isteyebilirsiniz.

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",
    "possibleNextAction": "FIX"
}

possibleNextAction, adresin teslim edilemeyebileceğine dair ilk göstergeyi sağlar. Ayrıca, validationGranularity ROUTE değerine sahiptir. Bu, caddeyle 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 değerini alır. address nesnesi için yapılan başka bir sorgu, eksik bir bileşen türünü ortaya çıkarır:

"missingComponentTypes": [
        "street_number"
      ]

İşlem: Bu adres için kullanıcınızdan eksik bilgileri isteyebilirsiniz.

Sıra dışı 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,
  "possibleNextAction": "ACCEPT"
}

Onaylanmamış bileşenlerle birlikte yalnızca tesis düzeyinde yaklaşıklaştırma 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, bileşen verilerinin hâlâ geçerli olabileceği anlamına gelir.

İşlem: Girdiğiniz girişi olduğu gibi kabul edebilir veya girilen sokak numarasının yanlışlıkla mı yoksa kasıtlı olarak mı girildiğini belirlemek için müşteriyle onaylayabilirsiniz. Yanıtınız, teslimatınızla ilişkili risk düzeyine bağlıdır. Doğrulama mantığınızı oluşturma bölümündeki Uygulama yönergeleri'ne bakın.

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österilmez.

Not: Bazı ülkelerde Address Validation API, eksik alt tesisi algılayamaz. ABD'de ise eksik SUB_PREMISE, teslim edilemeyen bir adresi gösterir.

Ö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 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,
  "possibleNextAction": "CONFIRM_ADD_SUBPREMISES"
}

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.

İşlem: Bu adres için kullanıcınızdan eksik bilgileri isteyebilirsiniz.