Adresi kabul etme - örnekler

Bu belgede, Address Validation API'nin sisteminizden kabul davranışı gerektiren yanıt sinyalleri sağladığı gerçek hayattaki çeşitli senaryolar açıklanmaktadır. Bağlam için Doğrulama yanıtını kullanma bölümündeki İş akışına genel bakış konusuna bakın.

Yaygın örnek: kabul etme

Bu senaryoda, sisteminizin müşteri tarafından girilen bir adresi 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
}

Buna ek olarak, verdict aşağıdaki bilgileri gösterir:

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

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

Sıra dışı durum örnekleri: kabul etme

Aşağıdaki örneklerde, verdict öğesinin 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 doğrulanmamış 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.

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şenlerinin daha ayrıntılı bir şekilde incelenmesi, sokak numarası için onay düzeyinin 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.

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şenleri onaylanmış, çıkarım yapılan veya değiştirilen bileşenler içermeyen ve PREMISE validationGranularity'si olan 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"
}