Adresi kabul etme - örnekler

Bu belgede, Address Validation API'nin sisteminizden kabul etme davranışı gerektiren yanıt sinyalleri sağladığı bazı gerçek dünya 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.

Adres girildi 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 vurgulanmıştır.

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

Buna ek olarak, verdict şunları gösterir:

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

Bu sinyaller bir araya geldiğinde 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 amacıyla mantığınızın karardan adres bileşenlerine nasıl geçebileceğini de gösterir.

ABD dışı onaylanmamış sokak numarası

Bu örnekte, tüm adres bileşenlerinin mevcut olduğu ve tahmin edilen veya değiştirilen bileşenlerin bulunmadığı bir İtalyan adresinin girişi gösterilmektedir. Ancak validationGranularity ROUTE.

Adres girildi 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 daha ayrıntılı incelendiğinde sokak numarası için onay düzeyinin UNCONFIRMED_BUT_PLAUSIBLE olduğu görülür.

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

ABD'de doğrulanmamış sokak numarası

Bu örnekte, tüm adres bileşenlerinin mevcut olduğu, tahmin edilen veya değiştirilen bileşenlerin bulunmadığı bir ABD adresinin girişi gösterilmektedir. Ancak validationGranularity PREMISE_PROXIMITY.

Adres girildi 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şen içermeyen ve PREMISE validationGranularity 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

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