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

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

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

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

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

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

पते की पुष्टि करने वाले एपीआई की मदद से, यह तय किया जा सकता है कि कोई पता सही जगह का है या नहीं. अगर यह पता किसी जगह का नहीं है, तो एपीआई शायद गलत कॉम्पोनेंट की पहचान कर सकता है. इन कॉम्पोनेंट को ठीक करने के लिए, खरीदारों को कुछ कॉम्पोनेंट दिए जा सकते हैं. यहां एपीआई का इस्तेमाल करके, वर्कफ़्लो का एक नमूना दिया गया है:

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

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

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

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

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

   • ग्राहक से ऐसी जानकारी जोड़ने के लिए कहें जो मौजूद नहीं है:
     

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

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

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

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

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

संसाधन

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

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

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

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

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

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

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

यूनाइटेड स्टेट्स पोस्टल सर्विस® (USPS®)¹, पते की पुष्टि करने वाली कंपनियों की मदद करने और उन्हें सर्टिफ़िकेट देने के लिए, कोडिंग के सटीक होने की सुविधा देने वाले सिस्टम (CASSTM) को मैनेज करता है. पते की पुष्टि करने वाले एपीआई जैसी CASS CertifiedTM सेवा की पुष्टि हो चुकी है.

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

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

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

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

---

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