पते की पुष्टि करने वाले एपीआई की खास जानकारी

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

Address Validation API, किसी पते को प्रोसेस करने में आपकी मदद के लिए, कई सुविधाएं देता है. इनमें ये शामिल हैं:

• पते को उसके अलग-अलग कॉम्पोनेंट में बांटता है. इसके बाद, वह कॉम्पोनेंट लेवल की पुष्टि की जांच करता है, जिसमें सब-प्रेमिसिस (जहां उपलब्ध हो) शामिल है.

• यह नीति, पते की कॉम्पोनेंट मौजूद नहीं होने या गलत होने का पता लगाती है, मानक तय करती है, और अनुमान लगाती है.

• इस पते को अतिरिक्त जानकारी के साथ पूरा करता है. इसमें वेब पता, पते की सटीक जानकारी, और डाक सेवाओं का डेटा शामिल है.

• पूरा पता दिखाने वाली एक स्ट्रिंग देता है, जिसे एपीआई में तय किया गया है.

पुष्टि करने का डेमो आज़माएं, ताकि पता की पुष्टि करने वाले एपीआई का इस्तेमाल किया जा सके.

पते की पुष्टि करने के लिए, एपीआई को अपने वर्कफ़्लो में जोड़ें

पता पुष्टि एपीआई के सबसे आम इस्तेमाल के उदाहरणों में से एक है, ग्राहक का अनुभव बेहतर बनाना. यह पक्का करने के लिए कि ग्राहक सही पता दे रहा है. पते की पुष्टि करने में मदद मिलती है और पते की गड़बड़ियों को कम करके, पते की विशेषताओं के बारे में बेहतर जानकारी मिल जाती है.

यह इमेज एक आसान सा फ़ॉर्म दिखाती है. यह खरीदार को चेकआउट फ़्लो के दौरान पता डालने की अनुमति देता है. इस पते को, Address Validation API के इनपुट के तौर पर पास करें.

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

अगर पते की पुष्टि करने वाले एपीआई को कोई ऐसी जानकारी मिलती है जो मौजूद नहीं है, तो उपयोगकर्ता से उसे जोड़ने के लिए कहें:

अगर एपीआई जानकारी में जानकारी मौजूद नहीं होने या गलत जानकारी देने की वजह से इनपुट पते की पुष्टि नहीं कर पाता है, तो उपयोगकर्ता से प्रॉपर्टी को ठीक करने के लिए कहें:

पते की पुष्टि करने वाले एपीआई और जियोकोडिंग एपीआई में फ़र्क़

जियोकोडिंग एपीआई और पता पुष्टि एपीआई, दोनों ही इस सवाल का जवाब देने की कोशिश करते हैं, "इस उपयोगकर्ता इनपुट के लिए सबसे अच्छी जगह कौनसी है?" पते की पुष्टि करने के लिए इस्तेमाल होने वाला एपीआई, जियोकोडिंग एपीआई से अलग है. इसमें ये काम भी किए जाते हैं:

• "क्या यह उपयोगकर्ता इनपुट कोई वास्तविक पता दिखाता है?" के सवाल का जवाब दें
• इनपुट पते को समझना, चाहे इसके हिस्सों का मिलान, उपलब्ध डेटा से न किया जा सकता हो
• अलग-अलग कॉम्पोनेंट की वैधता पर सुझाव दें
• इस बात की पुष्टि करें कि पता पूरा है और ऐसे सभी ज़रूरी कॉम्पोनेंट को फ़्लैग करें जो मौजूद नहीं हैं
• मेल खाने के मकसद से, दिए गए पते को खास तौर पर फ़ॉर्मैट करना

उदाहरण के लिए, "123 नकली सेंट, माउंटेन व्यू, सीए" जैसे पते को ध्यान में रखते हुए जियोकोडिंग एपीआई माउंटेन व्यू, कैलिफ़ोर्निया के लिए बस एक जियोकोड लौटाता है और "123 नकली सड़क" को अनदेखा करता है क्योंकि माउंटेन व्यू में ऐसी कोई सड़क (या मिलते-जुलते नाम वाली) नहीं है.

वहीं दूसरी ओर, पते की पुष्टि करने वाला एपीआई यह पता लगा पाता है कि "123" एक स्ट्रीट नंबर है, "बनावटी सड़क" एक स्ट्रीट है और नतीजे के तौर पर वह कॉम्पोनेंट शामिल करता है. इस फ़्लैग को 'पुष्टि नहीं की गई' के तौर पर फ़्लैग किया जाता है. इससे, आपको पता चलता है कि यह पता वेब पते पर काम क्यों नहीं कर पा रहा है.

CASSTM के बारे में

अमेरिका के डाक सेवा® (USPS®)¹ की मदद से पते की पुष्टि करने वाली कंपनियों की मदद की जाती है. साथ ही, उन्हें कोडिंग की सही जानकारी देने वाला सहायता सिस्टम (CASSTM) भी दिया जाता है. किसी CAS CertifiedTM सेवा, जैसे कि Address Validation API की पुष्टि, इस पते पर होने की पुष्टि हो गई है कि यह किसी पते पर मौजूद जानकारी नहीं भर सकती, इसे स्टैंडर्ड बनाएं, और इसे अपडेट करके आपको सबसे नया और सटीक पता दे सके.

CASS डिफ़ॉल्ट रूप से चालू नहीं होता है और सिर्फ़ "अमेरिका" और "पीआर" क्षेत्रों में काम करता है. CASS चालू करने के लिए, पुष्टि करने के अनुरोध के हिस्से के तौर पर enableUspsCass को true पर सेट करें. ज़्यादा जानकारी के लिए, पते की पुष्टि करना देखें.

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

आगे क्या करना है

• डेमो आज़माना
• अक्सर पूछे जाने वाले सवाल
• देश और इलाके की जानकारी
• Cloud Console में सेट अप करना
• एपीआई कुंजी पाना
• क्लाइंट लाइब्रेरी

---

1. Google Maps Platform अमेरिका की Postal Service® का नॉन-एक्सक्लूसिव लाइसेंस है. यहां दिए गए ट्रेडमार्क का मालिकाना हक अमेरिका की, Postal Service® के पास है. इसका इस्तेमाल अनुमति के साथ किया जाता है: United States Postal Service®, CASSTM, CASS CertifiedTM. ↩