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

परिचय

Address Validation API एक ऐसी सेवा है जो पते को स्वीकार करती है. यह पते के कॉम्पोनेंट की पहचान करता है और उनके मान्य होने की पुष्टि करता है. यह पते को इस हिसाब से भी बनाता है कि उस पर डाक या कूरियर भेजा जा सके. साथ ही, उसके लिए सबसे सटीक अक्षांश/देशांतर निर्देशांक का पता लगाता है. वैकल्पिक रूप से, अमेरिका और प्योर्तो रिको में मौजूद पतों के लिए, कोडिंग ऐक्युरसी सपोर्ट सिस्टम (सीएएसएस™) चालू किया जा सकता है.

Address Validation API का इस्तेमाल क्यों करें

Address Validation API की मदद से, डिलीवरी के समय का अनुमान बेहतर तरीके से लगाया जा सकता है. साथ ही, डिलीवरी में आने वाली समस्याओं को कम किया जा सकता है. इससे ग्राहकों को बेहतर अनुभव मिलता है. ऐसा खराब पतों का पता लगाकर और पते की विशेषताओं के बारे में बेहतर जानकारी हासिल करके किया जाता है.

अगर आपको पते के हर कॉम्पोनेंट की पुष्टि करने की ज़रूरत नहीं है, तो Geocoding API आपकी ज़रूरतों के लिए बेहतर विकल्प हो सकता है. Geocoding API, पतों को अक्षांश और देशांतर के निर्देशांकों में बदलता है. Address Validation API, पतों के सही होने की पुष्टि करता है. ज़्यादा जानकारी के लिए, Architecture Center में Google Maps Platform का इस्तेमाल करके, जगह की जानकारी की पुष्टि करने की सुविधा बनाना लेख पढ़ें.

Address Validation API का इस्तेमाल करके क्या-क्या किया जा सकता है

inputडेमो आज़माएं

Address Validation API की मदद से, यह पता लगाया जा सकता है कि कोई पता किसी असली जगह का है या नहीं. अगर पता किसी असली जगह का नहीं है, तो एपीआई उन कॉम्पोनेंट की पहचान कर सकता है जो शायद गलत हैं. इन कॉम्पोनेंट को अपने ग्राहकों को दिखाया जा सकता है, ताकि वे इन्हें ठीक कर सकें. एपीआई का इस्तेमाल करके बनाए गए वर्कफ़्लो का एक उदाहरण यहां दिया गया है:

1. ग्राहक पता डालता है – इस इमेज में एक सामान्य फ़ॉर्म दिखाया गया है. इसमें ग्राहक को पता डालने का विकल्प मिलता है. ऐसा हो सकता है कि यह फ़ॉर्म, चेकआउट फ़्लो का हिस्सा हो.

2. ऐप्लिकेशन, पते को एपीआई पर भेजता है – ऐप्लिकेशन, इस पते को Address Validation API में इनपुट के तौर पर पास करता है.

   

3. एपीआई, पते की पुष्टि करता है और उसे स्टैंडर्ड फ़ॉर्मैट में बदलता है – Address Validation API, जवाब में एपीआई के हिसाब से पूरा पता दिखाता है. इसके अलावा, यह भी बताता है कि कौनसी जानकारी मौजूद नहीं है.

4. ग्राहक पते की पुष्टि करता है या उसे ठीक करता है – एपीआई से मिले जवाब के आधार पर, ग्राहक को ये प्रॉम्प्ट दिखाए जा सकते हैं: A. सुझाए गए पते की पुष्टि करें. B. छूटी हुई जानकारी दें. C. पते को ठीक करें.

   

Address Validation API कैसे काम करता है

पते की पुष्टि करने की सुविधा, JSON बॉडी के तौर पर पते के साथ POST अनुरोध स्वीकार करती है. यह पते को उसके अलग-अलग कॉम्पोनेंट में बांटता है. इसके बाद, यह इन कामों को करने की कोशिश करता है:

