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

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

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

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

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

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

Time Zone API की मदद से क्या-क्या किया जा सकता है

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

Time Zone API कैसे काम करता है

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

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

संसाधन

नीचे दी गई टेबल में, Time Zone API से मिलने वाले संसाधनों की खास जानकारी दी गई है. साथ ही, इससे मिलने वाले डेटा की जानकारी भी दी गई है:

डेटा रिसॉर्स डेटा के आधार पर मिली जानकारी रिटर्न फ़ॉर्मैट
टाइमज़ोन

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

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

Time Zone API को इस्तेमाल करने का तरीका

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

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

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

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

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