मकसद
यह दस्तावेज़, जगह के अपने-आप पूरे होने की जानकारी और पते को एक साथ मिलाने के तरीके के बारे में बताता है वैलिडेशन एपीआई1 और Maps को इन कामों के लिए ई-कॉमर्स चेकआउट में इस्तेमाल करना अच्छी क्वालिटी के पते कैप्चर कर रहा है.
ज़रूरी शर्तें
Google का सुझाव है कि आप इनका इस्तेमाल करें:
- स्थान ऑटोकंप्लीट JavaScript डेवलपर
दस्तावेज़.
- तकनीकी दृष्टिकोण से समझें कि स्थान ऑटोकंप्लीट कैसे करें और उसे लागू करने के विकल्पों के बारे में जानकारी.
- चेकआउट लागू करने की सुविधा जगह के लिए गाइड
ऑटोकंप्लीट.
- किसी साइट पर, जगह की जानकारी अपने-आप पूरा होने की सुविधा लागू करने के सबसे सही तरीकों के उदाहरण ई-कॉमर्स चेकआउट.
- पते की पुष्टि करने वाला एपीआई प्रॉडक्ट
दस्तावेज़,
फ़ोकस करने के लिए, अपनी पुष्टि करें
लॉजिक.
- तकनीकी नज़रिए से समझें कि Address Validation API का इस्तेमाल कैसे किया जाता है और उन सिग्नल की समीक्षा करें जो पते की क्वालिटी तय करते हैं.
पते की पुष्टि क्या है?
पते की पुष्टि करने वाला एपीआई, पते की पुष्टि करने वाली सेवा है. यह पते के कॉम्पोनेंट की पहचान करता है और उनकी पुष्टि करता है. यह विज्ञापन देने वालों के लिए, पता मेल करता है और इसके लिए सबसे अच्छे अक्षांश/देशांतर निर्देशांक ढूंढता है. इसके अलावा, अमेरिका और प्योर्तो रिको के पतों के लिए, इस सुविधा को चालू किया जा सकता है कोडिंग ऐक्यूरसी सपोर्ट सिस्टम (सीएएसएसटीएम).आपको चेकआउट के समय पते की पुष्टि करना क्यों ज़रूरी है?
ऑर्डर करने के दौरान सटीक पते इकट्ठा करें:
डिलीवरी को प्रमोट करने और समय पर डिलीवरी करने के लिए यह एक अहम चरण है
इससे ऑर्डर पूरा किया जाता है. साथ ही, पते में सुधार करने के लिए लगने वाले शुल्क कम किए जाते हैं.
पता फटाफट और सही तरीके से डालने के लिए ग्राहकों को गाइड करें:
ऑटोकंप्लीट की सुविधा चालू करने पर, पता फटाफट एंट्री की जा सकती है और इनपुट की गड़बड़ियां कम हो जाती हैं, जिससे
जिससे लोग आसानी से चेकआउट कर सकें. पते की पुष्टि करने से सुझाव मिलता है
पते की क्वालिटी के बारे में अपडेट देते हैं. साथ ही, स्टैंडर्ड तय करने और
स्पेलिंग की गलतियां हो सकती है और मेटाडेटा को बेहतर बनाया जा सकता है. जैसे, रिहाइशी या
कमर्शियल इंडिकेटर (यह चुनिंदा देशों में उपलब्ध है)
क्षेत्र.
लागू करने से जुड़ी खास जानकारी
इस सेक्शन में, ई-कॉमर्स के लिए पता डालने के सुझाए गए वर्कफ़्लो के बारे में बताया गया है चेकआउट. इस प्रोसेस में तीन चरण हैं:
- पते को शुरुआत में कैप्चर करने के लिए, 'जगह की जानकारी अपने-आप पूरा करें' का इस्तेमाल करें.
- डाले गए पते की पुष्टि करने के लिए, Address Verified API का इस्तेमाल करें.
- डिलीवरी देने के लिए, मैप पर डाले गए पते की जगह की जानकारी दिखाएं भरोसा करना चाहिए.
इसके बाद, हम हर चरण की अलग-अलग जांच करेंगे.
चरण 1: पता दर्ज करने का फ़्लो - स्थान ऑटोकंप्लीट सेवा का इस्तेमाल करके
जगह की जानकारी लागू करें ऑटोकंप्लीट पते के एंट्री फ़ॉर्म की पहली लाइन में JavaScript API का इस्तेमाल करके.
ऑटोकंप्लीट की सुविधा, ग्राहक को टाइप करते ही सुझाव देती है पते की जानकारी. JavaScript API का इस्तेमाल करके लागू किए जाने पर, जैसे ही उपयोगकर्ता शुरू करते हैं टाइप करते समय, पता प्रविष्टि फ़ॉर्म फ़ील्ड के नीचे एक ड्रॉप-डाउन दिखाई देगा, जिसमें नतीजे दिखाए जाएंगे अपने-आप पूरा होने वाली सेवा से ली गई है, जो हर कीस्ट्रोक के साथ अपडेट होती है. उपयोगकर्ता को एक बार पता ढूंढने के लिए पर्याप्त जानकारी दे दी है, तो वह यहां से इसे चुन लेता है ड्रॉप-डाउन चुनें. यह कार्रवाई, फ़ॉर्म फ़ील्ड में पते का डेटा अपने-आप भर देती है डेटा शामिल है.
आप स्थान ऑटोकंप्लीट की मदद से उपयोगकर्ता को दो फ़ॉर्म एंट्री स्टाइल दे सकते हैं: या तो सभी पते के फ़ील्ड वाला डिसप्ले या एक इनपुट वाला डिसप्ले फ़ील्ड में डालें. यह सिंगल इनपुट फ़ील्ड, उपयोगकर्ता को टाइप करते ही खोज शुरू करने के लिए प्रॉम्प्ट करता है, पते के कॉम्पोनेंट डालने के बजाय, एक-एक करके टाइप करें. अपने-आप पूरा होने के बाद इससे पते की जानकारी अपने-आप भर जाती है, वर्कफ़्लो, फ़ॉर्म के फ़ील्ड को पते के साथ बड़ा कर देता है डेटा की मदद से ग्राहक को अपने कारोबार की समीक्षा और उसमें बदलाव करने की अनुमति दें. उदाहरण के लिए, अपार्टमेंट या यूनिट नंबर का पता लगा सकता है.
यहां एक उदाहरण दिया गया है, जिसमें बताया गया है कि एक इनपुट फ़ील्ड का इस्तेमाल करके, यह फ़्लो कैसा दिख सकता है:
दूसरा चरण: पतों की पुष्टि करने के लिए, पते की पुष्टि करने वाले एपीआई का इस्तेमाल करना
उपयोगकर्ता के पता डालने के बाद, Google आपको पते पर पुष्टि एपीआई ताकि यह पक्का किया जा सके कि पता मान्य और पूरा है. इन लक्ष्यों के लिए कॉल ट्रिगर करें पते की पुष्टि करने वाला एपीआई, जब उपयोगकर्ता 'आगे बढ़ें' या 'जारी रखें' बटन पर क्लिक करता है पते का फ़ॉर्म भरें. यह बटन अक्सर पेमेंट पेज पर ले जाता है.
Google हर लेन-देन के लिए, Address Validation API को कॉल करने का सुझाव देता है.
नीचे दिए गए फ़्लो डायग्राम में, चेकआउट की प्रोसेस में, पते की पुष्टि करने वाला एपीआई:
इस दस्तावेज़ में पता स्वीकार करने की स्थितियों के बारे में बाद में चर्चा की गई है.
तीसरा चरण: विज़ुअल की पुष्टि करें
पता डालने के बाद, उपयोगकर्ता को डिलीवरी की पुष्टि करने के लिए विज़ुअल दिखाएं स्थान को मैप पर प्रदर्शित करके. इससे ग्राहक को अतिरिक्त इस बात का भरोसा दिलाएं कि पता सही है और इससे डिलीवरी या पिकअप की जानकारी कम हो जाती है कोई गड़बड़ी हुई.
मैप को चेकआउट की प्रोसेस के दौरान दिखाया जा सकता है या लेन-देन के दौरान भेजा जा सकता है पुष्टि करने वाला ईमेल. इन दोनों इस्तेमाल के उदाहरणों को नीचे दिए गए एपीआई का इस्तेमाल करें.
Maps JavaScript API, उपयोगकर्ता की जगह की जानकारी दिखाने के लिए एक इंटरैक्टिव मैप उपलब्ध कराता है. | Maps स्टैटिक एपीआई की मदद से, वेब पेज में या ईमेल में बाद के चरण में इमेज को जोड़ा जा सकता है. |
---|---|
![]() |
![]() |
गहराई से जानकारी - पता स्वीकार करने की स्थितियां
पता की पुष्टि करने वाले एपीआई के जवाबों को तीन मुख्य स्थितियों में रखा जा सकता है:
- अभी तक किसी भी व्यक्ति ने चेक इन नहीं किया है ठीक करें—पते की क्वालिटी अच्छी नहीं है. आपको ज़्यादा जानकारी देनी चाहिए.
- अभी तक किसी भी व्यक्ति ने चेक इन नहीं किया है पुष्टि करें—पता अच्छी क्वालिटी का है, लेकिन उसमें है डालें. आप पुष्टि करने के लिए.
- अभी तक किसी भी व्यक्ति ने चेक इन नहीं किया है स्वीकार करें—पता अच्छी क्वालिटी का है. आप दिया गया पता स्वीकार करें.
यह कॉन्सेप्ट पुष्टि बनाना लॉजिक सेक्शन में बताया गया है. साथ ही, हम आगे दी गई हर स्थिति पर चर्चा करेंगे इस सेक्शन में बताया गया है.
ठीक करें
इस सेक्शन में, पते के इनपुट को ठीक करने का तरीका बताया गया है. किसी खास विषय की जानकारी के लिए यह बताता है कि Address Validation API, खराब क्वालिटी दिखाने के लिए वापस लौटता है पता है, तो समस्या हल करने के लिए पता 'पुष्टि करने के लॉजिक का दस्तावेज़ बनाएं' सेक्शन में जाएं.
अगर Address Verified API से मिले जवाब में अमान्य पता दिखता है, तो उन्हें पता डालने वाले फ़ॉर्म पर रीडायरेक्ट कर सकते हैं, ताकि वे डाले गए डेटा की जांच कर सकें. पता ठीक हो जाने के बाद, आपको सेवा देने वाली कंपनी को पते पर फिर से भेजना होगा पुष्टि करने वाला एपीआई, ताकि यह पक्का किया जा सके कि किए गए बदलाव मान्य हैं.
सिग्नल का इस्तेमाल करके, पता लाइन की खास गड़बड़ियों को भी हाइलाइट किया जा सकता है
addressComponents
लेवल पर लौटाया गया. इसका एक उदाहरण यहां दिया गया है:
स्क्रीनशॉट को दाईं ओर ले जाएं.
पुष्टि करें
इस सेक्शन में किसी पते की पुष्टि करने का तरीका बताया गया है. किसी खास विषय की जानकारी के लिए इस बात का संकेत देता है कि Address Validation API से पता चलता है कि कोई पता ऐसा होना चाहिए तो पुष्टि करें कि पता 'पुष्टि करने के लॉजिक का दस्तावेज़ बनाएं' सेक्शन में जाएं.
आम तौर पर, आपका सिस्टम किसी पते की पुष्टि करने के लिए, उपयोगकर्ता से अनुरोध करना चाहता है. उदाहरण के लिए, कोई ग्राहक शहर के नाम की गलत स्पेलिंग लिखता है, जिसे पते के आधार पर सही किया जाएगा पुष्टि करने वाला एपीआई. इस समस्या को ठीक करने के लिए, आपको ग्राहक से संपर्क करना चाहिए. ऐसा इसलिए है, क्योंकि एपीआई की ओर से किए गए बदलावों से, मूल रूप से डाला गया.
ग्राहक को जानकारी दिखाने के लिए, अचानक दिखने वाले (इंटरस्टीशियल) मॉडल का इस्तेमाल करके, आगे बढ़ने के तीन विकल्प हैं:
- एपीआई से मिले पते और चेकआउट की प्रोसेस के ज़रिए दिए गए पते की पुष्टि करें जारी रखने के लिए, सही पते का इस्तेमाल करें.
- मूल रूप से दर्ज किए गए पते को चुनें. पते की पुष्टि करने वाला एपीआई. चेकआउट की प्रक्रिया सामान्य रूप से जारी रह सकती है और ऑर्डर को शिपिंग से पहले डाउनस्ट्रीम समीक्षा के लिए फ़्लैग किया जा सकता है, अगर आपकी प्रोसेस अनुमति देता है.
- ग्राहक मोडल विंडो को रद्द कर देता है या वापस चला जाता है और उसे चेकआउट प्रोसेस के पते की एंट्री वाले चरण में, जहां वे दोबारा दिख सकते हैं पते में बदलाव कर रहे हैं.
इसका एक उदाहरण दाईं ओर दिए गए स्क्रीनशॉट में देखा जा सकता है.
स्वीकार करें
इस सेक्शन में पते को स्वीकार करने का तरीका बताया गया है. किसी खास विषय की जानकारी के लिए यह बताता है कि Address Verified API, पते के अच्छे होने के बारे में बताता है इसे स्वीकार किया जाना चाहिए और एक दस्तावेज़ स्वीकार करें पता 'पुष्टि करने के लॉजिक का दस्तावेज़ बनाएं' सेक्शन में जाएं.
ऐसी स्थिति में, चेकआउट की प्रोसेस अगले चरण पर होनी चाहिए. पेमेंट कैप्चर करना, जिसमें क्वालिटी के बारे में ग्राहक को कोई सूचना नहीं दी जाती. एपीआई ने पुष्टि की है कि ग्राहक ने जो पता डाला है वह अच्छी क्वालिटी का है, और डिलीवर किया जा सके.
हमारा सुझाव है कि आप पते की पुष्टि करने वाले एपीआई से मिले पते का डेटा इस्तेमाल करें क्योंकि इसमें मामूली सुधार और जोड़ी गई चीज़ें शामिल हो सकती हैं, जैसे:
- अक्षर बड़े करना
- फ़ॉर्मैटिंग में सुधार, उदाहरण के लिए
- स्ट्रीट टू स्ट्रीट
- पते के कॉम्पोनेंट का सही क्रम
- ZIP+4 इस्तेमाल करते हैं.
कार्यान्वयन विचार
पता स्वीकार करने का लॉजिक बनाते समय पक्का करें कि लागू करने की प्रक्रिया अमान्य पता डालने की वजह से ग्राहक चेक आउट करने से रोक सकते हैं. निर्माण करना लॉजिक को इस तरह से सेट करें कि अगर एपीआई बार-बार यह दिखाता है कि उनकी एंट्री अमान्य है.
Google का सुझाव है कि आप अपने ग्राहकों को पता देना होगा और दूसरे कोशिश में, उनकी एंट्री स्वीकार करनी होगी, भले ही नहीं पुष्टि करने के लिए. दूसरी कोशिश में, लक्ष्य यह होता है कि भले ही उन्हें आगे बढ़ना हो पुष्टि करने के लिए.
दूसरी कोशिश को स्वीकार करने के लिए, सुझाए गए दो तरीके:
- ज़बरदस्ती आगे बढ़ें: ग्राहक को बताएं कि यह पता क्या नहीं है पुष्टि की जा रही है, लेकिन टाइप किए गए पते के साथ जारी रखने के विकल्प की अनुमति दी गई है.
- बिना पुष्टि के मंज़ूरी देना: बिना अनुमति के दूसरी कोशिश को अपने-आप स्वीकार करने के लिए पुष्टि करने वाला चरण जोड़ें, भले ही पते की पुष्टि पूरी तरह से न हो रही हो.
अगर हो सके, तो अपने सिस्टम को इस तरह से डिज़ाइन करें कि वह उन पतों को फ़्लैग करे जो पुष्टि नहीं करते हैं. इससे ग्राहक सेवा प्रतिनिधि, ऑर्डर भेजे जाने से पहले उनकी समीक्षा कर सकते हैं. यह सुरक्षा के लिए अतिरिक्त उपाय से यह पक्का किया जा सकता है कि कोई भी गलती न हो.
नई इमारत निर्माण से यह साफ़ तौर पर पता चलता है कि इस तरह की जाँच क्यों की जा रही है सुझाया गया. नई इमारत बनने में थोड़ा फ़र्क़ हो सकता है तैयार हो चुका है और जब उस इमारत के पते में डाक पते की जानकारी अपने-आप भर जाती है डेटाबेस. ग्राहकों के पास ज़बरदस्ती आगे बढ़ने का विकल्प होना चाहिए. चेकआउट पेज पर अपने लिखे गए पते के साथ लिखा हो, भले ही वह पुष्टि न करता हो.
चेकआउट सेशन पूरा होने के बाद, वैकल्पिक तौर पर,
provideValidationFeedback
का इस्तेमाल किया जा सकता है.
नतीजा
इस दस्तावेज़ में, चेकआउट प्रोसेस लागू करने की खास जानकारी दी गई है Google Maps पर ऑटोकंप्लीट, पते की पुष्टि, और विज़ुअल की पुष्टि. इस्तेमाल की जाने वाली चीज़ें इस दस्तावेज़ को लागू करने की शुरुआत करने के लिए, सुझाए गए पता एंट्री फ़्लो.
अगले चरण
भरोसेमंद पतों की मदद से चेकआउट, डिलीवरी, और कार्रवाइयों को बेहतर बनाएं व्हाइटपेपर और संपर्क जानकारी की मदद से चेकआउट, डिलीवरी, और ऑपरेशन को बेहतर बनाना पुष्टि वेबिनार.
आगे पढ़ने के लिए सुझाव:
- जगह के बारे में अपने-आप पूरा होने वाला दस्तावेज़
- पते की पुष्टि करने वाले एपीआई से जुड़ा दस्तावेज़
- Google Maps Platform रिपोर्टिंग
योगदानकर्ता
हेनरिक वाल्व | सॉल्यूशंस इंजीनियर
थॉमस एंगलरेट | सॉल्यूशंस इंजीनियर
सार्थक गांगुली | सलूशन इंजीनियर
-
यूनाइटेड स्टेट्स पोस्टल सर्विस का नॉन-एक्सक्लूज़िव लाइसेंसी. नीचे दिए गए ट्रेडमार्क का मालिकाना हक, United States Postal Service® के पास है. इनका इस्तेमाल अनुमति के साथ किया जाता है: CASSTM, USPS®, DPV®. ↩