• सही करता है—यह कॉम्पोनेंट-लेवल पर पुष्टि करने की जांच करता है. इसमें, जहां उपलब्ध हो वहां सब-परिसर भी शामिल हैं.
• पूरा करता है—यह पते के छूटे हुए या गलत कॉम्पोनेंट का पता लगाने की कोशिश करता है.
• फ़ॉर्मैट—यह पते के कॉम्पोनेंट के फ़ॉर्मैट को साफ़ करता है और उसे स्टैंडर्ड बनाता है.

संसाधन

नीचे दी गई टेबल में, Address Validation API के ज़रिए उपलब्ध संसाधनों की खास जानकारी दी गई है. साथ ही, यह भी बताया गया है कि यह एपीआई कौन-कौनसा डेटा दिखाता है. ज़्यादा जानकारी के लिए, Address Validation API का रेफ़रंस देखें.

डेटा संसाधन	डेटा वापस लाया गया
JSON फ़ॉर्मैट में पते के कॉम्पोनेंट. पते की पुष्टि करना लेख पढ़ें.	पूरा और पुष्टि किया गया पता (अगर हो सके). पते के हर कॉम्पोनेंट की पुष्टि की स्थिति. किसी पते के लिए, ये सुविधाएं कहां उपलब्ध हैं: जियोकोड पते की सटीक जानकारी डाक सेवाओं का डेटा, जहां उपलब्ध हो. पुष्टि करने के जवाब को समझना लेख पढ़ें.

Address Validation API का इस्तेमाल करने का तरीका

1	डेमो आज़माएँ	सही और गलत, दोनों तरह के पतों वाले फ़ॉर्म के साथ डेमो देखें. इस डेमो से, सेवा से मिली रिटर्न वैल्यू और JSON फ़ॉर्मैट में मिले एपीआई रिस्पॉन्स, दोनों के बारे में जानने में मदद मिलती है.
2	कवरेज की जांच करना	कवरेज की जानकारी देखें. इससे पता चलेगा कि Address Validation API किन देशों और इलाकों में काम करता है.
3	सेट अप करना	सबसे पहले, Google Cloud प्रोजेक्ट सेट अप करें और इसके बाद दिए गए निर्देशों का पालन करें.
4	पते की पुष्टि करने का अनुरोध करना	बुनियादी पते से शुरुआत करें. इसके बाद, ज़्यादा सटीक जानकारी के लिए, CASS की सुविधा चालू करें. यह सुविधा सिर्फ़ अमेरिका और प्यूर्टो रिको के पतों के लिए उपलब्ध है. पते की पुष्टि करने का अनुरोध करना लेख पढ़ें.
5	जवाब प्रोसेस करना	Address Validation API से मिले जवाब में दो प्रॉपर्टी होती हैं. इनका इस्तेमाल अलग-अलग तरीकों से किया जाता है. बुनियादी जवाब को समझना लेख पढ़ें.
6	पुष्टि करने की प्रोसेस को ज़्यादा सटीक बनाना	Address Validation API से मिले जवाबों के बारे में सुझाव/राय देकर या शिकायत करके, पते की जानकारी को ज़्यादा सटीक बनाया जा सकता है. अपडेट किए गए पतों को मैनेज करना लेख पढ़ें.

उपलब्ध क्लाइंट लाइब्रेरी

Address Validation API के लिए उपलब्ध क्लाइंट लाइब्रेरी की सूची देखने के लिए, क्लाइंट लाइब्रेरी पर जाएं.

CASS™ के बारे में जानकारी

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

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

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

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

• डेमो आज़माएं: डेमो पर जाएं
• कवरेज वाले इलाकों की समीक्षा करें: देश और इलाके के हिसाब से कवरेज की जानकारी पर जाएं
• पुष्टि के लिए पहला अनुरोध भेजें: पते की पुष्टि के लिए अनुरोध भेजें पर जाएं
• ज़्यादा पतों की पुष्टि करना: ज़्यादा पतों की पुष्टि करने के लिए, Address Validation API का इस्तेमाल करना पर जाएं