इस दस्तावेज़ में, कई ऐसे उदाहरण दिए गए हैं जिनमें 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 | अमेरिका |
यूएसपीएस डेटा में, सड़क का ऐसा नंबर जिसकी पुष्टि नहीं हुई है
{
"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 Via Condado Way, Palm Beach Gardens, FL 33418-1703 | अमेरिका |
यूएसपीएस के अधूरे डेटा के साथ पुष्टि किए गए पते के लिए फ़ैसला
{
"inputGranularity": "PREMISE",
"validationGranularity": "PREMISE",
"geocodeGranularity": "PREMISE",
"addressComplete": true,
}
पुष्टि किए गए ऐसे पते के लिए USPS का डेटा जिसमें USPS का अधूरा डेटा मौजूद है
{
"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"
}