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

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

आपके वर्कफ़्लो में यूएसपीएस डेटा

अमेरिका में पतों की पुष्टि करते समय, पते की पुष्टि करने वाले एपीआई की सेवा, रिटर्न के uspsData वाले हिस्से को भी भर सकती है.

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

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

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

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

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

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

वैल्यू

व्यवहार

जानकारी

नहीं या खाली है

पता ठीक करें

पते की DPV की पुष्टि नहीं की गई.

इसका मतलब है कि USPS में सड़क (रास्ते) पर डाला गया परिसर का नंबर नहीं पहचाना गया है और वह वहां डिलीवर नहीं कर सकता.

D

पता ठीक करें

सिर्फ़ मुख्य नंबर के लिए DPV का पता दिया गया था. इस पते में सेकंडरी नंबर की जानकारी नहीं थी.

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

S

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

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

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

हां

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

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

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

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

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

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

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

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

DPV D का उदाहरण - पता ठीक करना

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

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

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

DPV S का उदाहरण - पते की पुष्टि करें

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

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

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

DPV Y का उदाहरण - पता स्वीकार करें

इस उदाहरण में माउंटेन व्यू, कैलिफ़ोर्निया में Googleplex पते का इस्तेमाल किया गया है. यह एक जाना-पहचाना क्वालिटी पता है.

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

इस पते पर USPS की मदद से पूरी तरह से डिलीवरी की जा सकती है. इससे आपको बहुत ज़्यादा भरोसा होता है कि एपीआई से अच्छी क्वालिटी वाला पता मिला है और इसका इस्तेमाल जैसा किया जा सकता है.

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

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

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

जब यूएसपीएस आर्टिफ़िशियल तरीके से बनाए गए किसी पते की पहचान करता है, तो रिस्पॉन्स की 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.