Başlayın

Saat Dilimi API'si, dünya yüzeyindeki konumlar için saat farkı verilerini sağlar. Belirli bir enlem/boylam çifti ve tarih için saat dilimi bilgilerini isteyin. API, ilgili saat diliminin adını, UTC ile saat farkını ve yaz saati farkını döndürür.

Örnek istek ve yanıt

location değerini belirtmek için enlem/boylam koordinatlarını, tarihi belirtmek için bir timestamp değerini ve API anahtarınızı kullanarak URL dizesi olarak oluşturulan istekler içeren bir HTTPS arayüzü üzerinden Saat Dilimi API'sine erişin.

Aşağıdaki sorgu, ABD Nevada 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=1733428634
  &key=YOUR_API_KEY

cURL

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

URL'yi web tarayıcınıza girerek bunu test edebilirsiniz (YOUR_API_KEY yerine gerçek API anahtarınızı girdiğinizden emin olun). Yanıt, belirtilen konum ve tarihe ait saat dilimi verilerini içerir (timestamp).

İstek URL'leri ve mevcut parametreleri 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şlama

İstemci kitaplıkları; kimlik doğrulama, istek sınırlama ve otomatik yeniden deneme gibi yaygın görevlerin basit, yerel uygulamalarını sunarak Google Haritalar web hizmeti API'leriyle geliştirme yapmayı kolaylaştırır. Saat Dilimi API'si, Google Haritalar Hizmetleri için Java İstemcisi, Python İstemcisi, Go İstemcisi ve Node.js İstemcisi'nde kullanılabilir.

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

Kimlik doğrulama

Saat Dilimi API'sini kullanmak için önce API'yi etkinleştirmeniz ve uygun kimlik doğrulama kimlik bilgilerini edinmeniz gerekir. Daha fazla bilgi için Google Haritalar Platformu'nu kullanmaya başlama başlıklı makaleyi inceleyin.

Kotalar ve fiyatlandırma

Saat Dilimi API'si için belirlenen kotalar ve fiyatlandırma hakkında ayrıntılı bilgi edinmek üzere kullanım ve faturalandırma sayfasını inceleyin.

Politikalar

Saat Dilimi API'sinin kullanımı API politikalarına uygun olmalıdır.

Daha fazla bilgi

Saat Dilimi API'sinde, 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 Saat Dilimi API'si Geliştirici Kılavuzu'na bakın.

Saat Dilimi API'si Geliştirici Kılavuzu, Google Haritalar Platformu API'lerinden biri tarafından sağlanan haritalara saat verileri eklemek isteyen web sitesi ve mobil geliştiriciler için hazırlanmıştır. API'nin kullanımıyla ilgili bir giriş ve mevcut parametrelerle ilgili referans materyali sunar.