मकसद
इस दस्तावेज़ में, ई-कॉमर्स चेकआउट में Place Autocomplete, Address Validation API1, और Maps को एक साथ इस्तेमाल करने के तरीकों के बारे में बताया गया है. ऐसा बेहतर क्वालिटी वाले पते पाने के लिए किया जाता है.
ज़रूरी शर्तें
Google का सुझाव है कि आपको इनके बारे में जानकारी होनी चाहिए:
- Place Autocomplete JavaScript डेवलपर के लिए दस्तावेज़.
- तकनीकी नज़रिए से यह समझें कि जगह के नाम अपने-आप पूरे होने की सुविधा कैसे काम करती है और इसे लागू करने के विकल्प क्या हैं.
- Place Autocomplete के लिए, चेकआउट लागू करने के बारे में जानकारी देने वाली गाइड.
- ई-कॉमर्स चेकआउट पेज पर, Place Autocomplete को लागू करने के सबसे सही तरीकों के उदाहरण.
- Address Validation API प्रॉडक्ट का दस्तावेज़. इसमें पुष्टि करने का लॉजिक तैयार करना पर फ़ोकस किया गया है.
- तकनीकी नज़रिए से समझें कि Address Validation API कैसे काम करता है. साथ ही, उन सिग्नल की समीक्षा करें जिनसे पते की क्वालिटी तय होती है.
पते की पुष्टि करने की सुविधा क्या है?
Address Validation API एक ऐसी सेवा है जो पते को स्वीकार करती है. यह पते के कॉम्पोनेंट की पहचान करता है और उनके मान्य होने की पुष्टि करता है. यह पते को इस हिसाब से भी बनाता है कि उस पर डाक या कूरियर भेजा जा सके. साथ ही, उसके लिए सबसे सटीक अक्षांश/देशांतर निर्देशांक का पता लगाता है. वैकल्पिक रूप से, अमेरिका और प्योर्तो रिको में मौजूद पतों के लिए, कोडिंग एक्यूरेसी सपोर्ट सिस्टम (CASS™) चालू किया जा सकता है.चेकआउट के दौरान, पते की पुष्टि क्यों ज़रूरी है?
ऑर्डर करने की प्रोसेस के दौरान सही पते इकट्ठा करें:
यह सही समय पर डिलीवरी करने के लिए एक ज़रूरी कदम है. इससे समय पर ऑर्डर पूरा करने में मदद मिलती है. साथ ही, पते में सुधार करने के लिए लगने वाले शुल्क को कम किया जा सकता है.
खरीदारों को पता जल्दी और सही तरीके से डालने में मदद करें:
जगह के नाम अपने-आप भरने की सुविधा से, पता जल्दी डाला जा सकता है और इनपुट में होने वाली गड़बड़ियां कम हो जाती हैं. इससे खरीदार आसानी से चेकआउट कर पाते हैं. पते की पुष्टि करने वाली सुविधा, पते की क्वालिटी के बारे में सुझाव देती है. साथ ही, पते में सुधार करती है. जैसे, पते को स्टैंडर्ड फ़ॉर्मैट में लिखना और स्पेलिंग की गड़बड़ियों को ठीक करना. यह सुविधा, मेटाडेटा को बेहतर बनाती है. जैसे, रिहायशी या व्यावसायिक इलाके का इंडिकेटर देना. यह सुविधा चुनिंदा देशों/इलाकों में उपलब्ध है.
लागू करने से जुड़ी खास जानकारी
इस सेक्शन में, ई-कॉमर्स चेकआउट के लिए पते की जानकारी डालने के सुझाए गए वर्कफ़्लो के बारे में बताया गया है. इस प्रोसेस में तीन चरण होते हैं:
- शुरुआत में पता कैप्चर करने के लिए, Place Autocomplete का इस्तेमाल करें.
- Address Validation API का इस्तेमाल करके, डाले गए पते की पुष्टि करें.
- खरीदारों को डिलीवरी के बारे में भरोसा दिलाने के लिए, मैप पर डाले गए पते की जगह दिखाएं.
इसके बाद, हम हर चरण के बारे में अलग-अलग जानकारी देंगे.
पहला चरण: पते की जानकारी भरने का फ़्लो - Place Autocomplete सेवा का इस्तेमाल करना
पते की जानकारी भरने वाले फ़ॉर्म की पहली लाइन में, JavaScript API का इस्तेमाल करके जगह के नाम अपने-आप भरने की सुविधा लागू करें.
जगह के नाम अपने-आप पूरे होने की सुविधा, ग्राहक को पते की जानकारी डालते समय सुझाव देती है. JavaScript API का इस्तेमाल करके लागू करने पर, जैसे ही उपयोगकर्ता टाइप करना शुरू करते हैं, पते की जानकारी डालने वाले फ़ॉर्म फ़ील्ड के नीचे एक ड्रॉप-डाउन दिखता है. इसमें, ऑटोकंप्लीट सेवा से मिले नतीजे दिखते हैं. ये नतीजे, हर कीस्ट्रोक के साथ अपडेट होते हैं. जब उपयोगकर्ता पते को ढूंढने के लिए ज़रूरी जानकारी डाल देता है, तो वह ड्रॉप-डाउन से उसे चुनता है. इस कार्रवाई से, फ़ॉर्म फ़ील्ड में पते का डेटा अपने-आप भर जाता है.
जगह की जानकारी अपने-आप भरने की सुविधा के साथ, उपयोगकर्ता को फ़ॉर्म एंट्री के दो स्टाइल दिए जा सकते हैं: सभी पते वाले फ़ील्ड के साथ डिसप्ले या एक इनपुट फ़ील्ड के साथ डिसप्ले. इस एक इनपुट फ़ील्ड में, उपयोगकर्ता को पता टाइप करते ही खोज शुरू करने का विकल्प मिलता है. इसके लिए, उसे पते के कॉम्पोनेंट अलग-अलग डालने की ज़रूरत नहीं होती. पते की जानकारी अपने-आप भरने की सुविधा चालू होने पर, फ़ॉर्म फ़ील्ड में पते की जानकारी अपने-आप भर जाती है. इससे खरीदार को जानकारी की समीक्षा करने और उसमें बदलाव करने का मौका मिलता है. उदाहरण के लिए, अपार्टमेंट या यूनिट नंबर जोड़ना.
यहां एक इनपुट फ़ील्ड का इस्तेमाल करके, इस फ़्लो का उदाहरण दिया गया है:

