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