Time Zone API, पृथ्वी की सतह पर मौजूद जगहों के लिए टाइम ऑफ़सेट डेटा उपलब्ध कराता है. किसी अक्षांश/देशांतर और तारीख के हिसाब से टाइम ज़ोन की जानकारी का अनुरोध करें. एपीआई, उस टाइम ज़ोन का नाम, यूटीसी से टाइम ऑफ़सेट, और डेलाइट सेविंग ऑफ़सेट दिखाता है.
अनुरोध और जवाब का उदाहरण
HTTPS इंटरफ़ेस के ज़रिए Time Zone API को ऐक्सेस करें. इसके लिए, अनुरोधों को यूआरएल स्ट्रिंग के तौर पर बनाया जाता है. इसमें अक्षांश/देशांतर के निर्देशांकों का इस्तेमाल करके location, तारीख तय करने के लिए timestamp, और आपकी एपीआई कुंजी तय की जाती है.
नीचे दी गई क्वेरी, अमेरिका के नेवाडा राज्य के लिए टाइम ज़ोन का अनुरोध करती है. टाइमस्टैंप को 8 मार्च, 2012 पर सेट किया गया है.
URL
https://maps.googleapis.com/maps/api/timezone/json ?location=39.6034810%2C-119.6822510 ×tamp=1733428634 &key=YOUR_API_KEY
curl
curl -L -X GET 'https://maps.googleapis.com/maps/api/timezone/json?location=39.6034810%2C-119.6822510×tamp=1733428634&key=YOUR_API_KEY'
इसकी जांच करने के लिए, यूआरएल को अपने वेब ब्राउज़र में डालें. YOUR_API_KEY को अपनी एपीआई कुंजी से बदलना न भूलें.
जवाब में, बताई गई जगह और तारीख के लिए टाइम ज़ोन का डेटा शामिल होता है
(timestamp).
डेवलपर गाइड देखें. इसमें आपको अनुरोध यूआरएल बनाने और उपलब्ध पैरामीटर के बारे में ज़्यादा जानकारी मिलेगी. साथ ही, रिस्पॉन्स को समझने में मदद मिलेगी.
यहां JSON में जवाब का एक उदाहरण दिया गया है:
JSON
{ "dstOffset": 0, "rawOffset": -28800, "status": "OK", "timeZoneId": "America/Los_Angeles", "timeZoneName": "Pacific Standard Time", }
XML
<TimeZoneResponse> <status>OK</status> <raw_offset>-28800.0000000</raw_offset> <dst_offset>0.0000000</dst_offset> <time_zone_id>America/Los_Angeles</time_zone_id> <time_zone_name>Pacific Standard Time</time_zone_name> </TimeZoneResponse>
हमारी क्लाइंट लाइब्रेरी की मदद से कोडिंग शुरू करना
क्लाइंट लाइब्रेरी, Google Maps Web Service API का इस्तेमाल करके डेवलपमेंट को आसान बनाती हैं. इसके लिए, वे सामान्य टास्क के आसान और नेटिव तरीके से लागू होने की सुविधा देती हैं. जैसे, पुष्टि करना, अनुरोध थ्रॉटलिंग, और अपने-आप फिर से कोशिश करना. Time Zone API, Google Maps Services के लिए Java Client, Python Client, Go Client, और Node.js Client में उपलब्ध है.
पुष्टि करना, कोटा, कीमत, और नीतियां
पुष्टि करना
Time Zone API का इस्तेमाल करने के लिए, आपको पहले एपीआई को चालू करना होगा. साथ ही, पुष्टि करने के लिए सही क्रेडेंशियल पाने होंगे. ज़्यादा जानकारी के लिए, Google Maps Platform का इस्तेमाल शुरू करना लेख पढ़ें.
कोटा और कीमत
Time Zone API के लिए सेट किए गए कोटे और कीमत के बारे में जानकारी पाने के लिए, इस्तेमाल और बिलिंग पेज देखें.
नीतियां
Time Zone API का इस्तेमाल, एपीआई की नीतियों के मुताबिक होना चाहिए.
ज़्यादा जानें
Time Zone API में, भाषा का पैरामीटर भी सेट किया जा सकता है. इससे अंग्रेज़ी के अलावा अन्य भाषाओं में नतीजे मिलते हैं. ज़्यादा उदाहरणों और अन्य जानकारी के लिए, Time Zone API की डेवलपर गाइड देखें.
Time Zone API की डेवलपर गाइड, वेबसाइट और मोबाइल डेवलपर के लिए है. इसमें उन डेवलपर को जानकारी दी गई है जो Google Maps Platform API में से किसी एक के ज़रिए उपलब्ध कराए गए मैप पर समय का डेटा शामिल करना चाहते हैं. इसमें एपीआई इस्तेमाल करने के बारे में बुनियादी जानकारी दी गई है. साथ ही, उपलब्ध पैरामीटर के बारे में रेफ़रंस मटीरियल दिया गया है.