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

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

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

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

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

यूएसपीएस डिलीवरी पॉइंट वैरिफ़िकेशन (डीपीवी)

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

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

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

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

वैल्यू

व्यवहार

ब्यौरा

नहीं

या खाली

पता ठीक करना

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

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

D

पता ठीक करना

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

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

S

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

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

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

Y

पता स्वीकार करें

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

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

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

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

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

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

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

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

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

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

इससे पुष्टि होती है कि इनपुट में सब-प्रीमिस मौजूद नहीं था. डीपीवी को Y पर सेट करने के लिए, इनपुट में एक मान्य सब-प्रीमिस शामिल करना ज़रूरी है. उदाहरण के लिए, dpvConfirmation की वैल्यू Y पाने के लिए, 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

यूएसपीएस, इस पते पर पूरी तरह से डिलीवरी कर सकता है. इससे आपको पूरा भरोसा मिलता है कि एपीआई ने अच्छी क्वालिटी का पता दिया है. साथ ही, इसे दिए गए तरीके से इस्तेमाल किया जा सकता है.

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

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

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

जब यूएसपीएस को किसी पते के बारे में पता चलता है कि वह असली नहीं है, तो जवाब की 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.