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

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

Address Validation API का इस्तेमाल क्यों करना चाहिए

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

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

Address Validation API की मदद से क्या-क्या किया जा सकता है

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

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

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

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

   

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

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

   

Address Validation API के काम करने का तरीका

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

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

संसाधन

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

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

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

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

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

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

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

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

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

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

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

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