Başla

Time Zone API, yeryüzündeki konumlar için zaman farkı verileri sağlar. Belirli bir enlem/boylam çifti ve tarih için saat dilimi bilgisi isteyin. API bu saat diliminin adını, UTC saat farkını ve yaz saati farkını döndürür.

Örnek istek ve yanıt

Saat Dilimi API'sine HTTPS arayüzü üzerinden erişin. URL dizesi şeklinde oluşturulan isteklerde, location belirten enlem/boylam koordinatları, tarihi belirtmek için bir timestamp ve API anahtarınız kullanılır.

Aşağıdaki sorgu, ABD, Nevada için bir saat dilimi isteği gerçekleştirir. Zaman damgası 8 Mart 2012 olarak ayarlandı.

URL

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

CURL

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

Go

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

Poster

OpenAPI spesifikasyonu, bir Postman koleksiyonu olarak da mevcuttur.

Postman'da çalıştır

Bunu web tarayıcınıza URL'yi girerek test edebilirsiniz (YOUR_API_KEY yerine gerçek API anahtarınızı girdiğinizden emin olun). Yanıtta, belirtilen konum ve tarih (timestamp) için saat dilimi verileri bulunur.

İstek URL'leri ve kullanılabilir parametreler oluşturma ve yanıtı anlama hakkında daha fazla bilgi için geliştirici kılavuzuna bakın.

Aşağıda, JSON'daki örnek bir yanıt verilmiştir:

JSON

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

XML

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

İstemci kitaplıklarımızla kodlamaya başlayın

İstemci kitaplıkları sayesinde kimlik doğrulama, istek kısıtlama ve otomatik olarak yeniden deneme gibi genel görevlerin basit ve yerel uygulamalarını Google Haritalar web hizmeti API'leriyle daha kolay bir şekilde geliştirebilirsiniz. Time Zone API, Google Haritalar Hizmetleri için Java İstemcisi, Python İstemcisi, Go İstemcisi ve Node.js İstemcisi dillerinde kullanılabilir.

Kimlik doğrulama, kota, fiyatlandırma ve politikalar

Kimlik doğrulama

Time Zone API'yi kullanmak için önce API'yi etkinleştirip uygun kimlik doğrulama bilgilerini almanız gerekir. Daha fazla bilgi için Google Haritalar Platformu'nu Kullanmaya Başlama bölümüne bakın.

Kotalar ve fiyatlandırma

Time Zone API için belirlenen kota ve fiyatlandırma ile ilgili ayrıntılar için kullanım ve faturalandırma sayfasına göz atın.

Politikalar

Time Zone API kullanımı, API politikalarına uygun olmalıdır.

Daha fazla bilgi

Time Zone API'de ayrıca varsayılan dil olan İngilizce dışındaki dillerdeki sonuçları döndürmek için bir dil parametresi de ayarlayabilirsiniz. Daha fazla örnek ve diğer ayrıntılar için Time Zone API Geliştirici Kılavuzu'na göz atın.

Time Zone API Geliştirici Kılavuzu, Google Haritalar Platformu API'lerinden biri tarafından sağlanan haritalara zaman verileri eklemek isteyen web sitesi ve mobil geliştiriciler için hazırlanmıştır. Mevcut parametrelerde API ve referans materyalin kullanımına dair bir giriş sunar.