Adresi kabul etme - örnekler

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

Yaygın örnek: kabul edin

Bu senaryoda, sisteminizin müşteri tarafından girilen bir adresi kabul ettiği bir adres gösterilmektedir.

Adres girildi Bölge
76 Buckingham Palace Road, Londra SW1W 9TQ Birleşik Krallık

Kabul edilebilir bir adresle ilgili karar

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

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

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

  • hasUnconfirmedComponents, false olarak kaldı
  • hasInferredComponents, false olarak kaldı
  • hasReplacedComponents, false olarak kaldı

Bu sinyaller birlikte kullanıldığında yüksek kaliteli bir adres belirtir.

Uç durum örnekleri: kabul edin

Aşağıdaki örneklerde, verdict öğesinin daha ayrıntılı inceleme gerektiren kalite sorunlarını belirttiği durumlar ele alınmaktadır. Bu örnekler, sistem mantığınızı iyileştirmek amacıyla daha kapsamlı bir resim elde etmek için mantığınızın, sonuçtan adres bileşenlerine nasıl gittiğini de gösterir.

ABD dışındaki onaylanmamış bina numarası

Bu örnekte, tahmin edilen veya değiştirilmiş bileşen olmadan tüm adres bileşenlerinin bulunduğu bir İtalya adresi girişi gösterilmektedir. Ancak validationGranularity, ROUTE değerine sahiptir.

Adres girildi Bölge
Via Fonte Grugnale, 14 unit 2, 66054 VASTo CH, İtalya IT

Onaylanmamış sokak numarasıyla ilgili karar

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

Adres bileşenleri üzerinde daha fazla araştırma yapıldığında sokak numarasının UNCONFIRMED_BUT_PLAUSIBLE olduğu ortaya çıktı.

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

ABD onaylanmamış sokak numarası

Bu örnekte, tahmin edilen veya değiştirilmiş bileşen olmadan tüm adres bileşenlerinin bulunduğu bir ABD adresi girişi gösterilmektedir. Ancak validationGranularity, PREMISE_PROXIMITY değerine sahiptir.

Adres girildi Bölge
Cumhuriyet Cad. No. 28 Çankaya, Ankara 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, tahmin edilen veya değiştirilmiş bileşenler olmadan tüm adres bileşenleri onaylanmış bir ABD adresi girişi ve PREMISE değerine sahip bir validationGranularity gösterilmektedir. Ancak uspsData alanı tamamen doldurulmamış ve bir dpvConfirmation değeri içermiyor.

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