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

समय क्षेत्र

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

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

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

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

• json (सुझाया गया), इससे आउटपुट JavaScript Object 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%2C-119.6822510
  ×tamp=1733428634
  &key=YOUR_API_KEY

curl -L -X GET 'https://maps.googleapis.com/maps/api/timezone/json?location=39.6034810%2C-119.6822510×tamp=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%2C-119.6822510
  ×tamp=1710547034
  &key=YOUR_API_KEY

curl -L -X GET 'https://maps.googleapis.com/maps/api/timezone/json?location=39.6034810%2C-119.6822510×tamp=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%2C-119.6822510
  ×tamp=1710547034
  &key=YOUR_API_KEY

curl -L -X GET 'https://maps.googleapis.com/maps/api/timezone/json?location=39.6034810%2C-119.6822510×tamp=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 फ़ील्ड के योग के बराबर होता है.