Başla

Time Zone API, dünya yüzeyindeki konumlar için zaman farkı verileri sağlar. Belirli bir enlem/boylam çifti ve tarih için saat dilimi bilgilerini isteyin. API; bu saat diliminin adını, UTC ile saat farkını ve yaz saati farkını döndürür.

Örnek istek ve yanıt

Time Zone API'ye HTTPS arayüzü üzerinden erişin. İstekler location belirtmek için enlem/boylam koordinatları, tarihi belirtmek için timestamp ve API anahtarınızı kullanarak URL dizesi şeklinde yapılandırılmıştır.

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

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'

URL'yi web tarayıcınıza girerek bunu test edebilirsiniz (YOUR_API_KEY değerini gerçek API anahtarınızla değiştirmeyi unutmayın). Yanıt, belirtilen konum ve tarihe ((timestamp)) ait saat dilimi verilerini içerir.

İsteğe bağlı URL'ler ve mevcut parametreler oluşturma ve yanıtı anlama hakkında daha fazla bilgi için geliştirici kılavuzunu inceleyin.

Aşağıda JSON biçiminde bir örnek 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ı, kimlik doğrulama, istek sınırlama ve otomatik yeniden deneme gibi yaygın görevlerin basit ve yerel uygulamalarını sağlayarak Google Haritalar web hizmeti API'leriyle geliştirme sürecini kolaylaştırır. Time Zone API; Java İstemcisi, Python İstemcisi, Go İstemcisi ve Google Haritalar Hizmetleri için Node.js İstemcisi'nde kullanılabilir.

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

Kimlik doğrulama

Time Zone API'yi kullanmak için önce API'yi etkinleştirmeniz ve uygun kimlik doğrulama kimlik bilgilerini almanız gerekir. Daha fazla bilgi için Google Haritalar Platformu'nu Kullanmaya Başlama başlıklı makaleyi inceleyin.

Kotalar ve fiyatlandırma

Time Zone API için belirlenen kotalar ve fiyatlandırma hakkında ayrıntılı bilgi edinmek için kullanım ve faturalandırma sayfasını inceleyin.

Politikalar

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

Daha fazla bilgi

Time Zone API'de, varsayılan İngilizce dışındaki dillerde sonuç 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 bakı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 uygulama geliştiricileri için hazırlanmıştır. Kılavuz, API'nin ve mevcut parametrelerle ilgili referans materyallerin kullanımına giriş niteliğindedir.