उपयोग के उदाहरण

चेकआउट से पहले जाँचना कि पता अपने बताए गए पिन कोड से मेल खाता है

जो खरीदार ब्राउज़र में सेव की गई एंट्री से चेकआउट फ़ॉर्म ऑटोफ़िल करता है, या किसी पुराने ईमेल से पता कॉपी करता है, उसके पास कभी-कभी एक जगह का पिन कोड और दूसरी जगह का शहर का नाम आ जाता है, एक ऐसी गलती जो करना आसान है और सबमिट पर क्लिक करने से पहले भरे हुए फ़ॉर्म को जल्दी से पढ़ते समय जिसे चूक जाना भी आसान है। भौतिक सामान भेजने वाले एक ऑनलाइन स्टोर ने पाया कि गलत जगह गई या देर से पहुँची डिलीवरी की एक लगातार, हल्की धारा के पीछे ठीक यही बेमेल था, हर एक अपने आप में छोटी, लेकिन कुल मिलाकर दोबारा शिपिंग और ग्राहकों की नाराज़गी के रूप में एक असली लागत।

समाधान था चेकआउट पर, ऑर्डर की पुष्टि से पहले, अपने आप चलने वाली एक क्रॉस-चेक। फ़ॉर्म पर दर्ज पिन कोड /v1/postcode पर गया, जो बताता है कि वह कोड वास्तव में किस स्थान का है। स्टोर ने उस रिज़ॉल्व हुए स्थान की तुलना उसी फ़ॉर्म पर खरीदार के दर्ज किए गए शहर और क्षेत्र से की, और जहाँ वे साफ़ तौर पर मेल नहीं खाते थे, वहाँ ऑर्डर को आगे जाने देने और बेमेल का पता तभी चलने के बजाय जब डिलीवरी गलत जगह पहुँच जाए, चेकआउट प्रक्रिया एक सीधे संदेश के साथ रुक गई जिसमें खरीदार से आगे बढ़ने से पहले पिन कोड और शहर को दोबारा जाँचने को कहा गया।

स्टोर ने दूसरी परत के रूप में पूरे दर्ज पते को भी /v1/forward से चलाया, क्योंकि कोई पता पिन कोड और शहर की क्रॉस-चेक में पास होकर भी कहीं और असली समस्या रख सकता है, जैसे उस नाम की कोई सड़क मौजूद न हो या नंबर उस सड़क की संभावित सीमा से बाहर हो, और फ़ॉरवर्ड जियोकोडिंग कॉल से लौटे मिलान के भरोसे ने चेकआउट प्रक्रिया को पिन कोड की तुलना के साथ तौलने के लिए एक दूसरा संकेत दिया, जिससे साफ़ तौर पर खराब मिलानों को उसी छोटे पुष्टि संदेश के लिए फ़्लैग किया गया।

स्टोर ने सोच-समझकर तय किया कि इससे कितनी रुकावट जुड़े। ज़्यादातर ऑर्डर दोनों जाँचों में तुरंत पास हो गए और बिना किसी दिखने वाले बदलाव के चेकआउट से गुज़र गए, क्योंकि अधिकांश खरीदार पहली बार में ही अपना पता सही दर्ज करते हैं। केवल असली बेमेल वाले कम ऑर्डर में पुष्टि संदेश दिखा, और तब भी खरीदार को समीक्षा करके सुधारने में, या यह पुष्टि करने में कि दर्ज पता वास्तव में सही है, बस कुछ सेकंड लगे, क्योंकि कभी-कभार कोई वैध लेकिन असामान्य पता वास्तव में गलत हुए बिना भी जाँच को ट्रिगर कर सकता था।

इस तरह की जाँच खास तौर पर इसलिए अपनी लागत वसूल कर लेती है क्योंकि शिपिंग से पहले बेमेल पकड़ने की लागत उस ऑर्डर की लागत से बहुत कम है जो पहले ही गलत जगह भेजा जा चुका है, यानी दोबारा शिपमेंट, साथ में मूल डिलीवरी की देरी या उसका खो जाना, और अक्सर एक नाराज़ ग्राहक जो अब दोबारा ऑर्डर करने की कम संभावना रखता है। इसे ऑर्डर देने से पहले के कुछ सेकंड में ठीक करने से, बजाय उन दिनों के जो बाद में शिपिंग की समस्या का पता लगाने और उसे सुधारने में लगते हैं, वह लागत काफ़ी बड़ी से घटकर लगभग शून्य हो गई।

हर ऑर्डर ने एक पिन कोड जाँच और एक पता जाँच ट्रिगर की, एक ऐसा काम जो सीधे बिक्री की मात्रा के साथ बढ़ता था और मध्यम आकार के स्टोर के लिए साल के ज़्यादातर समय मुफ़्त दैनिक कोटा के भीतर रहा, और व्यस्त समय को प्रीपेड क्रेडिट ने बिना किसी खास पूर्व योजना के कवर किया।

दोनों एंडपॉइंट के दस्तावेज़ /docs/postal-code-lookup/ और /docs/forward-geocoding/ पर हैं, और दोनों के लिए सामान्य एरर हैंडलिंग का व्यवहार /docs/errors/ पर बताया गया है।