अमेरिका के पते मैनेज करना

इस दस्तावेज़ में, अमेरिका में पते की पुष्टि करने के बारे में बताया गया है:

आपके वर्कफ़्लो में USPS का डेटा

अमेरिका में पतों की पुष्टि करते समय, Address Validation API सेवा, रिटर्न के uspsData हिस्से को भी पॉप्युलेट कर सकती है.

यह ऑब्जेक्ट हमेशा पॉप्युलेट नहीं होता. इसलिए, पतों की पुष्टि करने के लिए, सिर्फ़ इस प्रॉपर्टी पर भरोसा नहीं करना चाहिए. इसके बजाय, अपने सिस्टम में नतीजे और पते के कॉम्पोनेंट भी शामिल करें.

USPS डिलीवरी पॉइंट की पुष्टि (डीपीवी)

uspsData रिस्पॉन्स के हिस्से के तौर पर, dpvConfirmation फ़ील्ड एक वर्ण दिखाता है. इससे आपको पता चलता है कि USPS, दिए गए पते पर डिलीवरी कर सकता है या नहीं.

इस फ़ील्ड का इस्तेमाल करके, ये तय किए जा सकते हैं:

  • पता मान्य है या नहीं.
  • अगर पते में सब-प्राइमिस नंबर मौजूद नहीं है.
  • अगर USPS के डेटा सिस्टम में सब-प्राइमिस नंबर मौजूद नहीं है.

यह सेवा, चार में से किसी एक dpvConfirmation वैल्यू को दिखाती है या फिर कोई dpvConfirmation वैल्यू नहीं दिखाती. नीचे दी गई टेबल में, पांच संभावित नतीजों में से हर नतीजे के लिए, आपके लॉजिक के इस्तेमाल की संभावित गतिविधि के बारे में बताया गया है. इस लॉजिक के बारे में ज़्यादा जानकारी के लिए, पुष्टि करने का लॉजिक बनाएं में वर्कफ़्लो के उदाहरण देखें.

वैल्यू

व्यवहार

ब्यौरा

N या खाली

पता ठीक करना

पते की डीपीवी की पुष्टि नहीं हुई थी.

इसका मतलब है कि USPS, डाली गई सड़क (रास्ते) पर मौजूद, डाले गए प्राइमिस नंबर को नहीं पहचानता है और हो सकता है कि वह वहां डिलीवरी न कर पाए.

D

सब-प्राइमिस जोड़ना

सिर्फ़ प्राइमरी नंबर के लिए डीपीवी की पुष्टि की गई थी और सेकंडरी नंबर की जानकारी मौजूद नहीं थी.

इसका मतलब है कि डाली गई सड़क पर, डाला गया प्राइमिस नंबर मौजूद है. हालांकि, पूरी तरह से पुष्टि किए गए/डिलीवर किए जा सकने वाले पते तक पहुंचने के लिए, एक मान्य सब-प्राइमिस नंबर भी देना होगा. दूसरे शब्दों में, इनपुट में सब-प्राइमिस मौजूद नहीं था.

S

पते की पुष्टि करें

सिर्फ़ प्राइमरी नंबर के लिए, पते की डीपीवी की पुष्टि की गई थी. साथ ही, सेकंडरी नंबर की जानकारी मौजूद थी, लेकिन उसकी पुष्टि नहीं की गई थी.

इसका मतलब है कि आपने जो प्रॉपर्टी नंबर डाला है वह डाले गए रास्ते पर मौजूद है. हालांकि, USPS के मुताबिक, आपने जो सब-प्रॉपर्टी डाली है वह उस इमारत में मौजूद नहीं है.

Y

पता स्वीकार करना

प्राइमरी और किसी भी सेकंडरी नंबर के लिए, पते की डीपीवी की पुष्टि की गई थी.

इसका मतलब है कि USPS, इस पते पर डिलीवरी कर सकता है. इसमें, अगर लागू हो, तो सब-प्राइमिस नंबर भी शामिल है.

इस सेक्शन के बाकी हिस्से में, असल दुनिया की उन स्थितियों के बारे में बताया गया है जिनमें डीपीवी कोड का इस्तेमाल किया जाता है.

डीपीवी एन का उदाहरण - पता ठीक करना

