Time Zone API'ye genel bakış

Time Zone API, enlem/boylam koordinatları ile istenen tarih ve saati içeren HTTP isteğini kabul eden bir hizmettir. UTC ve yaz saati uygulaması için ofsetler dahil olmak üzere konumun saat dilimi verilerini döndürür.

Time Zone API neden kullanılmalıdır?

Time Zone API ile haritadaki belirli konumlardaki tarihler 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'ndan harita konumları için yerelleştirilmiş saat dilimi adları.
  • Saat dilimi, UTC ile yaz saati uygulamasına göre değişir.

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

Time Zone API ile neler yapabilirsiniz?

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

Time Zone API'nin işleyiş şekli

Time Zone API, enlem/boylam koordinatlarından oluşan HTTPS isteğini, zaman damgası olarak istenen tarih ve saati ve isteğe bağlı olarak dil kodunu kabul eder. Verileri, istek tarafından belirtilen biçimde döndürür. Aşağıdaki örnekte, JSON biçiminde istenen bir çıkışla birlikte ABD'nin Nevada şehrine yönelik bir istek 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 aracılığıyla kullanılabilen kaynaklar, döndürdüğü verilerle birlikte özetlenmektedir.

Veri kaynakları Döndürülen veriler İade biçimi
Saat dilimi

İsteğinizi konum ve zaman damgasıyla birlikte belirtirsiniz. Gerekli parametrelere göz atın.

  • Saat dilimi kimliği.
  • İsteğe bağlı olarak yerelleştirilmiş saat dilimi adı
  • UTC saat diliminden saniye cinsinden uzaklık
  • YS için ofset (saniye cinsinden)
  • Belirli yanıt örnekleri için Saat Dilimi bölümünü inceleyin.
  • JSON
  • XML

Time Zone API'yi kullanma

1 Hazırlanın Google Cloud projenizi oluşturma işlemiyle başlayın ve aşağıdaki kurulum talimatlarını tamamlayın.
2 Saat dilimi isteği yapmayı deneyin API anahtarınızı oluşturduktan sonra Time Zone API'yi 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ı keşfedin. Ayrıntılar için Saat Dilimi yanıtları başlıklı makaleye göz atın.
5 Saat dilimi verilerini kendi uygulamanıza dahil edin! Saat dilimi verilerini, farklı zamana dayalı yerel ayarlardaki kullanıcılar için uygulamaları ve web sitelerini geliştirmek amacıyla kullanabilirsiniz.

Kullanılabilir istemci kitaplıkları

Aşağıdaki istemci kitaplıklarından birini kullanarak bu API'yi istediğiniz dilde çağırın:

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

Sırada ne var?