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

समय क्षेत्र

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

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

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 पर सेट किया गया है.

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

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

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

<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 पर सेट किया गया है. जवाब में अब डेलाइट सेविंग टाइम का ऑफ़सेट भी शामिल किया गया है.

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

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

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

<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>

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

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

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'

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

<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

TimeZoneStatus

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

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

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

• OVER_DAILY_LIMIT इनमें से किसी भी चीज़ को दिखाता है:

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

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

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

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

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

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

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