इस उदाहरण में, मान्य पते में गलत मोहल्ले का नंबर इस्तेमाल किया गया है.

  • आपका डाला गया पता: 12 Amphitheatre Parkway, Mountain View, CA, 94043
  • इलाका: अमेरिका
  • dpvConfirmation फ़ील्ड से यह वैल्यू मिलती है: N

यह काफ़ी मज़बूत सिग्नल है कि इस रास्ते पर यह प्रॉपर्टी नंबर मौजूद नहीं है. समस्या वाले अन्य पतों की तरह, आपके सिस्टम को उपयोगकर्ता को सुधार करने के लिए कहा जाना चाहिए.

डीपीवी डी का उदाहरण - सब-प्राइमिस जोड़ना

इस उदाहरण में, न्यूयॉर्क में मौजूद Google के ऑफ़िस का पता दिया गया है. हालांकि, इसमें सब-प्राइमिस नहीं दिया गया है, जो पते का ज़रूरी हिस्सा है. इसे देखने के लिए, डेमो में दिए गए पते का इस्तेमाल करें. इसमें सब-प्राइमिस की जानकारी शामिल नहीं होनी चाहिए.

  • डाला गया पता: 111 8th Avenue, New York, NY, 10011
  • इलाका: अमेरिका
  • dpvConfirmation फ़ील्ड से यह वैल्यू मिलती है: D

इससे यह पुष्टि होती है कि इनपुट में सब-प्राइमिस मौजूद नहीं था. Y का डीपीवी पाने के लिए, इनपुट के हिस्से के तौर पर कोई मान्य सब-प्राइमिस शामिल करना ज़रूरी है. उदाहरण के लिए, Y की dpvConfirmation वैल्यू पाने के लिए, FL 4 (चौथा फ़्लोर) का मान्य सब-प्राइमिस शामिल किया जा सकता है.

डीपीवी एस का उदाहरण - पते की पुष्टि करना

इस उदाहरण में, किसी ऐसे सब-प्राइमिस नंबर का इस्तेमाल किया गया है जो इमारत में मौजूद नहीं है:

  • आपका डाला गया पता: 1600 Amphitheatre Parkway, Suite 101, Mountain View, CA, 94043
  • इलाका: अमेरिका
  • dpvConfirmation फ़ील्ड से यह वैल्यू मिलती है: S

इससे पता चलता है कि 1600 Amphitheatre Parkway एक मान्य पता है, लेकिन सब-प्राइमिस Suite 101, पते का मान्य हिस्सा नहीं है. आपके पास, उपयोगकर्ता से इस जानकारी की पुष्टि करने का विकल्प है. साथ ही, उसे जानकारी में बदलाव करने का मौका भी दिया जा सकता है.

डीपीवी Y का उदाहरण - पता स्वीकार करना

इस उदाहरण में, Mountain View, CA में मौजूद Googleplex के पते को मान्य पते के तौर पर इस्तेमाल किया गया है.

  • आपका डाला गया पता: 1600 Amphitheatre Parkway, Mountain View, CA, 94043
  • इलाका: अमेरिका
  • dpvConfirmation फ़ील्ड से यह वैल्यू मिलती है: Y

USPS इस पते पर डिलीवरी कर सकता है. इससे आपको यह भरोसा मिलता है कि एपीआई ने अच्छी क्वालिटी का पता दिया है और आपके पास, दिए गए पते का इस्तेमाल करने का विकल्प है. हमेशा की तरह, अपने जोखिम के लेवल को ध्यान में रखते हुए यह तय करें कि आपको अपने ग्राहक से पुष्टि करने के लिए कहना है या नहीं.

ध्यान दें: डीपीवी से यह पता नहीं चलता कि पते की पुष्टि करने वाले एपीआई ने इनपुट में कोई बदलाव किया है या नहीं. जैसे, वर्तनी में सुधार करना.

अमेरिका के पतों के लिए सुरक्षा से जुड़े मैसेज

इस सेक्शन में, यूएसपीएस के डेटा में दिए गए सुरक्षा फ़्लैग के बारे में बताया गया है. ये फ़्लैग, कृत्रिम तौर पर बनाए गए पतों के लिए होते हैं. सुरक्षा से जुड़ा यह तरीका, पते की सूची को कृत्रिम तरीके से बनाने से रोकने के लिए बनाया गया है. यह पता लगाता है कि सबमिट किया गया पता, कृत्रिम तरीके से बनाया गया है या सही तरीके से हासिल किया गया है. ऐसा बहुत ही कम होता है.

जब 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.