समय क्षेत्र लुकअप

किसी बिंदु का समय क्षेत्र, और किसी दिए गए क्षण पर वहाँ लागू ऑफ़सेट।

GEThttps://api.mygeocode.com/v1/timezone

पैरामीटर

पैरामीटरप्रकारविवरण
latज़रूरी*number-90 से 90।
lonज़रूरीnumber-180 से 180।
locationsवैकल्पिकstring*lat और lon का विकल्प: lat,lon|lat,lon|... के रूप में अधिकतम 100 बिंदु। हर बिंदु एक अनुरोध के रूप में गिना जाता है; जवाब में इनपुट के क्रम में एक results array होता है।
tzवैकल्पिकstring*निर्देशांकों का विकल्प: Europe/Zurich जैसी IANA ज़ोन id (Windows id भी स्वीकार की जाती है)। सीमा लुकअप के बिना उस ज़ोन के लिए वही फ़ील्ड लौटाता है।
timestampवैकल्पिकintegerसेकंड में Unix समय। डिफ़ॉल्ट: अभी। 1900 से 2100 तक का कोई भी क्षण स्वीकार किया जाता है; भविष्य के ऑफ़सेट अभी प्रकाशित नियमों का उपयोग करते हैं।
languageवैकल्पिकstringname के लिए भाषा, जैसे de या pt-BR। डिफ़ॉल्ट अंग्रेज़ी।
keyवैकल्पिकstringAPI कुंजी, अगर हेडर के रूप में नहीं भेजी गई।

उदाहरण

$ curl -H "X-API-Key: YOUR_KEY" "https://api.mygeocode.com/v1/timezone?lat=-33.8688&lon=151.2093&timestamp=1767225600"
const url = new URL("https://api.mygeocode.com/v1/timezone");
url.searchParams.set("lat", -33.8688);
url.searchParams.set("lon", 151.2093);
url.searchParams.set("timestamp", 1767225600); // 2026-01-01T00:00:00Z

const tz = await (await fetch(url, { headers: { "X-API-Key": "YOUR_KEY" } })).json();
console.log(tz.timezone, tz.utc_offset, tz.dst);
import requests

tz = requests.get("https://api.mygeocode.com/v1/timezone",
                  params={"lat": -33.8688, "lon": 151.2093, "timestamp": 1767225600}, headers={"X-API-Key": "YOUR_KEY"}, timeout=5).json()
print(tz["timezone"], tz["utc_offset"], tz["dst"])
रिस्पॉन्स
{
  "status": "ok",
  "lat": -33.8688,
  "lon": 151.2093,
  "timezone": "Australia/Sydney",
  "abbreviation": "AEDT",
  "utc_offset": "+11:00",
  "utc_offset_seconds": 39600,
  "dst": true,
  "timestamp": 1767225600,
  "local_time": "2026-01-01T11:00:00+11:00",
  "country_code": "AU",
  "next_transition": { "timestamp": 1775316000, "utc_offset": "+10:00", "dst": false }
}

रिस्पॉन्स फ़ील्ड

फ़ील्डप्रकारविवरण
timezonestringIANA नाम। अंतरराष्ट्रीय जल में Etc/GMT+n या Etc/GMT-n (ध्यान दें कि चिह्न की परंपरा उल्टी है, जैसा IANA में है)।
abbreviationstringtimestamp पर संक्षिप्त नाम। केवल दिखाने के लिए; अनोखा नहीं।
namestringtimestamp पर लागू पूरा नाम, जैसे Australian Eastern Daylight Time।
utc_offsetstringtimestamp पर ±HH:MM
utc_offset_secondsintegerवही, संख्या के रूप में।
raw_offset_seconds, dst_offset_secondsintegerमानक ऑफ़सेट और उसके ऊपर डेलाइट सेविंग वाला हिस्सा (DST लागू न होने पर 0)। दोनों का योग utc_offset_seconds है।
dstbooleantimestamp पर डेलाइट सेविंग लागू है।
timestampintegerवर्णित क्षण।
local_timestringऑफ़सेट के साथ RFC 3339 स्थानीय समय।
country_codestring या nullISO 3166-1 alpha-2, समुद्र में null।
is_oceanbooleanअंतरराष्ट्रीय जल में इस्तेमाल होने वाले Etc/GMT ज़ोन के लिए true।
windows_timezonestring या nullCLDR से मेल खाती Windows समय क्षेत्र id, जैसे W. Europe Standard Time।
next_transitionobject या nulltimestamp के बाद अगला ऑफ़सेट बदलाव, अगर ज़ोन में कोई हो।

टिप्पणियाँ

यही लुकअप दूसरे प्रदाताओं के फ़ॉर्मैट में

अगर आपके पास इनमें से किसी प्रदाता के लिए पहले से लिखा कोड है, तो उसे रखें: ड्रॉप-इन होस्ट वही पाथ और पैरामीटर स्वीकार करता है और उस प्रदाता के रिस्पॉन्स ढाँचे में जवाब देता है, जिसके पीछे यही एंडपॉइंट होता है। ड्रॉप-इन कैसे काम करते हैं देखें।

प्रदाताहोस्टपाथ
Google Maps प्लैटफ़ॉर्मgapi.mygeocode.com/maps/api/timezone/json?location=lat,lng&timestamp=...&language=..
Bing Maps REST सेवाएँbing.mygeocode.com/REST/v1/TimeZone/{lat},{lon}?datetime=...
/REST/v1/TimeZone/?query=lat,lon
/REST/v1/TimeZone/List?timezoneStandard=iana|windows
/REST/v1/TimeZone/Convert?datetime=...&fromtz=...&desttz=...
LocationIQlocationiq.mygeocode.com/v1/timezone?lat=...&lon=...

एरर

400 invalid_request जब lat या lon गायब हो या सीमा से बाहर हो, tz कोई ज्ञात ज़ोन न हो, 100 से ज़्यादा बिंदु हों, या timestamp 1900 से 2100 के बाहर हो। 503 unavailable जब सीमा डेटा लोड न हुआ हो; कुछ भी गिना नहीं जाता।