Time Zone API'ye genel bakış

Saat Dilimi API'si, enlem/boylam koordinatları ile seçilen tarih ve saatten oluşan bir HTTP isteğini kabul eden bir hizmettir. UTC ve yaz saati farkları dahil olmak üzere konumun saat dilimi verilerini döndürür.

Saat Dilimi API'sini neden kullanmalısınız?

Time Zone API ile, haritadaki belirli konumlarda tarih ve saatler için saat dilimi kimliğini ve adını sağlayan uygulamalar geliştirebilirsiniz. Örneğin, aşağıdaki saat dilimi verilerini gösterebilirsiniz:

  • Google Haritalar Platformu'ndaki harita konumları için yerelleştirilmiş saat dilimi adları.
  • UTC'den ve yaz saati uygulamasından kaynaklanan saat dilimi farkları.

Saat dilimi verileri, özellikle web sitenizin veya uygulamanızın, uygulamanızı kullanan kişilerle alakalı zamana dayalı verileri göstermesini istediğinizde faydalıdır.

Time Zone API ile yapabilecekleriniz

Time Zone API ile, dünya üzerindeki konumların saat dilimini, her bir konumun UTC'den saat farkını ve yaz saati uygulamasını isteyebilirsiniz.

Saat Dilimi API'sinin işleyiş şekli

Time Zone API; enlem ve boylam koordinatları, zaman damgası olarak seçilen tarih ve saat ile isteğe bağlı olarak bir dil kodu içeren HTTPS isteğini kabul eder. Verileri, istekte belirtilen biçimde döndürür. Aşağıdaki örnekte, ABD'nin Nevada eyaleti için JSON biçiminde çıkış istenen bir istek gösterilmektedir:

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

Kaynaklar

Aşağıdaki tabloda, Time Zone API aracılığıyla kullanılabilen kaynaklar ve döndürdüğü veriler özetlenmiştir:

Veri kaynakları Döndürülen veriler Dönüş biçimi
Saat dilimi

İsteğinizi konum ve zaman damgasıyla birlikte gönderirsiniz. Gerekli parametreleri inceleyin.

  • Saat dilimi kimliği.
  • Saat dilimi adı (isteğe bağlı olarak yerelleştirilmiş).
  • UTC'den saniye cinsinden fark.
  • Yaz saati uygulaması için saniye cinsinden fark.
  • Belirli yanıt örnekleri için Saat Dilimi bölümüne bakın.
  • JSON
  • XML

Saat Dilimi API'sini kullanma

1 Kurulumu tamamlama Google Cloud projenizi ayarlama ile başlayın ve sonraki kurulum talimatlarını tamamlayın.
2 Saat dilimi isteği göndermeyi deneme API anahtarınız olduğunda Saat Dilimi API'sini doğrudan tarayıcınızdan test etmeye başlayabilirsiniz. Ayrıntılar için Saat dilimi istekleri ve yanıtları kılavuzundaki Saat dilimi örnekleri bölümüne bakın.
3 Yanıtlarla ilgili temel bilgileri anlama Uygulamanızda veya web sitenizde saat dilimi verilerini nasıl kullanacağınızı öğrenin. Ayrıntılar için Saat Dilimi yanıtları bölümüne bakın.
5 Saat dilimi verilerini kendi uygulamanıza ekleyin. Saat dilimi verilerini kullanarak uygulamaları ve web sitelerini farklı saat dilimlerine göre iyileştirebilirsiniz.

Kullanılabilir istemci kitaplıkları

Bu API'yi, aşağıdaki istemci kitaplıklarından biri aracılığıyla istediğiniz dilde çağırabilirsiniz:

Google Haritalar Hizmetleri için Java İstemci Kitaplığı, Python İstemci Kitaplığı, Go İstemci Kitaplığı ve Node.js İstemci Kitaplığı, Apache 2.0 Lisansı kapsamında açık kaynaklı olan, topluluk destekli istemci kitaplıklarıdır. Bu kitaplıkları GitHub'dan indirebilirsiniz. Ayrıca GitHub'da yükleme talimatlarını ve örnek kodları da bulabilirsiniz.

Sırada ne var?