Time Zone API'ye genel bakış

Time Zone API, aşağıdaki koşulları karşılayan HTTP isteğini kabul eden bir hizmettir: enlem/boylam koordinatları ve seçilen tarih ve saat. UTC ve yaz saati farkları dahil olmak üzere konumun saat dilimi verilerini döndürür.

Time Zone API'yi kullanma

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ğıdakileri gösterebilirsiniz: saat dilimi verileri:

  • 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

Time Zone API, enlem/boylam HTTPS isteğini kabul eder koordinatlar, zaman damgası olarak istenen tarih ve saat ve isteğe bağlı olarak dil kodu kullanabilirsiniz. Verileri istek tarafından belirtilen biçimde döndürür. Aşağıdaki örnekte Nevada, ABD, istenen çıkış JSON biçimindedir.

 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 ve döndürdüğü verilerle birlikte.

Veri kaynakları Döndürülen veriler İade 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 Ayarlarınızı Google Cloud projesi ve kurulumu tamamlayın lütfen unutmayı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 bakın.
3 Yanıtlarla ilgili temel bilgileri anlama Uygulamanızda veya web sitenizde saat dilimi verilerini nasıl kullanacağınızı keşfedin. Saat Dilimi yanıtları bölümüne bakın. inceleyebilirsiniz.
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 birini kullanarak bu API'yi istediğiniz dilde çağırın:

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

Sırada ne var?