इस दस्तावेज़ में, अमेरिका में पते की पुष्टि करने के बारे में बताया गया है:
- अपने वर्कफ़्लो में USPS के डेटा का इस्तेमाल करना
- यूएसपीएस डिलीवरी पॉइंट की पुष्टि करने के लिए फ़ील्ड (dpv)
- सुरक्षा से जुड़े मैसेज
आपके वर्कफ़्लो में USPS का डेटा
अमेरिका में पतों की पुष्टि करते समय, Address Validation API सेवा यह रिटर्न के uspsData हिस्से को भी पॉप्युलेट कर सकता है.
यह ऑब्जेक्ट हमेशा पॉप्युलेट नहीं होता, इसलिए आपको इस पर भरोसा नहीं करना चाहिए प्रॉपर्टी का इस्तेमाल, पतों की पुष्टि करने के लिए करता है, लेकिन के कॉम्पोनेंट का भी आकलन करती हैं.
USPS डिलीवरी पॉइंट की पुष्टि (डीपीवी)
uspsData
रिस्पॉन्स के हिस्से के तौर पर, dpvConfirmation
फ़ील्ड एक वर्ण दिखाता है. इससे आपको पता चलता है कि USPS, दिए गए पते पर डिलीवरी कर सकता है या नहीं.
इस फ़ील्ड का इस्तेमाल करके, ये तय किए जा सकते हैं:
- पता मान्य है या नहीं.
- अगर पते में सब-प्रिमाइस नंबर मौजूद नहीं है.
- अगर सब-प्रिमाइस नंबर यूएसपीएस डेटा सिस्टम में मौजूद नहीं है.
यह सेवा, चार में से किसी एक dpvConfirmation
वैल्यू को दिखाती है या फिर कोई dpvConfirmation
वैल्यू नहीं दिखाती. नीचे दी गई टेबल में, पांच संभावित नतीजों के लिए, आपके लॉजिक के इस्तेमाल से जुड़ी सुझाई गई गतिविधि के बारे में बताया गया है. ज़्यादा के लिए
इस लॉजिक के बारे में ज़्यादा जानकारी के लिए,
पुष्टि करने के रिस्पॉन्स का इस्तेमाल करें में वर्कफ़्लो की खास जानकारी.
वैल्यू |
व्यवहार |
जानकारी |
---|---|---|
N या खाली |
पते को ठीक करें |
पते के बारे में DPV की पुष्टि नहीं की गई. इसका मतलब है कि USPS, डाली गई सड़क (रास्ते) पर मौजूद, डाले गए प्रॉपर्टी नंबर को नहीं पहचानता और वहां डिलीवरी नहीं कर सकता. |
D |
पते को ठीक करें |
पते की पुष्टि सिर्फ़ मुख्य नंबर के लिए की गई थी. इसके बाद,
सेकंडरी नंबर की जानकारी मौजूद नहीं थी. |
S |
पते की पुष्टि करें |
पते की पुष्टि सिर्फ़ मुख्य नंबर के लिए की गई थी. इसके बाद, द्वितीयक संख्या मौजूद थी लेकिन उसकी पुष्टि नहीं हुई थी. इसका मतलब है कि आपने जो प्रॉपर्टी नंबर डाला है वह डाले गए रास्ते पर मौजूद है. हालांकि, USPS के मुताबिक, आपने जो सब-प्रॉपर्टी डाली है वह उस इमारत में मौजूद नहीं है. |
Y |
पता स्वीकार करें |
प्राइमरी और किसी भी सेकंडरी नंबर के लिए, पते की डीपीवी की पुष्टि की गई थी. इसका मतलब है कि यूएसपीएस, इस पते पर डिलीवरी कर सकता है. इसमें, अगर लागू हो, तो सब-प्राइमिस नंबर भी शामिल है. |
इस सेक्शन के बाकी हिस्से में असल दुनिया की स्थितियों के बारे में बताया गया है, जिनमें DPV कोड का इस्तेमाल किया जाता है.
DPV N उदाहरण - पता ठीक करें
इस उदाहरण में, मान्य पते में गलत मोहल्ले का नंबर इस्तेमाल किया गया है.
- आपका डाला गया पता: 12 Amphitheatre Parkway, Mountain View, CA, 94043
- इलाका: अमेरिका
dpvConfirmation
फ़ील्ड से यह वैल्यू मिलती है:N
यह बेहद अहम जानकारी है कि इस रास्ते पर यह प्रॉपर्टी नंबर मौजूद नहीं है. अन्य समस्या वाले पतों की तरह ही, आपके सिस्टम को की ज़रूरत नहीं है.
DPV D का उदाहरण - पता ठीक करें
इस उदाहरण में, न्यूयॉर्क में मौजूद Google के ऑफ़िस का पता दिया गया है. हालांकि, इसमें सब-प्राइमिस नहीं दिया गया है, जो पते का ज़रूरी हिस्सा है. इसे देखने के लिए: डेमो में दिया गया पता, बिना सब-प्रिमाइसेस की जानकारी के.
- डाला गया पता: 111 8th Avenue, New York, NY, 10011
- Region: अमेरिका
dpvConfirmation
फ़ील्ड यह दिखाता है:D
इससे यह पुष्टि होती है कि इनपुट में सब-प्राइमिस मौजूद नहीं था. DPV तक पहुंचने के लिए
Y में, इनपुट के हिस्से के तौर पर एक मान्य सब-प्रिमाइस शामिल होना ज़रूरी है. उदाहरण के लिए,
आपके पास FL 4 (चौथी मंज़िल) का मान्य सब-प्रिमाइस शामिल करने का विकल्प है,
Y का dpvConfirmation
मान.
DPV S उदाहरण - पते की पुष्टि करें
इस उदाहरण में, किसी ऐसे सब-प्राइमिस नंबर का इस्तेमाल किया गया है जो इमारत में मौजूद नहीं है:
- आपका डाला गया पता: 1600 Amphitheatre Parkway, Suite 101, Mountain View, CA, 94043
- इलाका: अमेरिका
dpvConfirmation
फ़ील्ड यह दिखाता है:S
इससे पता चलता है कि जबकि 1600 Amphitheatre Parkway एक पते के रूप में मौजूद है मेल स्वीकार कर सकते हैं, तो उप-प्रिमाइस स्टी 101 पते का मान्य हिस्सा नहीं है. आपके सिस्टम को उपयोगकर्ता से इस जानकारी की पुष्टि करनी होगी और उसे सुधार करने का मौका मिलता है.
डीपीवी Y का उदाहरण - पता स्वीकार करना
इस उदाहरण में, Mountain View, CA में मौजूद Googleplex के पते को, अच्छी क्वालिटी के पते के तौर पर इस्तेमाल किया गया है.
- पता डाला गया: 1600 Amphitheatre Parkway, Mountain View, CA, 94043
- इलाका: अमेरिका
dpvConfirmation
फ़ील्ड से यह वैल्यू मिलती है:Y
इस पते को यूएसपीएस की मदद से पूरी तरह डिलीवर किया जा सकता है. इससे आपको आम तौर पर होने वाले इस बात का भरोसा है कि एपीआई से अच्छी क्वालिटी का पता मिला है और इसका इस्तेमाल किया जा सकता है किया गया है.
ध्यान दें: DPV यह नहीं बताता कि पते की पुष्टि करने वाले एपीआई ने इनपुट में बदलाव, जैसे कि वर्तनी सुधार.
अमेरिका के पतों के लिए सुरक्षा से जुड़े मैसेज
इस सेक्शन में, यूएसपीएस के डेटा में दिए गए सुरक्षा फ़्लैग के बारे में बताया गया है. ये फ़्लैग, कृत्रिम तौर पर बनाए गए पतों के लिए होते हैं. इस सुरक्षा उपाय को इस तरह डिज़ाइन किया गया है कि सबमिट किए गए पते का पता लगाकर, आर्टिफ़िशियल तरीके से पते की सूची बनाना ऐसा लगता है कि इन्हें आर्टिफ़िशियल तरीके से बनाया गया है और कानूनी तौर पर हासिल नहीं किया गया है. ऐसा बहुत ही कम होता है.
जब यूएसपीएस आर्टिफ़िशियल तरीके से बनाए गए पते की पहचान करता है, errorMessage
रिस्पॉन्स की uspsData प्रॉपर्टी के फ़ील्ड में
समस्या की जानकारी देने वाला गड़बड़ी वाला मैसेज दिखना चाहिए. उदाहरण के लिए:
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.