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