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

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

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

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

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

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

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

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

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

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

वैल्यू

व्यवहार

ब्यौरा

N

या खाली

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

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

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

D

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

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

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

S

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

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

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

Y

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

डीपीवी से प्राइमरी और किसी भी सेकंडरी नंबर के पते की पुष्टि हुई है.

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

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

डीपीवी N का उदाहरण - पते को ठीक करें

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

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

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

डीपीवी D का उदाहरण - पते को ठीक करें

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

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

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

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

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

  • डाला गया पता: 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

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

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

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

इस सेक्शन में, आर्टिफ़िशियली बनाए गए पतों के लिए, 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.