Time Zone API, dünya yüzeyindeki konumlar için saat farkı verileri sağlar. Belirli bir enlem ve boylam çifti ile tarih için saat dilimi bilgilerini isteme API, ilgili saat diliminin adını, UTC'ye göre 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. İstekler, location değerini belirtmek için enlem ve boylam koordinatlarını, tarihi belirtmek için timestamp değerini ve API anahtarınızı kullanan bir URL dizesi olarak oluşturulur.
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=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'
URL'yi web tarayıcınıza girerek bu isteği 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 tarih (timestamp) için saat dilimi verilerini içerir.
İstek URL'leri oluşturma ve kullanılabilir parametreler ile yanıtı anlama hakkında daha fazla bilgi için geliştirici kılavuzuna bakın.
Aşağıdaki örnekte JSON biçiminde bir yanıt gösterilmektedir:
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ıyla kodlamaya başlama
İstemci kitaplıkları; kimlik doğrulama, istek kısıtlama ve otomatik yeniden deneme gibi yaygın görevlerin basit, yerleşik uygulamalarını sağlayarak Google Haritalar web hizmeti API'leriyle geliştirme yapmayı kolaylaştırır. Time Zone API, 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
Time Zone API'yi kullanmak için önce API'yi etkinleştirmeniz ve uygun kimlik doğrulama bilgilerini edinmeniz 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 için Kullanım ve faturalandırma bölümünü inceleyin.
Politikalar
Saat Dilimi API'sinin kullanımı API politikalarına uygun olmalıdır.
Daha fazla bilgi
Saat Dilimi API'de, sonuçları varsayılan İngilizce dışında dillerde döndürmek için bir dil parametresi de ayarlayabilirsiniz. Daha fazla örnek ve diğer ayrıntılar için Saat Dilimi API Geliştirici Kılavuzu'na bakın.
Time Zone API Geliştirici Kılavuzu, web sitesi ve mobil geliştiricilerin Google Haritalar Platformu API'lerinden biri tarafından sağlanan haritalara saat verilerini eklemesine yardımcı olur. API'nin kullanımına giriş niteliğinde bilgiler ve mevcut parametrelerle ilgili referans materyaller sunar.