इस दस्तावेज़ में, कई ऐसे उदाहरण दिए गए हैं जिनमें Address Validation API, जवाब के ऐसे सिग्नल देता है जिनकी वजह से आपका सिस्टम, पते को स्वीकार कर लेता है. कॉन्टेक्स्ट के लिए, पुष्टि करने के जवाब का इस्तेमाल करना में वर्कफ़्लो की खास जानकारी देखें.
सामान्य उदाहरण: स्वीकार करें
इस उदाहरण में, एक ऐसा पता दिखाया गया है जिसे आपका सिस्टम स्वीकार करेगा.
| दर्ज किया गया पता | क्षेत्र |
|---|---|
| 76 Buckingham Palace Road, London SW1W 9TQ | यूके |
स्वीकार किए गए पते के लिए नतीजा
नीचे दिए गए उदाहरण में, अहम सिग्नल दिखाए गए हैं.
{
"inputGranularity": "PREMISE",
"validationGranularity": "PREMISE",
"geocodeGranularity": "PREMISE",
"addressComplete": true
}
इसके अलावा, verdict से ये पता चलता है:
hasUnconfirmedComponentsबनी हुई हैfalsehasInferredComponentsबनी हुई हैfalsehasReplacedComponentsबनी हुई हैfalse
इन सभी सिग्नल को एक साथ मिलाकर, पते की क्वालिटी के बारे में पता चलता है.
कभी-कभार आने वाले केस के उदाहरण: स्वीकार करें
यहां दिए गए उदाहरणों में ऐसी स्थितियां शामिल हैं जिनमें verdict से पते की क्वालिटी से जुड़ी समस्याओं का पता चलता है. इन समस्याओं की जांच करना ज़रूरी है. इन उदाहरणों से यह भी पता चलता है कि आपके लॉजिक को फ़ैसले से लेकर पते के कॉम्पोनेंट तक कैसे ले जाया जा सकता है, ताकि आपके सिस्टम के लॉजिक को बेहतर बनाने के लिए ज़्यादा जानकारी मिल सके.
अमेरिका से बाहर के ऐसे पते के लिए सड़क का नंबर जिसकी पुष्टि नहीं हुई है
इस उदाहरण में, इटली के पते की एंट्री दिखाई गई है. इसमें पते के सभी कॉम्पोनेंट मौजूद हैं. साथ ही, इसमें न तो कोई कॉम्पोनेंट शामिल किया गया है और न ही बदला गया है. हालांकि, validationGranularity, ROUTE है.
| दर्ज किया गया पता | क्षेत्र |
|---|---|
| Via Fonte Grugnale, 14 unit 2, 66054 Vasto CH, Italia | IT |
सड़क के ऐसे नंबर के लिए फ़ैसला जिसकी पुष्टि नहीं हुई है
{
"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 Carson Dr, Sunnyvale, CA 94086 | अमेरिका |
सड़क के ऐसे नंबर के लिए USPS का डेटा जिसकी पुष्टि नहीं हुई है
{
"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",
}
पुष्टि किए गए पते के लिए, USPS का अधूरा डेटा
इस उदाहरण में, अमेरिका के पते की एंट्री दिखाई गई है. इसमें पते के सभी कॉम्पोनेंट की पुष्टि की गई है. साथ ही, इसमें न तो कोई कॉम्पोनेंट शामिल किया गया है और न ही किसी कॉम्पोनेंट को बदला गया है. इसमें PREMISE का validationGranularity है. हालांकि, uspsData
पूरी तरह से नहीं भरा गया है. साथ ही, इसमें dpvConfirmation की वैल्यू मौजूद नहीं है.
| दर्ज किया गया पता | क्षेत्र |
|---|---|
| 155 Via Condado Way, Palm Beach Gardens, FL 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"
}