शुरू करें

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

सैंपल अनुरोध और जवाब

समय क्षेत्र एपीआई को एचटीटीपीएस इंटरफ़ेस के ज़रिए ऐक्सेस करें. इसमें यूआरएल स्ट्रिंग के रूप में अनुरोध किए गए अनुरोध, location/तारीख बताने और तारीख बताने के लिए timestamp, और अपने एपीआई कुंजी को तय करने के लिए, अक्षांश/देशांतर निर्देशांकों का इस्तेमाल करें.

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

यूआरएल

https://maps.googleapis.com/maps/api/timezone/json
  ?location=39.6034810%2C-119.6822510
  &timestamp=1331161200
  &key=YOUR_API_KEY

यूआरएल

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

JavaScript

var axios = require('axios');

var config = {
  method: 'get',
  url: 'https://maps.googleapis.com/maps/api/timezone/json?location=39.6034810%2C-119.6822510&timestamp=1331161200&key=YOUR_API_KEY',
  headers: { }
};

axios(config)
.then(function (response) {
  console.log(JSON.stringify(response.data));
})
.catch(function (error) {
  console.log(error);
});

Python

import requests

url = "https://maps.googleapis.com/maps/api/timezone/json?location=39.6034810%2C-119.6822510&timestamp=1331161200&key=YOUR_API_KEY"

payload={}
headers = {}

response = requests.request("GET", url, headers=headers, data=payload)

print(response.text)

Java

OkHttpClient client = new OkHttpClient().newBuilder()
  .build();
MediaType mediaType = MediaType.parse("text/plain");
RequestBody body = RequestBody.create(mediaType, "");
Request request = new Request.Builder()
  .url("https://maps.googleapis.com/maps/api/timezone/json?location=39.6034810%2C-119.6822510&timestamp=1331161200&key=YOUR_API_KEY")
  .method("GET", body)
  .build();
Response response = client.newCall(request).execute();

Ruby

require "uri"
require "net/http"

url = URI("https://maps.googleapis.com/maps/api/timezone/json?location=39.6034810%2C-119.6822510&timestamp=1331161200&key=YOUR_API_KEY")

https = Net::HTTP.new(url.host, url.port)
https.use_ssl = true

request = Net::HTTP::Get.new(url)

response = https.request(request)
puts response.read_body

शुरू करें

package main

import (
  "fmt"
  "net/http"
  "io/ioutil"
)

func main() {

  url := "https://maps.googleapis.com/maps/api/timezone/json?location=39.6034810,-119.6822510&timestamp=1331161200&key=YOUR_API_KEY"
  method := "GET"

  client := &http.Client {
  }
  req, err := http.NewRequest(method, url, nil)

  if err != nil {
    fmt.Println(err)
    return
  }
  res, err := client.Do(req)
  if err != nil {
    fmt.Println(err)
    return
  }
  defer res.Body.Close()

  body, err := ioutil.ReadAll(res.Body)
  if err != nil {
    fmt.Println(err)
    return
  }
  fmt.Println(string(body))
}

पोस्टमैन

OpenAPI की खास बातें पोस्टमैन संग्रह के रूप में भी उपलब्ध हैं.

पोस्टमैन में दौड़ें

अपने वेब ब्राउज़र में यूआरएल डालकर, आप इसकी जांच कर सकते हैं. YOUR_API_KEY को अपनी असल एपीआई कुंजी से बदलना न भूलें. इस जवाब में, बताई गई जगह और तारीख (timestamp) के लिए समय क्षेत्र का डेटा शामिल होता है.

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

JSON में जवाब का एक उदाहरण नीचे दिया गया है:

JSON

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

हमारी क्लाइंट लाइब्रेरी की मदद से कोडिंग शुरू करें

क्लाइंट लाइब्रेरी, 'Google मैप' वेब सेवा एपीआई का इस्तेमाल करके आसानी से काम कर सकती हैं. इसके लिए, वे पुष्टि करने, अनुरोध थ्रॉटलिंग, और अपने-आप फिर से कोशिश करने जैसे सामान्य सामान्य काम करना आसान बनाती हैं. समय क्षेत्र एपीआई, Java Client, Python क्लाइंट, Go Client, और Google Maps सेवाओं के लिए Node.js क्लाइंट में उपलब्ध है.

प्रमाणीकरण, कोटा, मूल्य-निर्धारण और नीतियां

पुष्टि करें

समय क्षेत्र एपीआई का इस्तेमाल करने के लिए, आपको पहले एपीआई चालू करना होगा और सही पुष्टि क्रेडेंशियल पाने होंगे. ज़्यादा जानकारी के लिए, Google Maps Platform का इस्तेमाल शुरू करना देखें.

कोटा और कीमत

समय क्षेत्र एपीआई के कोटा और कीमत सेट करने से जुड़ी जानकारी के लिए इस्तेमाल और बिलिंग पेज देखें.

नीतियां

समय क्षेत्र एपीआई का इस्तेमाल एपीआई की नीतियों के मुताबिक होना चाहिए.

ज़्यादा जानें

समय क्षेत्र एपीआई में, डिफ़ॉल्ट रूप से अंग्रेज़ी के अलावा दूसरी भाषाओं में भी नतीजे पाने के लिए, भाषा पैरामीटर सेट किया जा सकता है. ज़्यादा उदाहरण और दूसरी जानकारी के लिए, टाइम ज़ोन एपीआई डेवलपर गाइड देखें.

समय क्षेत्र एपीआई डेवलपर गाइड, उन वेबसाइट और मोबाइल डेवलपर के लिए है जो Google Maps Platform के एपीआई में से, किसी एक मैप पर दिए गए समय डेटा को शामिल करना चाहते हैं. इसमें, उपलब्ध पैरामीटर के बारे में बताया गया है कि एपीआई और रेफ़रंस का इस्तेमाल कैसे किया जाता है.