Adresi kabul etme - örnekler

Bu belgede, Address Validation API'nin sisteminizden kabul davranışı gerektiren 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 bölümündeki Örnek iş akışları'na bakın.

Sık karşılaşılan örnek: kabul etme

Bu senaryoda, sisteminizin müşteri tarafından girilen bir adresi kabul edeceği bir adres gösterilmektedir.

Kabul edilebilir bir adres için karar

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

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

Bunun yanı sıra, yanıtta aşağıdakiler belirtiliyor:

• hasUnconfirmedComponents kalır false
• hasInferredComponents kalır false
• hasReplacedComponents kalır false
• hasSpellCorrectedComponents kalır false

Bu sinyaller birlikte kullanıldığında yüksek kaliteli bir adresi gösterir.

Uç durum örnekleri: kabul etme

Aşağıdaki örneklerde, verdict simgesinin, daha fazla araştırma gerektiren adres kalitesi sorunlarını gösterdiği durumlar ele alınmaktadır. Bu örnekler, sistem mantığınızı geliştirmek için daha kapsamlı bir resim elde etmek üzere mantığınızın karardan adres bileşenlerine nasıl gidebileceğini de gösterir.

ABD dışındaki ülkelerde onaylanmamış sokak numarası

Bu örnekte, tüm adres bileşenlerinin mevcut olduğu ve çıkarılan veya değiştirilen bileşenlerin olmadığı bir İtalyan adresinin girişi gösterilmektedir. Ancak validationGranularity, ROUTE'dir.

Onaylanmamış bir sokak numarası için karar

{
  "inputGranularity": "SUB_PREMISE",
  "validationGranularity": "ROUTE",
  "geocodeGranularity": "ROUTE",
  "addressComplete": true,
  "hasUnconfirmedComponents": true
}

Adres bileşenleri üzerinde yapılan ayrıntılı inceleme, sokak numarasının UNCONFIRMED_BUT_PLAUSIBLE olduğunu gösteriyor.

{
   "text": "14",
   "componentType": "street_number",
   "confirmationLevel": "UNCONFIRMED_BUT_PLAUSIBLE"
}

ABD'de onaylanmamış sokak numarası

Bu örnekte, tüm adres bileşenlerinin mevcut olduğu, çıkarım yapılan veya değiştirilen bileşenlerin olmadığı bir ABD adresinin girişi gösterilmektedir. Ancak validationGranularity, PREMISE_PROXIMITY'dir.

Onaylanmamış bir sokak numarası için USPS verileri

{
   "firstAddressLine": "975 CARSON DR",
   "cityStateZipAddressLine": "SUNNYVALE CA 94086",
   "city": "SUNNYVALE",
   "state": "CA",
   "zipCode": "94086"
   "dpvConfirmation": "N",
   "dpvFootnote": "AAM3",
   "carrierRoute": "C031",
   "carrierRouteIndicator": "D",
   "postOfficeCity": "SUNNYVALE",
   "postOfficeState": "CA",
   "fipsCountyCode": "085",
   "county": "SANTA CLARA",
}

Onaylanmış bir adres için eksik USPS verileri

Bu örnekte, tüm adres bileşenleri onaylanmış, çıkarım yapılan veya değiştirilen bileşen içermeyen ve validationGranularity değeri PREMISE olan bir ABD adresinin girişi gösterilmektedir. Ancak uspsData tam olarak doldurulmamış ve dpvConfirmation değeri içermiyor.

USPS verileri eksik olan onaylanmış bir adres için karar

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

USPS verileri eksik olan, onaylanmış bir adres için USPS verileri

{
  "standardizedAddress": {
    "firstAddressLine": "155 VIA CONDADO WAY",
    "cityStateZipAddressLine": "PALM BEACH GARDENS",
    "city": "PALM BEACH GARDENS",
    "state": "FL",
    "zipCode": "33418"
  },
  "carrierRoute": "H018",
  "postOfficeCity": "PALM BEACH GARDENS",
  "postOfficeState": "FL"
}