शुरू करें

शुरू करने से पहले: Time Zone API का इस्तेमाल शुरू करने से पहले, आपके पास एक ऐसा प्रोजेक्ट होना चाहिए जिसमें बिलिंग खाता और Time Zone API चालू हो. हमारा सुझाव है कि आप एक से ज़्यादा प्रोजेक्ट के मालिक और बिलिंग एडमिन बनाएं, ताकि आपकी टीम के पास इन भूमिकाओं के लिए हमेशा कोई व्यक्ति उपलब्ध रहे. ज़्यादा जानने के लिए, Cloud कंसोल में सेट अप करना लेख पढ़ें.

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

अनुरोध और रिस्पॉन्स का सैंपल

HTTPS इंटरफ़ेस की मदद से टाइम ज़ोन एपीआई को ऐक्सेस करें. इसके लिए, यूआरएल स्ट्रिंग के तौर पर बनाए गए अनुरोधों का इस्तेमाल करें. इनमें location की जानकारी देने के लिए, अक्षांश/देशांतर निर्देशांक और तारीख की जानकारी देने के लिए timestamp का इस्तेमाल करें. साथ ही, अपनी एपीआई कुंजी भी दें.

यहां दी गई क्वेरी, अमेरिका के नेवादा के लिए टाइम ज़ोन का अनुरोध करती है. टाइमस्टैंप को 8 मार्च, 2012 पर सेट किया गया है.

URL

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

cURL

curl -L -X GET 'https://maps.googleapis.com/maps/api/timezone/json?location=39.6034810%2C-119.6822510&timestamp=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 वेब सेवा एपीआई के साथ डेवलप करना आसान बनाती हैं. ऐसा, पुष्टि करने, अनुरोध को कम करने, और अपने-आप फिर से कोशिश करने जैसे सामान्य टास्क को आसान और नेटिव तरीके से लागू करके किया जाता है. टाइम ज़ोन एपीआई, Google Maps Services के लिए Java क्लाइंट, Python क्लाइंट, Go क्लाइंट, और Node.js क्लाइंट में उपलब्ध है.

पुष्टि करने, कोटा तय करने, कीमत तय करने, और नीतियों के बारे में जानकारी

पुष्टि करना

टाइम ज़ोन एपीआई का इस्तेमाल करने के लिए, आपको सबसे पहले एपीआई को चालू करना होगा और पुष्टि करने के लिए सही क्रेडेंशियल पाना होगा. ज़्यादा जानकारी के लिए, Google Maps Platform का इस्तेमाल शुरू करना लेख पढ़ें.

कोटा और कीमत

टाइम ज़ोन एपीआई के लिए तय किए गए कोटे और कीमत की जानकारी के लिए, इस्तेमाल और बिलिंग पेज पर जाएं.

नीतियां

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

ज़्यादा जानें

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

Time Zone API डेवलपर गाइड, वेबसाइट और मोबाइल के उन डेवलपर के लिए है जिन्हें Google Maps Platform के किसी एपीआई से मिले मैप पर, समय का डेटा शामिल करना है. इसमें, एपीआई के इस्तेमाल के बारे में जानकारी दी गई है. साथ ही, उपलब्ध पैरामीटर के बारे में रेफ़रंस दिया गया है.