Bu belgede, Address Validation API'nin sisteminizden düzeltme davranışı gerektiren yanıt sinyalleri sağladığı bazı gerçek dünya senaryoları açıklanmaktadır. Buradaki örnekler açıklayıcıdır ancak olası her durumu kapsamaz. Bağlam için Doğrulama mantığınızı oluşturma bölümündeki İş akışına genel bakış konusuna bakın.
Yaygın örnekler: düzeltme
Bu bölümde, Address Validation API'nin daha 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, yalnızca açık adresin bulunduğu, şehir veya posta kodunun yer almadığı bir giriş gösterilmektedir.
| Adres girildi | Bölge |
|---|---|
| 21 45 40th street | ABD |
Eksik şehir ve posta kodu için karar
Aşağıdaki örnekte, yanıttaki önemli sinyaller vurgulanmıştır.
{
"inputGranularity": "PREMISE",
"validationGranularity": "OTHER",
"geocodeGranularity": "OTHER",
"hasUnconfirmedComponents": true
}
Bu sinyaller, adresin teslimat yapılamayan bir adres olduğunu gösterir. Bu nedenle, daha fazla bilgi edinmek için addressComponents adresini 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, yalnızca ülkeyi (ABD) CONFIRMED olarak döndürür.
Diğer tüm adres bileşenlerini UNCONFIRMED_BUT_PLAUSIBLE olarak döndürür ve verilerde yerleşim yeri ve posta kodu gibi bazı önemli eksiklikler olur.
Sokak numarası eksik
Bu örnekte sokak numarası eksiktir.
| Adres girildi | Bölge |
|---|---|
| Buckingham Palace Road, SW1W 9TQ Londra | Birleşik Krallık |
Eksik sokak numarası için karar
{
"inputGranularity": "PREMISE_PROXIMITY",
"validationGranularity": "ROUTE",
"geocodeGranularity": "ROUTE"
}
validationGranularity, ROUTE değerine sahip. Bu değer, sokakla eşleşme olduğunu ancak tesise ulaşmak için yeterli bilgi olmadığını gösterir. Ayrıca, kararda addressComplete özelliği eksik olduğundan false. address nesnesinin daha ayrıntılı bir sorgusu, eksik bir bileşen türünü ortaya çıkarır:
"missingComponentTypes": [
"street_number"
]
Uç durum örnekleri: düzeltme
Bazı durumlarda, bir adresi düzeltmeniz, onaylamanız veya kabul etmeniz işletmenizin özel senaryosuna bağlıdır. Aşağıdaki örneklerde, tam olarak bir düzeltme kategorisine girmeyebilecek senaryolar gösterilmektedir.
Onaylanmamış sokak numarası
Bu senaryoda Address Validation API, sağlanan sokak numarasını doğrulayamaz ancak adresin eksiksiz olduğunu belirtir.
| Adres girildi | Bölge |
|---|---|
| 84 Buckingham Palace Road, SW1W 9TQ, Londra | Birleşik Krallık |
Onaylanmamış sokak numarası için karar
Aşağıdaki örnekte önemli sinyaller vurgulanmaktadır.
{
"inputGranularity": "PREMISE",
"validationGranularity": "PREMISE_PROXIMITY",
"geocodeGranularity": "PREMISE_PROXIMITY",
"addressComplete" : true,
"hasUnconfirmedComponents": true
}
Doğrulama ayrıntı düzeyinin yalnızca tesis düzeyinde yaklaşık değerle ve onaylanmamış bileşenlerle birlikte kullanılması incelenmeye değerdir. addressComponents mülküyle ilgili bir sorgu, aşağıdaki onaylanmamış componentType öğesini gösterir:
{
"componentName": {
"text": "84",
"languageCode": "en"
},
"componentType": "street_number",
"confirmationLevel": "UNCONFIRMED_BUT_PLAUSIBLE"
}
Burada, street_number için confirmation_level, UNCONFIRMED_BUT_PLAUSIBLE olarak ayarlanmıştır. Onaylanmadı, hizmetin veri kümesindeki 84 numaralı sokak numarasını eşleştiremediği, makul ise bileşen verilerinin hâlâ geçerli olabileceği anlamına gelir.
Alt tesis eksik
Bu senaryoda, yalnızca alt tesis (ör. apartman dairesi veya departman numarası) bilgisi eksik olan bir adres açıklanmaktadır. Aksi takdirde Address Validation API, adresi tam olarak doğrulayabilir. Herhangi bir adres bileşeni eksik olduğunda olduğu gibi, addressComplete false olduğundan kararın manuel incelemesinde yer almaz.
Örneğin, bir müşterinin San Francisco şehir vergi dairesi için geçerli bir adres girdiğini ancak oda numarasını girmediğini varsayalım.
| Adres girildi | Bölge |
|---|---|
| 1 Doctor Carlton B Goodlett Place, San Francisco, CA 94102 | ABD |
Eksik alt tesis için karar
Bu örnekte, kararda addressComplete özelliği gösterilmediğinden false olarak kabul edilir. Bu nedenle, en az bir adres öğesinin beklenmedik, çözümlenmemiş veya eksik olduğunu bilirsiniz.
{
"inputGranularity": "PREMISE",
"validationGranularity": "PREMISE",
"geocodeGranularity": "PREMISE",
"hasInferredComponents": true
}
address sorgusu aşağıdaki sonuçları verir:
"missingComponentTypes": [
"subpremise"
]
Daha ayrıntılı bir inceleme yapıldığında, USPS verilerinin dpvConfirmation kodunun D olduğu ve bunun da eksik bir alt tesis olduğunu gösterdiği görülür.