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

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

अपने वर्कफ़्लो में USPS का डेटा इस्तेमाल करना

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

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

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

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

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

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

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

वैल्यू

व्यवहार

ब्यौरा

नहीं

या खाली है

पता ठीक करना

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

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

D

पता ठीक करना

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

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

S

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

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

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

Y

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

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

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

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

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

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

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

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

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

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

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

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

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

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