Saat Dilimi API'si, dünya yüzeyindeki konumlar için saat farkı verileri sağlar. Belirli bir enlem/boylam çifti ve tarih için saat dilimi bilgilerini isteyin. API, söz konusu saat diliminin adını, UTC ile zaman farkını ve yaz saati farkını döndürür.
Örnek istek ve yanıt
URL dizesi olarak oluşturulan isteklerle, location'yi belirtmek için enlem/boylam koordinatlarını, tarihi belirtmek için timestamp'yi ve API anahtarınızı kullanarak HTTPS arayüzü üzerinden Time Zone API'ye erişin.
Aşağıdaki sorgu, ABD'nin Nevada eyaleti için saat dilimi isteğinde bulunur. 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=1733428634 &key=YOUR_API_KEY
curl
curl -L -X GET 'https://maps.googleapis.com/maps/api/timezone/json?location=39.6034810%2C-119.6822510×tamp=1733428634&key=YOUR_API_KEY'
Bu durumu, URL'yi web tarayıcınıza girerek test edebilirsiniz (YOUR_API_KEY kısmını gerçek API anahtarınızla değiştirdiğinizden emin olun).
Yanıt, belirtilen konum ve tarihin saat dilimi verilerini içerir
(timestamp).
Geliştirici kılavuzunu inceleyerek istek URL'leri oluşturma ve kullanılabilir parametreler ile yanıtı anlama hakkında daha fazla bilgi edinin.
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 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 almanız 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 için 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
Time Zone API'de, sonuçları varsayılan İngilizce dili dışında bir dilde 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.
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 uygulama geliştiricileri için hazırlanmıştır. API'nin kullanımı ve mevcut parametrelerle ilgili referans materyalleri hakkında bilgi verir.