Bu belgede, Address Validation API'nin sisteminizden bir fix davranışı garanti eden yanıt sinyalleri sağladığı bir dizi gerçek senaryo açıklanmaktadır. İçerik için Doğrulama mantığınızı oluşturma bölümündeki İş akışına genel bakış bölümüne bakın.
Yaygın örnekler: düzeltme
Bu bölümde, Address Validation API'nin düşük kaliteli adres bilgilerini gösteren yanıt sinyalleri sağladığı yaygın örnekler açıklanmaktadır.
Şehir ve posta kodu eksik
Bu örnekte, şehir veya posta kodu olmadan yalnızca açık adresi içeren bir giriş gösterilmektedir.
Adres girildi | Bölge |
---|---|
21 45 40. sokak | ABD |
Eksik şehir ve posta kodu kararı
Aşağıdaki örnekte, yanıttan alınan önemli sinyaller vurgulanmaktadır.
{
"inputGranularity": "PREMISE",
"validationGranularity": "OTHER",
"geocodeGranularity": "OTHER",
"hasUnconfirmedComponents": true
}
Bu sinyaller, teslim edilemeyen bir adresi gösterir. Daha fazla bilgi edinmek için addressComponents
öğesini sorgulayabilirsiniz:
{
"componentName": {
"text": "21",
"languageCode": "en"
},
"componentType": "street_number",
"confirmationLevel": "UNCONFIRMED_BUT_PLAUSIBLE"
},
{
"componentName": {
"text": "45 40th street",
"languageCode": "en"
},
"componentType": "route",
"confirmationLevel": "UNCONFIRMED_BUT_PLAUSIBLE"
},
{
"componentName": {
"text": "United States",
"languageCode": "en"
},
"componentType": "country",
"confirmationLevel": "CONFIRMED"
}
Address Validation API, CONFIRMED
olarak yalnızca ülkeyi (ABD) döndürür.
Diğer tüm adres bileşenlerini UNCONFIRMED_BUT_PLAUSIBLE
olarak döndürür ve verilerde yerellik ve posta kodu gibi bazı önemli eksiklikler bulunur.
Sokak numarası eksik
Bu örnekte eksik bir sokak numarası gösterilmektedir.
Adres girildi | Bölge |
---|---|
Buckingham Palace Road, SW1W 9TQ Londra | Birleşik Krallık |
Eksik sokak numarasıyla ilgili karar
{
"inputGranularity": "PREMISE_PROXIMITY",
"validationGranularity": "ROUTE",
"geocodeGranularity": "ROUTE"
}
validationGranularity
, ROUTE
değeridir. Bu, sokakla eşleşmeyi gösterir ancak mekana ulaşmak için yeterli bilgi değildir. Buna ek olarak, kararda addressComplete
özelliği eksik olduğu için false
özelliği kullanılıyor. address
nesnesine yapılan başka bir sorguda, eksik bir bileşen türü ortaya çıkar:
"missingComponentTypes": [
"street_number"
]
Uç durum örnekleri: düzeltme
Bazı durumlarda bir adresi düzeltmeniz, onaylamanız veya kabul etmeniz, iş senaryonuza bağlı olarak farklılık gösterir. Aşağıdaki örneklerde, tam olarak "düzeltme" kategorisinde yer almayabilecek senaryolar gösterilmektedir.
Onaylanmamış sokak numarası
Bu senaryoda Address Validation API, sağlanan sokak numarasını onaylayamıyor ancak adresin tamamlandığını belirtir.
Adres girildi | Bölge |
---|---|
84 Buckingham Palace Road, SW1W 9TQ, Londra | Birleşik Krallık |
Onaylanmamış sokak numarasıyla ilgili karar
Aşağıdaki örnekte önemli sinyaller vurgulanmıştır.
{
"inputGranularity": "PREMISE",
"validationGranularity": "PREMISE_PROXIMITY",
"geocodeGranularity": "PREMISE_PROXIMITY",
"addressComplete" : true,
"hasUnconfirmedComponents": true
}
Doğrulama ayrıntı düzeyinin, onaylanmamış bileşenlerle birlikte yalnızca bina düzeyinde yaklaşık tahminle kombinasyonunu araştırmak işe yarayabilir. addressComponents
özelliğinin sorgusu, aşağıdaki onaylanmamış componentType
değerini gösterir:
{
"componentName": {
"text": "84",
"languageCode": "en"
},
"componentType": "street_number",
"confirmationLevel": "UNCONFIRMED_BUT_PLAUSIBLE"
}
Burada street_number
öğesinin confirmation_level
değeri
UNCONFIRMED_BUT_PLAUSIBLE
olarak ayarlanmıştır. Onaylanmamış ifadesi, hizmetin veri kümesindeki 84 olan sokak numarasıyla eşleştirilemeyeceği ve makul, bileşen verilerinin hâlâ geçerli olabileceği anlamına gelir.
Alt önerme eksik
Bu senaryoda, yalnızca bir alt binanın eksik olduğu bir adres (apartman veya departman numarası gibi) açıklanmaktadır. Aksi takdirde Address Validation API, adresi tamamen doğrulayabilir. Herhangi bir adres bileşeni eksik olduğunda olduğu gibi, addressComplete
false
olduğundan manuel olarak karar incelemesinde yer almaz.
Örnek vermek gerekirse, bir müşterinin İstanbul şehir eksperinin ofisi için geçerli bir adres girdiğini ancak girişte oda numarasını girmediğini varsayalım.
Adres girildi | Bölge |
---|---|
Doctor Carlton B Goodlett Place, San Francisco, CA 94102 | ABD |
Eksik alt önerme ile ilgili karar
Bu örnekte, sonuç addressComplete
özelliğini göstermez. Bu nedenle, false
olur. Bu nedenle, en az bir adres öğesinin beklenmedik, çözülmemiş veya eksik olduğunu bilirsiniz.
{
"inputGranularity": "PREMISE",
"validationGranularity": "PREMISE",
"geocodeGranularity": "PREMISE",
"hasInferredComponents": true
}
address
sorgusu şunları gösterir:
"missingComponentTypes": [
"subpremise"
]
Daha ayrıntılı yapılan araştırmanın ardından USPS verileri, D
kodlu bir dpvConfirmation
kodu sağlar. Bu kod, eksik bir alt önerme olduğunu da gösterir.