दूसरा चरण: पतों की पुष्टि करने के लिए, Address Validation API का इस्तेमाल करना
उपयोगकर्ता के पता डालने के बाद, Google आपको चेकआउट के समय Address Validation API को कॉल करने का सुझाव देता है. इससे यह पुष्टि की जा सकेगी कि पता मान्य है और इसमें पूरी जानकारी दी गई है. उपयोगकर्ता के पता फ़ॉर्म पर मौजूद 'आगे बढ़ें' या 'जारी रखें' बटन पर क्लिक करने पर, Address Validation API को कॉल ट्रिगर करें. यह बटन अक्सर पेमेंट पेज पर ले जाता है.
Google का सुझाव है कि हर लेन-देन के लिए, Address Validation API को कॉल करें.
यहां दिए गए फ़्लो डायग्राम में, चेकआउट के दौरान Address Validation API को पूरी तरह से इंटिग्रेट करने का उदाहरण दिखाया गया है:

इस दस्तावेज़ में, पते को स्वीकार करने से जुड़ी स्थितियों के बारे में बाद में बताया गया है.
तीसरा चरण: पुष्टि के लिए विज़ुअल सबूत देना
पता डालने के बाद, उपयोगकर्ता को डिलीवरी की जगह की पुष्टि करने के लिए, उसे मैप पर दिखाएं. इससे खरीदार को यह भरोसा मिलता है कि पता सही है. साथ ही, इससे डिलीवरी या पिकअप में होने वाली समस्याएं कम होती हैं.
इस मैप को चेकआउट की प्रोसेस के दौरान दिखाया जा सकता है. इसके अलावा, इसे लेन-देन की पुष्टि करने वाले ईमेल में भी भेजा जा सकता है. इन दोनों इस्तेमाल के उदाहरणों को इन एपीआई की मदद से पूरा किया जा सकता है.
| Maps JavaScript API, उपयोगकर्ता की जगह दिखाने के लिए एक इंटरैक्टिव मैप उपलब्ध कराता है. | Maps Static API की मदद से, वेब पेज में इमेज एम्बेड की जा सकती है. इसके अलावा, ईमेल में बाद में भी इमेज एम्बेड की जा सकती है. |
|---|---|
![]() |
![]() |
डीप डाइव - पते के स्वीकार किए जाने से जुड़े उदाहरण
Address Validation API से मिले जवाबों को तीन मुख्य स्थितियों के हिसाब से बांटा जा सकता है:
- ठीक करें—पता खराब क्वालिटी का है. आपको ज़्यादा जानकारी के लिए प्रॉम्प्ट करना चाहिए.
- पुष्टि करें—पता अच्छी क्वालिटी का है, लेकिन इसमें इनपुट किए गए पते से कुछ बदलाव किए गए हैं. पुष्टि करने के लिए कहा जा सकता है.
- स्वीकार करें—पता अच्छी क्वालिटी का है. आपके पास दिए गए पते को स्वीकार करने का विकल्प होता है.
इस कॉन्सेप्ट के बारे में, Address Validation API के दस्तावेज़ों के पुष्टि करने का लॉजिक बनाना सेक्शन में बताया गया है. हम इस सेक्शन में हर स्थिति के बारे में चर्चा करेंगे.
ठीक करें
इस सेक्शन में, पते की जानकारी डालने से जुड़ी समस्या को ठीक करने का तरीका बताया गया है. Address Validation API, खराब क्वालिटी वाले पते के बारे में बताने के लिए कुछ खास सिग्नल दिखाता है. इनके बारे में जानने के लिए, पते की समस्या हल करना लेख पढ़ें. यह लेख, पुष्टि करने का लॉजिक बनाने से जुड़े दस्तावेज़ में मौजूद है.
अगर Address Validation API से मिले जवाब में पता अमान्य बताया गया है, तो ग्राहक को पता डालने वाले फ़ॉर्म पर रीडायरेक्ट करें. इससे वह अपना डाला गया डेटा देख पाएगा. पता ठीक करने के बाद, आपकी सेवा को Address Validation API को फिर से अनुरोध भेजना चाहिए, ताकि यह पक्का किया जा सके कि किए गए बदलाव मान्य हैं.
addressComponents लेवल पर मिले सिग्नल का इस्तेमाल करके, पते की लाइन में हुई किसी खास गड़बड़ी को भी हाइलाइट किया जा सकता है. इसका एक उदाहरण, दाईं ओर मौजूद स्क्रीनशॉट में देखा जा सकता है.
पुष्टि करें
इस सेक्शन में, पते की पुष्टि करने का तरीका बताया गया है. कुछ खास सिग्नल के बारे में जानकारी पाने के लिए, पते की पुष्टि करें में जाएं. ये सिग्नल, Address Validation API दिखाता है, ताकि यह पता चल सके कि किसी पते की पुष्टि की जानी चाहिए. इसके लिए, पुष्टि करने की प्रोसेस से जुड़े दस्तावेज़ देखें.
आपका सिस्टम अक्सर किसी उपयोगकर्ता को पते की पुष्टि करने के लिए कहेगा. उदाहरण के लिए, किसी ग्राहक ने शहर का नाम गलत लिखा है. ऐसे में, Address Validation API उस नाम को सही करेगा. आपको खरीदार से इस समस्या के ठीक होने की पुष्टि करनी चाहिए. ऐसा इसलिए है, क्योंकि एपीआई की मदद से किए गए बदलावों से, मूल रूप से डाली गई जानकारी में पूरी तरह से बदलाव हो सकता है.
खरीदार को जानकारी दिखाने के लिए, इंटरस्टीशियल मोडल का इस्तेमाल करें. इससे खरीदार को आगे बढ़ने के लिए तीन विकल्प मिलेंगे:
- एपीआई से मिले पते की पुष्टि करें. इसके बाद, सही किए गए पते का इस्तेमाल करके चेकआउट की प्रोसेस जारी रखें.
- Address Validation API से मिले सुझावों को अनदेखा करके, वह पता चुनें जिसे आपने मूल रूप से डाला था. चेकआउट की प्रोसेस सामान्य तरीके से जारी रखी जा सकती है. साथ ही, अगर आपकी प्रोसेस इसकी अनुमति देती है, तो शिपिंग से पहले ऑर्डर की समीक्षा की जा सकती है.
- ग्राहक, मोडल को रद्द कर देता है या उससे बाहर निकल जाता है. इससे वह चेकआउट की प्रोसेस के पते की जानकारी डालने वाले चरण पर वापस पहुंच जाता है. यहां वह शुरू से पता फिर से डाल सकता है और प्रोसेस को फिर से शुरू कर सकता है.
इसका एक उदाहरण, दाईं ओर मौजूद स्क्रीनशॉट में देखा जा सकता है.
स्वीकार करें
इस सेक्शन में, पते को स्वीकार करने का तरीका बताया गया है. कुछ खास सिग्नल के बारे में जानकारी पाने के लिए, पते को स्वीकार करना लेख पढ़ें. ये सिग्नल, Address Validation API दिखाता है. इनसे पता चलता है कि पता अच्छी क्वालिटी का है और इसे स्वीकार किया जाना चाहिए. यह लेख, पुष्टि करने के लॉजिक को बनाने से जुड़े दस्तावेज़ में मौजूद है.
इस स्थिति में, चेकआउट की प्रोसेस अगले चरण पर चली जानी चाहिए. जैसे, पेमेंट कैप्चर करना. साथ ही, ग्राहक को पते की क्वालिटी के बारे में कोई सूचना नहीं मिलनी चाहिए. एपीआई ने पुष्टि की है कि ग्राहक ने जो पता डाला है वह अच्छी क्वालिटी का है और उस पते पर डिलीवरी की जा सकती है.
हमारा सुझाव है कि ऑर्डर के लिए, पते की पुष्टि करने वाले एपीआई से मिले पते के डेटा का इस्तेमाल करें. ऐसा इसलिए, क्योंकि इसमें कुछ सुधार और जानकारी जोड़ी गई हो सकती है. जैसे:
- अक्षर बड़े करना
- फ़ॉर्मैटिंग से जुड़ी गड़बड़ियों को ठीक करना. उदाहरण के लिए,
- Street to St
- पते के कॉम्पोनेंट को सही क्रम में लगाना
- अमेरिका में ZIP+4.
कार्यान्वयन विचार
पते को स्वीकार करने का लॉजिक बनाते समय, पक्का करें कि गलत पता डालने की वजह से, खरीदारों को चेक आउट करने से न रोका जाए. लॉजिक को इस तरह से बनाएं कि अगर एपीआई बार-बार यह बताता है कि उनकी एंट्री अमान्य है, तो इनफ़िनिट लूप की संभावना को रोका जा सके.
Google का सुझाव है कि खरीदारों को अपना पता डालने के लिए दो मौके दें. साथ ही, दूसरी बार में उनके डाले गए पते को स्वीकार करें. भले ही, वह मान्य न हो. दूसरी बार में, हमारा लक्ष्य यह है कि वे पुष्टि किए बिना भी आगे बढ़ सकें.
दूसरी बार किए गए अनुरोध को स्वीकार करने के दो तरीके:
- आगे बढ़ने के लिए मजबूर करना: ग्राहक को एक मोडल दिखाएं, जिसमें बताया गया हो कि पता मान्य नहीं है. हालांकि, उन्हें टाइप किए गए पते के साथ आगे बढ़ने का विकल्प दें.
- बिना किसी सूचना के स्वीकार करना: अगर पते की पूरी तरह से पुष्टि नहीं होती है, तब भी बिना पुष्टि वाले चरण के, दूसरी बार किए गए अनुरोध को अपने-आप स्वीकार कर लेना.
अगर हो सके, तो अपने सिस्टम को इस तरह से डिज़ाइन करें कि वह उन पतों को फ़्लैग कर दे जिनकी पुष्टि नहीं हो पाती है. इससे ग्राहक सेवा प्रतिनिधि, ऑर्डर शिप करने से पहले उनकी समीक्षा कर पाएगा. इस अतिरिक्त जांच से, आपको किसी भी गलती का पता लगाने में मदद मिलती है.
नई इमारत बनाने से यह पता चलता है कि इस जांच का सुझाव क्यों दिया जाता है. ऐसा हो सकता है कि नई इमारत का निर्माण पूरा होने और डाक पते के डेटाबेस में उस इमारत का पता दिखने के बीच कुछ समय लगे. खरीदारों के पास, टाइप किए गए पते के साथ चेकआउट पेज पर आगे बढ़ने का विकल्प होना चाहिए. भले ही, वह मान्य न हो.
चेकआउट सेशन पूरा होने के बाद, provideValidationFeedback तरीके का इस्तेमाल करके, Google को पते की पुष्टि करने की किसी खास कोशिश के बारे में सुझाव/राय दें या शिकायत करें.
नतीजा
इस दस्तावेज़ में, चेकआउट फ़्लो के बारे में खास जानकारी दी गई है. इसमें Google Maps पर अपने-आप भरने की सुविधा, पते की पुष्टि करने की सुविधा, और विज़ुअल पुष्टि करने की सुविधा लागू की गई है. इस दस्तावेज़ का इस्तेमाल करके, पते की जानकारी डालने के सुझाए गए तरीकों के हिसाब से, अपने सिस्टम को डिज़ाइन करें.
अगले चरण
सही पतों की मदद से, चेकआउट, डिलीवरी, और कारोबार के संचालन को बेहतर बनाएं व्हाइटपेपर डाउनलोड करें. साथ ही, पते की पुष्टि करने की सुविधा की मदद से, चेकआउट, डिलीवरी, और कारोबार के संचालन को बेहतर बनाना वेबिनार देखें.
इस बारे में और पढ़ें:

- जगह के नाम के शुरुआती अक्षर लिखने पर पूरा नाम सुझाने की सुविधा से जुड़ा दस्तावेज़
- Address Validation API के बारे में जानकारी देने वाला दस्तावेज़
- Google Maps Platform की रिपोर्टिंग
योगदानकर्ता
हेनरिक वाल्व | सलूशन इंजीनियर
थॉमस ऐंगलरेट | सलूशन इंजीनियर
सार्थक गांगुली | सलूशन इंजीनियर
-
यूनाइटेड स्टेट्स पोस्टल सर्विस का नॉन-एक्सक्लूसिव लाइसेंसधारी. यहां दिए गए ट्रेडमार्क, United States Postal Service® के मालिकाना हक में हैं और इनका इस्तेमाल अनुमति मिलने पर ही किया जाता है: CASS™, USPS®, DPV®. ↩

