समय क्षेत्र के लिए अनुरोध और उनके जवाब

समय क्षेत्र

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

टाइम ज़ोन का अनुरोध इस तरह का होता है:

https://maps.googleapis.com/maps/api/timezone/outputFormat?parameters

जहां outputFormat इनमें से कोई भी वैल्यू हो सकती है:

• json (सुझाया गया), JavaScript ऑब्जेक्ट Notation (JSON) में आउटपुट दिखाता है; या
• xml, इससे पता चलता है कि आउटपुट एक्सएमएल में है और <TimeZoneResponse> नोड में रैप किया गया है.

ध्यान दें: यूआरएल को मान्य बनाने के लिए, उन्हें सही तरीके से एन्कोड किया जाना चाहिए. साथ ही, सभी वेब सेवाओं के लिए, यूआरएल में ज़्यादा से ज़्यादा 16,384 वर्ण हो सकते हैं. यूआरएल बनाते समय इस सीमा का ध्यान रखें. ध्यान दें कि अलग-अलग ब्राउज़र, प्रॉक्सी, और सर्वर के लिए, यूआरएल में वर्ण सीमाएं भी अलग-अलग हो सकती हैं.

ज़रूरी पैरामीटर

जगह

कॉमा लगाकर अलग किया गया अक्षांश,देशांतर ट्यूपल, location=39.6034810,-119.6822510, जो उस जगह को दिखाता है जिसकी जानकारी देखनी है.

timestamp

यह समय, 1 जनवरी, 1970 यूटीसी की आधी रात के बाद से सेकंड में होता है. Time Zone API, timestamp का इस्तेमाल करके यह तय करता है कि डेलाइट सेविंग लागू होनी चाहिए या नहीं. यह location के टाइम ज़ोन के आधार पर तय होता है.

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

ज़रूरी नहीं पैरामीटर

भाषा

वह भाषा जिसमें नतीजे दिखाए जाएंगे.

• उपलब्ध भाषाओं की सूची देखें. Google अक्सर उन भाषाओं को अपडेट करता रहता है जिनमें यह सुविधा उपलब्ध है. इसलिए, हो सकता है कि इस सूची में सभी भाषाएं शामिल न हों.
• अगर language नहीं दिया गया है, तो एपीआई, Accept-Language हेडर में बताई गई पसंदीदा भाषा का इस्तेमाल करने की कोशिश करता है.
• एपीआई, मोहल्ले का ऐसा पता देने की पूरी कोशिश करता है जिसे उपयोगकर्ता और स्थानीय लोग, दोनों पढ़ सकें. इस लक्ष्य को हासिल करने के लिए, यह स्थानीय भाषा में मोहल्ले के पते दिखाता है. अगर ज़रूरी हो, तो उपयोगकर्ता की पसंदीदा भाषा को ध्यान में रखते हुए, उसे ऐसी लिपि में ट्रांसलिट्रेट किया जाता है जिसे उपयोगकर्ता पढ़ सके. अन्य सभी पते, आपकी पसंदीदा भाषा में दिखाए जाते हैं. पते के सभी कॉम्पोनेंट उसी भाषा में दिखाए जाते हैं जो पहले कॉम्पोनेंट के लिए चुनी गई है.
• अगर पसंदीदा भाषा में कोई नाम उपलब्ध नहीं है, तो एपीआई सबसे मिलते-जुलते नाम का इस्तेमाल करता है.
• पसंदीदा भाषा का असर, एपीआई से मिलने वाले नतीजों के सेट और उनके क्रम पर थोड़ा पड़ता है. जियोकोडर, भाषा के हिसाब से शॉर्ट फ़ॉर्म को अलग-अलग तरीके से समझता है. जैसे, सड़क के टाइप के लिए शॉर्ट फ़ॉर्म या समानार्थी शब्द, जो एक भाषा में मान्य हो सकते हैं, लेकिन दूसरी भाषा में नहीं. उदाहरण के लिए, हंगेरियन भाषा में utca और tér, स्ट्रीट के समानार्थी शब्द हैं.

टाइम ज़ोन के उदाहरण

इस सेक्शन में कुछ सैंपल क्वेरी शामिल हैं, जो एपीआई की सुविधाओं के बारे में बताती हैं.

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

URL

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

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/timezone/json?location=39.6034810,-119.6822510&timestamp=1733428634&key=YOUR_API_KEY'

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>
      

नीचे दी गई क्वेरी, अमेरिका के नेवाडा के लिए टाइम ज़ोन का अनुरोध करती है. जगह की जानकारी, ऊपर दिए गए अनुरोध के जैसी ही है. हालांकि, टाइमस्टैंप 15 मार्च, 2024 पर सेट है. जवाब में अब डेलाइट सेविंग टाइम ऑफ़सेट शामिल है.

URL

https://maps.googleapis.com/maps/api/timezone/json?location=39.6034810,-119.6822510&timestamp=1710547034&key=YOUR_API_KEY

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/timezone/json?location=39.6034810,-119.6822510&timestamp=1710547034&key=YOUR_API_KEY'

JSON

{
  "dstOffset": 3600,
  "rawOffset": -28800,
  "status": "OK",
  "timeZoneId": "America/Los_Angeles",
  "timeZoneName": "Pacific Daylight Time",
}
        

XML

