Adresi kabul etme - örnekler

Bu dokümanda, Address Validation API'nin sisteminizden kabul davranışı gerektiren yanıt sinyalleri sağladığı çeşitli gerçek yaşam senaryoları açıklanmaktadır. Bağlam için Doğrulama yanıtını kullanma başlıklı makalenin İş akışına genel bakış bölümüne 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, London SW1W 9TQ Birleşik Krallık

Kabul edilebilir bir adresin sonucu

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

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

Buna ek olarak, yanıtta aşağıdakiler de belirtilir:

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

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

Uç durum örnekleri: kabul et

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

ABD dışındaki ülkelerde doğrulanmamış sokak numarası

Bu örnekte, tüm adres bileşenlerinin mevcut olduğu ve hiçbir bileşenin çıkarılmadığı veya değiştirilmediği bir İtalyan adresi girişi gösterilmektedir. Ancak validationGranularity ROUTE değerine sahiptir.

Adres girildi Bölge
Via Fonte Grugnale, 14 unit 2, 66054 Vasto CH, Italia 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ı bir şekilde 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, çıkarsanmış veya değiştirilmiş bileşenlerin olmadığı bir ABD adresi girişi gösterilmektedir. Ancak validationGranularity PREMISE_PROXIMITY değerine sahiptir.

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ış, varsayılan veya değiştirilmiş bileşen içermeyen ve PREMISE değerine sahip bir ABD adresi girişi gösterilmektedir. Ancak uspsData tamamen doldurulmamış ve dpvConfirmation değeri içermiyor.

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

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

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

Onaylanmış bir adres için eksik USPS verileriyle 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"
}