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