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 ×tamp=1331161200 &key=YOUR_API_KEY
cURL
curl -L -X GET 'https://maps.googleapis.com/maps/api/timezone/json?location=39.6034810%2C-119.6822510×tamp=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.