पते की पुष्टि करने वाले एपीआई का इस्तेमाल क्यों करना चाहिए
Address Validation API की मदद से, डिलीवरी का बेहतर अनुमान लगाया जा सकता है. साथ ही, डिलीवरी में होने वाली गड़बड़ियों को कम किया जा सकता है. इससे ग्राहक को बेहतर अनुभव मिलता है. इसके लिए, खराब पतों का पता लगाएं और पते की विशेषताओं के बारे में बेहतर जानकारी हासिल करें.
अगर आपको अलग-अलग पते के कॉम्पोनेंट की पुष्टि करने की ज़रूरत नहीं है, तो जियोकोडिंग एपीआई आपकी ज़रूरतों के लिए बेहतर मैच हो सकता है. जियोकोडिंग एपीआई, पतों को अक्षांश/देशांतर निर्देशांक में बदलता है, जबकि पता पुष्टि एपीआई पतों को सही होने की पुष्टि करता है. ज़्यादा जानकारी के लिए, आर्किटेक्चर सेंटर में Google Maps Platform का इस्तेमाल करके, जगह की पुष्टि करने की सुविधा बनाना देखें.
पते की पुष्टि करने वाले एपीआई की मदद से क्या-क्या किया जा सकता है
पते की पुष्टि करने वाले एपीआई की मदद से, यह तय किया जा सकता है कि कोई पता किसी जगह का है या नहीं. अगर यह पता किसी असली जगह का नहीं है, तो एपीआई शायद गलत कॉम्पोनेंट की पहचान करता है. इन कॉम्पोनेंट को ठीक करने के लिए, खरीदारों को इन्हें दिया जा सकता है. यहां एपीआई का इस्तेमाल करके, वर्कफ़्लो का सैंपल दिया गया है:
ग्राहक पता डालता है – इस इमेज में एक आसान फ़ॉर्म दिखाया गया है, जिसमें खरीदार को पता डालने की सुविधा मिलती है. यह चेकआउट प्रोसेस के हिस्से के तौर पर हो सकता है.
ऐप्लिकेशन, API को पता भेजता है – ऐप्लिकेशन इस पते को, पते की पुष्टि करने वाले एपीआई में इनपुट के तौर पर पास करता है.
एपीआई, पते की पुष्टि करता है और उसका स्टैंडर्ड तय करता है – इसके रिस्पॉन्स में, Address Validation API, एपीआई में तय किए गए पूरे पते की जानकारी देता है या यह बताता है कि जानकारी कहां मौजूद नहीं है.
ग्राहक, सुझाए गए पते में सुधार करता है या उसकी पुष्टि करता है – एपीआई से मिली जानकारी के आधार पर, ग्राहक को ये निर्देश दिए जा सकते हैं:
पुष्टि करने के लिए, ग्राहक को सुझाया गया पता दें:
ग्राहक को यह जानकारी जोड़ने के लिए कहें:
अगर एपीआई मौजूद न होने या गलत जानकारी की वजह से, इनपुट पते की पुष्टि नहीं कर पाता है, तो उपयोगकर्ता को पता ठीक करने का निर्देश दें:
पते की पुष्टि करने वाला एपीआई कैसे काम करता है
पते की पुष्टि की प्रोसेस, JSON बॉडी में पते वाले POST अनुरोध को स्वीकार करती है. यह पते को अलग-अलग कॉम्पोनेंट में बांटता है. इसके बाद, नीचे दी गई जांच और सुधार करता है:
- सही—इसमें कॉम्पोनेंट-लेवल की पुष्टि की जांच की जाती है. साथ ही, जहां उप-प्रदेश क्षेत्र उपलब्ध होते हैं वहां भी इसकी पुष्टि की जाती है.
- पूरा हो गया है—पता किन कॉम्पोनेंट के मौजूद नहीं है या गलत है, इसका पता लगाने की कोशिश करता है.
- अच्छी तरह से फ़ॉर्मैट किया गया—यह पते के कॉम्पोनेंट के फ़ॉर्मैट को साफ़ करता है और उसका स्टैंडर्ड तय करता है.
पते की पुष्टि करने वाले एपीआई को इस्तेमाल करने का तरीका देखने के लिए, डेमो देखें.
रिसॉर्स
नीचे दी गई टेबल में, Address Validation API की मदद से उपलब्ध कराए गए रिसॉर्स के बारे में खास जानकारी दी गई है. साथ ही, एपीआई से मिलने वाले डेटा के बारे में भी बताया गया है. खास जानकारी के लिए, पते की पुष्टि करने वाले एपीआई का रेफ़रंस देखें.
| डेटा रिसॉर्स | डेटा वापस किया गया |
|---|---|
|
JSON फ़ॉर्मैट में पते के कॉम्पोनेंट. पते की पुष्टि करना वाला लेख देखें. |
पूरा, पुष्टि किया गया पता (अगर संभव हो). पते के हर कॉम्पोनेंट की पुष्टि का स्टेटस. जहां पते के लिए उपलब्ध हो:
पुष्टि के जवाब को समझना देखें. |
पते की पुष्टि करने वाले एपीआई को इस्तेमाल करने का तरीका
| 1 | डेमो आज़माएं | अलग-अलग पते के फ़ॉर्म की मदद से, डेमो देखें. इनमें सही और गलत, दोनों तरह के फ़ॉर्म शामिल हैं. यह डेमो, सेवा से मिलने वाली रिटर्न वैल्यू के साथ-साथ JSON फ़ॉर्मैट वाले एपीआई रिस्पॉन्स, दोनों को एक्सप्लोर करने का बेहतर तरीका है. |
| 2 | कवरेज की जांच करें | कवरेज की जानकारी देखें और जानें कि पते की पुष्टि करने वाला एपीआई किन देशों और इलाकों में काम करता है. |
| 3 | सेट अप करें | सबसे पहले, अपना Google Cloud प्रोजेक्ट सेट अप करें और दिए गए निर्देशों को पूरा करें. |
| 4 | पते की पुष्टि का अनुरोध करना | आसान पते से शुरुआत करें. इसके बाद, ज़्यादा सटीक जानकारी के लिए, CASS को चालू किया जा सकता है (सिर्फ़ अमेरिका और PR पतों के लिए). पते की पुष्टि का अनुरोध करना लेख देखें. |
| 5 | जवाब प्रोसेस करना | पते की पुष्टि करने वाले एपीआई के रिस्पॉन्स में दो प्रॉपर्टी मिलती हैं. इनमें से हर एक को अलग-अलग तरीके से इस्तेमाल किया जाता है. बुनियादी जवाब को समझना देखें. |
| 6 | पुष्टि करने के तरीके में सुधार करना | पते की पुष्टि करने वाले एपीआई से मिले रिस्पॉन्स के बारे में सुझाव, शिकायत या राय देकर, पते की सटीक जानकारी को बेहतर बनाने में मदद की जा सकती है. अपडेट किए गए पते मैनेज करना देखें. |
उपलब्ध क्लाइंट लाइब्रेरी
पते की पुष्टि करने वाले एपीआई के लिए उपलब्ध क्लाइंट लाइब्रेरी की सूची देखने के लिए, क्लाइंट लाइब्रेरी देखें.
CASSTM के बारे में
यूनाइटेड स्टेट्स पोस्टल सर्विस® (USPS®)1, पते की पुष्टि करने वाली कंपनियों की मदद करने और उन्हें सर्टिफ़िकेट देने के लिए, कोडिंग ऐक्यूरेसी सपोर्ट सिस्टम (CASSTM) को मैनेज करती है. CASS CertifiedTM सेवा, जैसे कि Address Verification API की पुष्टि हो गई है.
सीएएसएस डिफ़ॉल्ट रूप से चालू नहीं होता है. यह सिर्फ़ "अमेरिका" और "पीआर" क्षेत्रों के लिए काम करता है. सीएएसएस को चालू करने के लिए, पुष्टि के अनुरोध के तौर पर enableUspsCass को true पर सेट करें. ज़्यादा जानकारी के लिए, पते की पुष्टि करना लेख पढ़ें.
USPS सेवाओं के इस्तेमाल के तहत, USPS आर्टिफ़िशियल तरीके से बनाए गए पतों के अनुरोधों का आकलन करता है. अगर USPS में किसी इनपुट पते की पहचान आर्टिफ़िशियल तरीके से बनाए गए के तौर पर की जा रही है, तो Google को ग्राहक के लिए पतों की पुष्टि करना बंद करना होगा. साथ ही, Google को ग्राहक की संपर्क जानकारी (नाम और पता), उससे जुड़े इनपुट पते, और इस्तेमाल के बारे में इकट्ठा किया गया डेटा यूएसपीएस को बताना होगा. एपीआई का इस्तेमाल करने का मतलब है कि आपने सेवा की इन खास शर्तों के लिए सहमति दी है.
आगे क्या करना है
- अक्सर पूछे जाने वाले सवाल देखें: अक्सर पूछे जाने वाले सवाल पेज पर जाएं
- कवरेज वाले इलाकों की समीक्षा करना: देश और इलाके के कवरेज की जानकारी पर जाएं
- पतों को ज़्यादा वॉल्यूम पर प्रोसेस करना: पतों की पुष्टि ज़्यादा वॉल्यूम पर करने के लिए, पते की पुष्टि करने वाले एपीआई का इस्तेमाल करना पर जाएं
-
Google Maps Platform, अमेरिका के 'पोस्टल सर्विस®' का नॉन-एक्सक्लूज़िव लाइसेंस रखने वाला है. नीचे दिए गए ट्रेडमार्क का मालिकाना हक अमेरिका के पोस्टल सर्विस® के पास है और इनका इस्तेमाल अनुमति के साथ किया जाता है: यूनाइटेड स्टेट्स पोस्टल सर्विस®, CASSTM, CASS CertifiedTM. ↩