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

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

Time Zone API का इस्तेमाल क्यों करना चाहिए

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

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

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

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

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

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

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

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

संसाधन

इस टेबल में, Time Zone API के ज़रिए उपलब्ध संसाधनों के साथ-साथ उसका डेटा भी दिया गया है.

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

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

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

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

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

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

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

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

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