Adresi kabul etme - örnekler

Bu belgede, Adres Doğrulama API'nin sisteminizden kabul davranışını 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üşteriler tarafından girilen adresleri kabul edeceği bir adres gösterilmektedir.

Girilen adres Bölge
76 Buckingham Palace Road, Londra SW1W 9TQ Birleşik Krallık

Kabul edilebilir bir adres için karar

Aşağıdaki örnekte önemli sinyaller vurgulanmaktadı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 ayrıntılı inceleme 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, çıkarım yapılan veya değiştirilen bileşenlerin olmadığı bir İtalyan adresinin girişi gösterilmektedir. Ancak validationGranularity, ROUTE'dir.

Girilen adres Bölge
Via Fonte Grugnale, 14 unit 2, 66054 Vasto CH, İtalya IT

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ılan veya değiştirilen bileşenlerin olmadığı bir ABD adresinin girişi gösterilmektedir. Ancak validationGranularity, PREMISE_PROXIMITY'dir.

Girilen adres Bölge
975 Carson Dr, Sunnyvale, CA 94086 ABD

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şenlerinin onaylandığı, çıkarılan veya değiştirilen bileşenlerin olmadığı ve validationGranularity değerinin PREMISE olduğu bir ABD adresinin girişi gösterilmektedir. Ancak uspsData tam olarak doldurulmamış ve dpvConfirmation değeri içermiyor.

Girilen adres Bölge
155 Via Condado Way, Palm Beach Gardens, FL 33418-1703 ABD

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

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

Eksik USPS verileri içeren 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"
}