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

यूरोपियन इकनॉमिक एरिया (ईईए) के डेवलपर

परिचय

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

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

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

दूसरी ज़रूरी बातें

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

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

Geocoding API v4 में SearchDestinations तरीका उपलब्ध कराया गया है. इससे बिल्डिंग के दरवाज़ों, नेविगेशन पॉइंट, और बिल्डिंग की आउटलाइन के कोऑर्डिनेट मिलते हैं. ज़्यादा जानकारी के लिए, Gecoding API v4 का डेस्टिनेशन खोजें सेक्शन देखें.

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

डेमो आज़माएं

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™ के बारे में जानकारी

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

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

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

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

  1. Google Maps Platform, United States Postal Service® का नॉन-एक्सक्लूसिव लाइसेंसधारी है. यहां दिए गए ट्रेडमार्क, United States Postal Service® के मालिकाना हक में हैं और इनका इस्तेमाल अनुमति लेकर किया जाता है: United States Postal Service®, CASS™, CASS Certified™. ↩