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