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

समय क्षेत्र

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

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

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 फ़ील्ड के जोड़ के बराबर होता है.