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

फ़्रैंचाइज़ी वेबसाइट पर लोकल कारोबारी समय जोड़ना

कई समय क्षेत्रों में लोकेशन वाली एक फ़्रैंचाइज़ी की वेबसाइट में एक ऐसी समस्या थी जिसे ठीक करने के बारे में किसी ने सोचा नहीं था: हर लोकेशन पेज पर केंद्रीय "समय" सेक्शन एक ही शेड्यूल दिखाता था, जिसे मुख्यालय में किसी ने एक बार लिखकर हर स्टोर में कॉपी कर दिया था, भले ही वह स्टोर वास्तव में किसी भी समय क्षेत्र में चलता हो। फ़्रैंचाइज़ी के क्षेत्र के पश्चिमी हिस्से की जो लोकेशन अपनी घड़ी के अनुसार शाम 9 बजे बंद होती थी, वह वेबसाइट पर वास्तविकता से तीन घंटे पहले बंद होती दिखती थी, क्योंकि समय मुख्यालय के समय के अनुसार लिखा गया था और कभी प्रति लोकेशन समायोजित नहीं किया गया।

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

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

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

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

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

दोनों एंडपॉइंट के दस्तावेज़ /docs/forward-geocoding/ और /docs/timezone-lookup/ पर हैं।