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