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

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

पते की पुष्टि करने वाले एपीआई का इस्तेमाल क्यों करना चाहिए

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

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

पता की पुष्टि करने वाले एपीआई की मदद से क्या-क्या किया जा सकता है

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

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

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

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

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

   • पुष्टि करने के लिए, ग्राहक को सुझाया गया पता बताएं:
     

   • ग्राहक से ज़रूरी जानकारी जोड़ने का अनुरोध करें:
     

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

पते की पुष्टि करने वाला एपीआई कैसे काम करता है

पते की पुष्टि करने पर, JSON फ़ॉर्मैट में दिए गए पते पर पोस्ट करने का अनुरोध स्वीकार किया जाता है. यह पते को अलग-अलग कॉम्पोनेंट में बांटता है और इसके बाद, ये जांच और सुधार करता है:

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

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

संसाधन

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

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

पते की पुष्टि करने वाले एपीआई को इस्तेमाल करने का तरीका

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

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

पते की पुष्टि करने वाले एपीआई के लिए उपलब्ध क्लाइंट लाइब्रेरी की सूची देखने के लिए, क्लाइंट लाइब्रेरी देखें.

CASSTM के बारे में जानकारी

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

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

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

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

• अक्सर पूछे जाने वाले सवाल देखें: अक्सर पूछे जाने वाले सवाल पर जाएं
• समीक्षा कवरेज वाले इलाके: देश और इलाके के कवरेज की जानकारी पर जाएं
• ज़्यादा वॉल्यूम पर पते प्रोसेस करना: ज़्यादा वॉल्यूम पर पतों को प्रोसेस करने के लिए, Address Validation API का इस्तेमाल करना पर जाएं