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.

Sık karşılaşılan ö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 adresini içeren bir giriş gösterilmektedir.

Girilen adres Bölge
21 45 40th street ABD

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. Bu işlem sırasında, yerleşim yeri ve posta kodu gibi bazı önemli veriler eksik kalır.

Sokak numarası eksik

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

Girilen adres Bölge
Buckingham Palace Road, SW1W 9TQ Londra Birleşik Krallık
Eksik sokak numarasıyla ilgili karar
{
    "inputGranularity": "PREMISE_PROXIMITY",
    "validationGranularity": "ROUTE",
    "geocodeGranularity": "ROUTE"
}

validationGranularity, ROUTE. 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 ortaya çıkarıyor:

"missingComponentTypes": [
        "street_number"
      ]

Sıra dışı 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, Adres Doğrulama API'si sağlanan sokak numarasını doğrulayamaz ancak adresin eksiksiz olduğunu belirtir.

Girilen adres 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 vurgulanmaktadır.

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

Yalnızca tesis düzeyinde yaklaşıma yönelik doğrulama ayrıntı düzeyi ile onaylanmamış bileşenlerin kombinasyonunu incelemeniz önerilir. addressComponents mülküyle 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 geçerli olabileceği anlamına gelir.

Alt bina eksik

Bu senaryoda, yalnızca bir alt tesisin (ör. apartman veya daire 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 mevcut değildir.

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

Girilen adres 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 false olarak değerlendirilir. 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österiyor:

"missingComponentTypes": [
        "subpremise"
      ]

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