Adresi kabul etme - örnekler

Bu belgede, Address Validation API'nin sisteminizden kabul yapılmasını garanti eden yanıt sinyalleri sağladığı çeşitli gerçek 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 bir müşteri tarafından girilen 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 adresin sonucu

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

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

Buna ek olarak, yanıtta aşağıdaki bilgiler de yer alır:

  • hasUnconfirmedComponents false kaldı
  • hasInferredComponents false kaldı
  • hasReplacedComponents false kaldı

Bu sinyaller birleştirildiğinde yüksek kaliteli bir adresi gösterir.

Uç durum örnekleri: kabul et

Aşağıdaki örneklerde, verdict öğesinin daha ayrıntılı inceleme yapılmasını gerektiren adres kalitesi sorunlarını belirttiği durumlar ele alınmaktadır. Bu örnekler, sistem mantığınızı geliştirmek amacıyla daha kapsamlı bir görünüm elde etmek için mantığınızın karardan adres bileşenlerine nasıl gidebileceğini de gösterir.

ABD dışı onaylanmamış sokak numarası

Bu örnekte, türetilmiş veya değiştirilen bileşenler olmadan tüm adres bileşenleri mevcut olan 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ıyla ilgili sonuç

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

Adres bileşenlerinin incelenmesi sonucunda sokak numarasının UNCONFIRMED_BUT_PLAUSIBLE olduğu tespit edilmiştir.

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

ABD'de onaylanmamış sokak numarası

Bu örnekte, tahmin edilen veya değiştirilen bileşenler olmadan tüm adres bileşenlerinin bulunduğu 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, ABD'deki bir adresin tüm adres bileşenleri onaylanmış, tahmin edilmiş veya değiştirilmiş bileşen olmadan ve PREMISE olarak validationGranularity girişi gösterilmektedir. Ancak, uspsData tamamen doldurulmaz ve bir dpvConfirmation değeri içermez.

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

Eksik USPS verileri olan onaylanmış bir adresle ilgili karar

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

Eksik USPS verilerine sahip onaylı 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"
}