शुरू करें

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

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

अनुरोध और जवाब का नमूना

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

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

यूआरएल

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

cURL

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

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

पुष्टि करना

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

कोटा और कीमत

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

नीतियां

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

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

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

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