टाइम ज़ोन एपीआई की खास जानकारी

टाइम ज़ोन एपीआई एक ऐसी सेवा है जो अक्षांश/देशांतर निर्देशांकों और मनचाहे तारीख और समय के एचटीटीपी अनुरोध स्वीकार करती है. यह जगह के लिए टाइम ज़ोन डेटा दिखाता है. इसमें यूटीसी और डेलाइट सेविंग टाइम के ऑफ़सेट शामिल हैं.

टाइम ज़ोन एपीआई का इस्तेमाल क्यों करना चाहिए

टाइम ज़ोन एपीआई की मदद से, ऐसे ऐप्लिकेशन डेवलप किए जा सकते हैं जो मैप पर चुनिंदा जगहों पर तारीख और समय के लिए टाइम ज़ोन आईडी और नाम उपलब्ध कराते हैं. उदाहरण के लिए, आपके पास टाइम ज़ोन का यह डेटा दिखाने का विकल्प होता है:

  • Google Maps Platform से, मैप पर जगहों की जानकारी के लिए स्थानीय जगह के हिसाब से समय क्षेत्र के नाम.
  • यूटीसी और डेलाइट सेविंग के लिए समय क्षेत्र ऑफ़सेट करता है.

टाइम ज़ोन का डेटा खास तौर पर तब काम आ सकता है, जब आपको अपनी वेबसाइट या ऐप्लिकेशन पर समय पर आधारित ऐसा डेटा दिखाना हो जो उपयोगकर्ताओं के काम का हो.

टाइम ज़ोन एपीआई की मदद से क्या किया जा सकता है

टाइम ज़ोन एपीआई की मदद से, पृथ्वी पर मौजूद जगहों के टाइम ज़ोन के लिए अनुरोध किया जा सकता है. साथ ही, यूटीसी से समय ऑफ़सेट और इन जगहों के लिए डेलाइट सेविंग टाइम तय किया जा सकता है.

टाइम ज़ोन एपीआई के काम करने का तरीका

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

 https://maps.googleapis.com/maps/api/timezone/json
    ?location=39.6034810%2C-119.6822510
    &timestamp=1331161200
    &key=YOUR_API_KEY

संसाधन

नीचे दी गई टेबल में टाइम ज़ोन एपीआई के ज़रिए उपलब्ध संसाधनों के साथ-साथ, मिलने वाले डेटा की खास जानकारी भी दी गई है.

डेटा रिसॉर्स डेटा वापस किया गया रिटर्न फ़ॉर्मैट
टाइमज़ोन

आपको अपना अनुरोध, जगह की जानकारी और टाइमस्टैंप के साथ देना होगा. ज़रूरी पैरामीटर देखें.

  • टाइम ज़ोन का आईडी.
  • समय क्षेत्र का नाम, वैकल्पिक रूप से स्थानीय जगह के अनुसार
  • UTC से ऑफ़सेट, सेकंड में
  • डीएसटी के लिए ऑफ़सेट, सेकंड में
  • किसी खास जवाब के उदाहरण के लिए टाइम ज़ोन देखें.
  • JSON
  • XML

टाइम ज़ोन एपीआई को इस्तेमाल करने का तरीका

1 सेट अप करना सबसे पहले अपना Google Cloud प्रोजेक्ट सेट अप करें और सेट अप करने के लिए दिए गए निर्देशों को पूरा करें.
2 टाइमज़ोन का अनुरोध करके देखें एपीआई पासकोड मिल जाने के बाद, सीधे अपने ब्राउज़र से टाइम ज़ोन एपीआई की जांच करना शुरू किया जा सकता है. ज़्यादा जानकारी के लिए, टाइमज़ोन के अनुरोध और उनके जवाब गाइड में टाइम ज़ोन के उदाहरण देखें.
3 जवाबों से जुड़ी बुनियादी बातें समझना अपने ऐप्लिकेशन या वेबसाइट में टाइमज़ोन डेटा इस्तेमाल करने का तरीका जानें. ज़्यादा जानकारी के लिए टाइम ज़ोन जवाब देखें.
5 अपने ऐप्लिकेशन में टाइमज़ोन डेटा को शामिल करें! टाइमज़ोन डेटा का इस्तेमाल करके, अलग-अलग समय के हिसाब से अलग-अलग भाषाओं के उपयोगकर्ताओं के लिए, ऐप्लिकेशन और वेबसाइटों को बेहतर बनाया जा सकता है.

उपलब्ध क्लाइंट लाइब्रेरी

इस एपीआई को नीचे दी गई क्लाइंट लाइब्रेरी में से किसी एक के ज़रिए, अपनी पसंद की भाषा में कॉल करें:

Java क्लाइंट, Python Client, Go Client, और Google Maps Services के Node.js क्लाइंट, समुदाय के साथ काम करने वाली क्लाइंट लाइब्रेरी हैं. इन्हें Apache 2.0 लाइसेंस के तहत ओपन सोर्स किया जाता है. इन्हें GitHub से डाउनलोड करें. यहां आपको इंस्टॉल करने के निर्देश और सैंपल कोड भी मिल जाएगा.

आगे क्या करना है