Time Zone API'ye genel bakış

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

Time Zone API'yi neden kullanmalısınız?

Saat Dilimi API'si ile bir haritada belirli konumlardaki 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 saatinden saat dilimi farkları.

Saat dilimi verileri, web sitenizin veya uygulamanızın kullanıcılarınızla alakalı zamana dayalı veriler göstermesini istediğinizde özellikle yararlı olabilir.

Time Zone API ile neler yapabilirsiniz?

Time Zone API ile, dünya yüzeyindeki konumların saat dilimini, UTC'den saat farkı ve bu konumların her biri için yaz saati uygulamasıyla birlikte isteyebilirsiniz.

Time Zone API'nin işleyiş şekli

Saat Dilimi API'si, enlem/boylam koordinatları, istenen tarih ve saati bir zaman damgası olarak ve isteğe bağlı olarak bir dil kodu içeren bir HTTPS isteğini kabul eder. Verileri istekte belirtilen biçimde döndürür. Aşağıdaki örnekte, ABD'nin Nevada eyaletinde istenen bir isteğin JSON biçimindeki çıkışı gösterilmektedir.

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

Kaynaklar

Aşağıdaki tabloda, Time Zone API üzerinden kullanılabilen kaynaklar ve döndürdüğü veriler özetlenmektedir.

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

İsteğinizi konum ve zaman damgasıyla birlikte gönderirsiniz. Zorunlu parametrelere bakın.

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

Time Zone API'yi kullanma

1 Kurulum Google Cloud projenizi oluşturun bölümüne geçin ve sonraki kurulum talimatlarını tamamlayın.
2 Saat dilimi isteğini deneme API anahtarınız olduğunda, doğrudan tarayıcınızdan Saat Dilimi API'sini test etmeye başlayabilirsiniz. Ayrıntılar için Saat dilimi istekleri ve yanıtları kılavuzundaki Saat Dilimi örnekleri bölümüne göz atın.
3 Yanıtların temel özelliklerini 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. Farklı saat dilimlerine sahip kullanıcılar için uygulamaları ve web sitelerini iyileştirmek amacıyla saat dilimi verilerini kullanabilirsiniz.

Kullanılabilir istemci kitaplıkları

Aşağıdaki istemci kitaplıklarından biri aracılığıyla bu API'yi istediğiniz dilde çağırın:

Google Haritalar Hizmetleri için Java İstemcisi, Python İstemcisi, Go İstemcisi ve Node.js İstemcisi, Apache 2.0 Lisansı kapsamında açık kaynaklı olan, topluluk tarafından desteklenen istemci kitaplıklarıdır. Bunları GitHub'dan indirebilirsiniz. GitHub'da kurulum talimatlarını ve örnek kodu da bulabilirsiniz.

Sırada ne var?