इस दस्तावेज़ में असल दुनिया की ऐसी कई स्थितियों के बारे में बताया गया है जिनमें Address Validation API, रिस्पॉन्स के सिग्नल देता है. इससे यह पता चलता है कि आपके सिस्टम को स्वीकार करना है या नहीं. कॉन्टेक्स्ट के लिए पुष्टि करने के रिस्पॉन्स का इस्तेमाल करना में वर्कफ़्लो की खास जानकारी देखें.
सामान्य उदाहरण: स्वीकार करें
यह उदाहरण एक ऐसा पता दिखाता है जिसमें आपका सिस्टम, ग्राहक के डाले गए पते को स्वीकार करता है.
पता डाला गया | इलाका |
---|---|
76 बकिंघम पैलेस रोड, लंदन SW1W 9TQ | यूनाइटेड किंगडम |
स्वीकार किए जाने वाले पते के बारे में फ़ैसला
नीचे दिए गए उदाहरण में अहम सिग्नल को हाइलाइट किया गया है.
{
"inputGranularity": "PREMISE",
"validationGranularity": "PREMISE",
"geocodeGranularity": "PREMISE",
"addressComplete": true
}
इसके अलावा, जवाब में नीचे दी गई जानकारी भी शामिल होती है:
hasUnconfirmedComponents
बाकी हैfalse
hasInferredComponents
बाकी हैfalse
hasReplacedComponents
बाकी हैfalse
एक साथ जोड़ने पर, ये सिग्नल एक अच्छी क्वालिटी वाले पते का संकेत देते हैं.
एज केस के उदाहरण: स्वीकार करें
ये उदाहरण उन स्थितियों के बारे में बताते हैं जिनमें verdict
, क्वालिटी से जुड़ी समस्याओं के बारे में बताता है. इन समस्याओं के लिए, आगे की जांच की ज़रूरत होती है. ये उदाहरण यह भी दिखाते हैं कि आपके लॉजिक को, नतीजे से लेकर पते के कॉम्पोनेंट तक कैसे ले जाया जा सकता है. इससे सिस्टम के लॉजिक को बेहतर बनाने के लिए, पूरी जानकारी हासिल की जा सकती है.
अमेरिका के बाहर के मोहल्ले का नंबर
इस उदाहरण में एक ऐसे इटैलियन पते की जानकारी दी गई है जिसमें पते के सभी कॉम्पोनेंट मौजूद हैं. साथ ही, इसमें कोई अनुमानित या बदला गया कॉम्पोनेंट नहीं दिखाया गया है. हालांकि, validationGranularity
, ROUTE
है.
पता डाला गया | इलाका |
---|---|
वाया फ़ॉन्ते ग्रग्नले, 14 यूनिट 2, 66054 वास्तो सीएच, इटालिया | इटली |
बिना पुष्टि वाली सड़क के नंबर के लिए नतीजा
{
"inputGranularity": "SUB_PREMISE",
"validationGranularity": "ROUTE",
"geocodeGranularity": "ROUTE",
"addressComplete": true,
"hasUnconfirmedComponents": true
}
पते के कॉम्पोनेंट की आगे की जांच से पता चला है कि सड़क का
नंबर UNCONFIRMED_BUT_PLAUSIBLE
है.
{
"text": "14",
"componentType": "street_number",
"confirmationLevel": "UNCONFIRMED_BUT_PLAUSIBLE"
}
अमेरिका में सड़क का नंबर जिसकी पुष्टि नहीं हुई है
इस उदाहरण में, अमेरिका के एक ऐसे पते की जानकारी दी गई है जिसमें पते के सभी कॉम्पोनेंट मौजूद हैं. इनमें, कोई अनुमानित या बदला गया कॉम्पोनेंट शामिल नहीं है. हालांकि, validationGranularity
, PREMISE_PROXIMITY
है.
पता डाला गया | इलाका |
---|---|
975 कार्सन डॉ॰ सनीवेल, कैलिफ़ोर्निया 94086 | अमेरिका |
ऐसी सड़क नंबर के लिए यूएसपीएस डेटा जिसकी पुष्टि नहीं हुई है
{
"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",
}
पुष्टि किए गए पते के लिए यूएसपीएस का अधूरा डेटा
इस उदाहरण में एक अमेरिका के पते की जानकारी दी गई है, जिसमें पते के सभी कॉम्पोनेंट की पुष्टि की गई है. साथ ही, इसमें कोई अनुमानित या बदला गया कॉम्पोनेंट नहीं है और PREMISE
का validationGranularity
है. हालांकि, uspsData
पूरी तरह से नहीं भरा होता है और इसमें dpvConfirmation
की वैल्यू नहीं होती है.
पता डाला गया | इलाका |
---|---|
155 वाया कोंडाडो वे, पाम बीच गार्डन, फ़्लोरिडा 33418-1703 | अमेरिका |
अधूरे यूएसपीएस डेटा के साथ पुष्टि किए गए पते के लिए नतीजा
{
"inputGranularity": "PREMISE",
"validationGranularity": "PREMISE",
"geocodeGranularity": "PREMISE",
"addressComplete": true,
}
पुष्टि किए गए पते के लिए यूएसपीएस का डेटा, जिसमें अधूरा यूएसपीएस डेटा भी शामिल है
{
"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"
}