Adresi kabul etme - örnekler

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

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

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

Buna ek olarak, yanıtta şunlar belirtiliyor:

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

Bu sinyaller bir araya geldiğinde adresin yüksek kaliteli olduğunu gösterir.

Uç durum örnekleri: kabul etme

Aşağıdaki örneklerde, verdict değerinin 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östermektedir.

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.

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 daha ayrıntılı incelendiğinde sokak numarasının UNCONFIRMED_BUT_PLAUSIBLE olduğu görülüyor.

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

ABD'de onaylanmamış 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.

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şenleri olmayan ve validationGranularity değeri PREMISE 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,
}

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"
}