<TimeZoneResponse>
 <status>OK</status>
 <raw_offset>-28800.0000000</raw_offset>
 <dst_offset>3600.0000000</dst_offset>
 <time_zone_id>America/Los_Angeles</time_zone_id>
 <time_zone_name>Pacific Daylight Time</time_zone_name>
</TimeZoneResponse>

यह उदाहरण ऊपर दिए गए दो उदाहरणों से मिलता-जुलता है. हालांकि, इसमें भाषा पैरामीटर सेट किया गया है. अब जवाब स्पैनिश में दिया जाएगा.

URL

https://maps.googleapis.com/maps/api/timezone/json?language=es&location=39.6034810,-119.6822510&timestamp=1710547034&key=YOUR_API_KEY

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/timezone/json?location=39.6034810,-119.6822510&timestamp=1710547034&language=es&key=YOUR_API_KEY'

JSON

{
  "dstOffset": 3600,
  "rawOffset": -28800,
  "status": "OK",
  "timeZoneId": "America/Los_Angeles",
  "timeZoneName": "hora de verano del Pacífico",
}
      

XML

<TimeZoneResponse>
 <status>OK</status>
 <raw_offset>-28800.0000000</raw_offset>
 <dst_offset>3600.0000000</dst_offset>
 <time_zone_id>America/Los_Angeles</time_zone_id>
 <time_zone_name>hora de verano del Pacífico</time_zone_name>
</TimeZoneResponse>
      

टाइम ज़ोन के हिसाब से जवाब

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

TimeZoneResponse

फ़ील्ड	ज़रूरी है	टाइप	ब्यौरा
status	ज़रूरी है	TimeZoneStatus	ज़्यादा जानकारी के लिए, TimeZoneStatus देखें.
dstOffset	ज़रूरी नहीं	संख्या	डेलाइट सेविंग टाइम के लिए ऑफ़सेट, सेकंड में. अगर तय किए गए timestamp के दौरान, टाइम ज़ोन डेलाइट सेविंग टाइम में नहीं है, तो यह शून्य होगा.
errorMessage	ज़रूरी नहीं	स्ट्रिंग	दिए गए स्टेटस कोड की वजहों के बारे में ज़्यादा जानकारी. अगर स्टेटस Ok के अलावा कुछ और है, तो इसे शामिल किया जाता है.
rawOffset	ज़रूरी नहीं	संख्या	दी गई जगह के लिए, यूटीसी से ऑफ़सेट (सेकंड में). इसमें डेलाइट सेविंग टाइम को ध्यान में नहीं रखा जाता.
timeZoneId	ज़रूरी नहीं	स्ट्रिंग	टाइम ज़ोन का आईडी शामिल करने वाली स्ट्रिंग, जैसे कि "America/Los_Angeles" या "Australia/Sydney". इन आईडी को यूनिकोड कॉमन लोकेल डेटा रिपॉज़िटरी (सीएलडीआर) प्रोजेक्ट ने तय किया है. फ़िलहाल, ये timezone.xml फ़ाइल में उपलब्ध हैं. जब किसी टाइमज़ोन के कई आईडी होते हैं, तो कैननिकल आईडी दिखाया जाता है. एक्सएमएल रिस्पॉन्स में, यह हर टाइमज़ोन का पहला उपनाम होता है. उदाहरण के लिए, "Asia/Kolkata" के बजाय "Asia/Calcutta" दिखाया जाता है.
timeZoneName	ज़रूरी नहीं	स्ट्रिंग	टाइम ज़ोन का पूरा नाम. अगर भाषा पैरामीटर सेट है, तो इस फ़ील्ड को स्थानीय भाषा में दिखाया जाएगा. उदाहरण के लिए, Pacific Daylight Time या Australian Eastern Daylight Time.

TimeZoneStatus

टाइम ज़ोन के रिस्पॉन्स ऑब्जेक्ट में मौजूद status फ़ील्ड में, अनुरोध की स्थिति की जानकारी होती है. status फ़ील्ड में ये वैल्यू हो सकती हैं:

• OK से पता चलता है कि अनुरोध स्वीकार कर लिया गया है.

• INVALID_REQUEST से पता चलता है कि अनुरोध गलत था.

• OVER_DAILY_LIMIT का मतलब इनमें से कोई एक है:

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

• OVER_QUERY_LIMIT से पता चलता है कि अनुरोध करने वाले व्यक्ति ने कोटा पार कर लिया है.

• REQUEST_DENIED से पता चलता है कि एपीआई ने अनुरोध पूरा नहीं किया. पुष्टि करें कि अनुरोध, एचटीटीपी के बजाय एचटीटीपीएस पर भेजा गया हो.

• UNKNOWN_ERROR से पता चलता है कि कोई ऐसी गड़बड़ी हुई है जिसकी जानकारी नहीं है.

• ZERO_RESULTS से पता चलता है कि बताई गई जगह या समय के लिए, टाइम ज़ोन का कोई डेटा नहीं मिला. पुष्टि करें कि अनुरोध, ज़मीन पर मौजूद किसी जगह के लिए किया गया है, न कि पानी के ऊपर मौजूद किसी जगह के लिए.

स्थानीय समय का हिसाब लगाना

किसी जगह का स्थानीय समय, timestamp पैरामीटर और नतीजे में मौजूद dstOffset और rawOffset फ़ील्ड का योग होता है.