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

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

• अपने वर्कफ़्लो में यूएसपीएस डेटा का इस्तेमाल करना
• USPS डिलीवरी पॉइंट की पुष्टि फ़ील्ड (dpv)
• सुरक्षा से जुड़े मैसेज

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

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

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

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

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

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

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

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

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

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

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

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

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

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

इस उदाहरण में, न्यूयॉर्क में मौजूद 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 ने इनपुट में कोई बदलाव किया है या नहीं. जैसे, स्पेलिंग में सुधार.

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

इस सेक्शन में, यूएसपीएस डेटा में दिए गए सुरक्षा फ़्लैग के बारे में बताया गया है. ये फ़्लैग, आर्टिफ़िशियल तरीके से बनाए गए पतों के लिए दिए जाते हैं. सुरक्षा के इस तरीके को, पतों की सूची को गलत तरीके से बनाने से रोकने के लिए डिज़ाइन किया गया है. इसके लिए, सबमिट किए गए पते का पता लगाया जाता है. इससे पता चलता है कि पता गलत तरीके से बनाया गया है और उसे कानूनी तौर पर हासिल नहीं किया गया है. हालांकि, ऐसा बहुत ही कम होता है कि 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.