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

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

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

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

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

यूएसपीएस डिलीवरी पॉइंट की पुष्टि (डीपीवी)

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

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

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

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

वैल्यू

व्यवहार

जानकारी

N या खाली

पते को ठीक करें

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

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

D

पते को ठीक करें

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

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

S

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

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

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

हां

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

  • पता डाला गया: 1600 Amphitheatre Parkway, Mountain View, CA, 94043
  • Region: अमेरिका
  • 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.