इस दस्तावेज़ में, अमेरिका में पते की पुष्टि करने के बारे में बताया गया है:
- अपने वर्कफ़्लो में USPS डेटा का इस्तेमाल करना
- यूएसपीएस डिलीवरी पॉइंट की पुष्टि करने वाले फ़ील्ड (डीपीवी)
- सुरक्षा से जुड़े मैसेज
आपके वर्कफ़्लो में USPS का डेटा
अमेरिका में पतों की पुष्टि करते समय, Address Validation API सेवा, रिटर्न के uspsData हिस्से को भी पॉप्युलेट कर सकती है.
यह ऑब्जेक्ट हमेशा पॉप्युलेट नहीं होता. इसलिए, पतों की पुष्टि करने के लिए, सिर्फ़ इस प्रॉपर्टी पर भरोसा नहीं करना चाहिए. इसके बजाय, अपने सिस्टम में नतीजे और पते के कॉम्पोनेंट भी शामिल करें.
यूएसपीएस डिलीवरी पॉइंट की पुष्टि (डीपीवी)
uspsData
रिस्पॉन्स के हिस्से के तौर पर, dpvConfirmation
फ़ील्ड एक वर्ण दिखाता है. इससे आपको पता चलता है कि USPS, दिए गए पते पर डिलीवरी कर सकता है या नहीं.
इस फ़ील्ड का इस्तेमाल करके, ये तय किए जा सकते हैं:
- पता मान्य है या नहीं.
- अगर पते में सब-प्रिमाइस नंबर मौजूद नहीं है.
- अगर USPS के डेटा सिस्टम में सब-प्राइमिस नंबर मौजूद नहीं है.
सेवा या तो चार dpvConfirmation
वैल्यू में से कोई एक वैल्यू दिखाती है या वह dpvConfirmation
वैल्यू नहीं दिखाती है. नीचे दी गई टेबल में, पांच संभावित नतीजों में से हर नतीजे के लिए, आपके लॉजिक के इस्तेमाल के सुझाव दिए गए हैं. इस लॉजिक के बारे में ज़्यादा जानकारी के लिए, पुष्टि करने के रिस्पॉन्स का इस्तेमाल करें में वर्कफ़्लो की खास जानकारी देखें.
वैल्यू |
व्यवहार |
जानकारी |
---|---|---|
N या खाली |
पता ठीक करना |
पते के बारे में DPV की पुष्टि नहीं की गई. इसका मतलब है कि USPS, डाली गई सड़क (रास्ते) पर मौजूद, डाले गए प्रॉपर्टी नंबर को नहीं पहचानता और वहां डिलीवरी नहीं कर सकता. |
D |
पता ठीक करना |
पते के सिर्फ़ मुख्य नंबर के लिए DPV की पुष्टि की गई थी. साथ ही, सेकंडरी नंबर की जानकारी मौजूद नहीं थी. |
S |
पते की पुष्टि करें |
सिर्फ़ प्राइमरी नंबर के लिए, पते की डीपीवी की पुष्टि की गई थी. साथ ही, सेकंडरी नंबर की जानकारी मौजूद थी, लेकिन उसकी पुष्टि नहीं की गई थी. इसका मतलब है कि जो परिसर नंबर डाला गया है वह डाले गए रास्ते पर मौजूद है, लेकिन यूएसपीएस के मुताबिक, दिया गया सब-प्रिमाइस उस इमारत में मौजूद नहीं है. |
Y |
पता स्वीकार करना |
प्राइमरी और किसी भी सेकंडरी नंबर के लिए, पते की डीपीवी की पुष्टि की गई थी. इसका मतलब है कि पते को पूरी तरह से यूएसपीएस के ज़रिए डिलीवर किया जा सकता है. इसमें सब-प्रिमाइस नंबर भी शामिल है (अगर लागू हो). |
इस सेक्शन के बाकी हिस्से में, असल दुनिया की उन स्थितियों के बारे में बताया गया है जिनमें डीपीवी कोड का इस्तेमाल किया जाता है.
DPV N उदाहरण - पता ठीक करें
इस उदाहरण में, मान्य पते में गलत मोहल्ले का नंबर इस्तेमाल किया गया है.
- पता डाला गया: 12 Amphitheatre Parkway, Mountain View, CA, 94043
- Region: अमेरिका
dpvConfirmation
फ़ील्ड से यह वैल्यू मिलती है:N
यह एक बहुत मज़बूत सिग्नल है कि इस रूट पर यह नंबर मौजूद नहीं है. समस्या वाले अन्य पतों की तरह ही, आपके सिस्टम को उपयोगकर्ता को सुधार करने के लिए कहा जाना चाहिए.
डीपीवी डी का उदाहरण - पता ठीक करना
इस उदाहरण में, न्यूयॉर्क में मौजूद Google के ऑफ़िस का पता दिया गया है. हालांकि, इसमें सब-प्राइमिस नहीं दिया गया है, जो पते का ज़रूरी हिस्सा है. सब-प्रिमाइसेस जानकारी के बिना डेमो में दिए गए पते का इस्तेमाल करके, इसे देखा जा सकता है.
- पता डाला गया: 111 8th Avenue, New York, NY, 10011
- इलाका: अमेरिका
dpvConfirmation
फ़ील्ड से यह वैल्यू मिलती है:D
इससे यह पुष्टि होती है कि इनपुट में सब-प्राइमिस मौजूद नहीं था. Y के DPV तक पहुंचने के लिए, इनपुट के हिस्से के तौर पर एक मान्य सब-प्रिमाइस शामिल करना ज़रूरी है. उदाहरण के लिए, Y की dpvConfirmation
वैल्यू पाने के लिए, FL 4 (चौथा फ़्लोर) का मान्य सब-प्राइमिस शामिल किया जा सकता है.
डीपीवी एस का उदाहरण - पते की पुष्टि करना
इस उदाहरण में, किसी ऐसे सब-प्राइमिस नंबर का इस्तेमाल किया गया है जो इमारत में मौजूद नहीं है:
- आपका डाला गया पता: 1600 Amphitheatre Parkway, Suite 101, Mountain View, CA, 94043
- इलाका: अमेरिका
dpvConfirmation
फ़ील्ड से यह वैल्यू मिलती है:S
इससे पता चलता है कि 1600 Amphitheatre Parkway एक ऐसा पता है जहां मेल भेजा जा सकता है. हालांकि, स्टोर का पता Ste 101, पते का मान्य हिस्सा नहीं है. आपका सिस्टम, उपयोगकर्ता से इस जानकारी की पुष्टि करेगा और इसे सुधारने का मौका देगा.
डीपीवी Y का उदाहरण - पता स्वीकार करना
इस उदाहरण में, Mountain View, CA में मौजूद Googleplex के पते को, अच्छी क्वालिटी के पते के तौर पर इस्तेमाल किया गया है.
- पता डाला गया: 1600 Amphitheatre Parkway, Mountain View, CA, 94043
- इलाका: अमेरिका
dpvConfirmation
फ़ील्ड यह दिखाता है:Y
USPS इस पते पर डिलीवरी कर सकता है. इससे आपको यह भरोसा मिलता है कि एपीआई ने अच्छी क्वालिटी का पता दिया है और इसका इस्तेमाल, दिए गए तरीके से किया जा सकता है.
ध्यान दें: DPV यह नहीं बताता कि पते की पुष्टि करने वाले एपीआई ने इनपुट में कोई बदलाव किया है या नहीं, जैसे कि वर्तनी में सुधार किया है.
अमेरिका के पतों के लिए सुरक्षा से जुड़े मैसेज
इस सेक्शन में, यूएसपीएस के डेटा में दिए गए सुरक्षा फ़्लैग के बारे में बताया गया है. ये फ़्लैग, कृत्रिम तौर पर बनाए गए पतों के लिए होते हैं. सुरक्षा से जुड़े इस उपाय को पते की सूची बनाने से रोकने के लिए डिज़ाइन किया गया है. ऐसा इसलिए किया गया है, ताकि सबमिट किए गए पते का पता लगाकर, उसे आर्टिफ़िशियल तरीके से बनाया गया हो और सही तरीके से नहीं बनाया गया हो. ऐसा बहुत ही कम होता है.
जब USPS किसी ऐसे पते की पहचान करता है जिसे कृत्रिम रूप से बनाया गया है, तो रिस्पॉन्स की uspsData प्रॉपर्टी के errorMessage
फ़ील्ड में, समस्या के बारे में बताने वाला गड़बड़ी का मैसेज होता है. उदाहरण के लिए:
AMS API processing was terminated due to the detection of what is determined to
be an artificially created address. No address beyond this point has been
validated and/or processed. If you believe this address was identified in error,
please contact your Vendor.