Time Zone API'ye genel bakış

Time Zone API, enlem/boylam koordinatları için HTTP isteği ve istenen tarih ve saat kabul eden bir hizmettir. UTC ve gün ışığından yararlanma saati farkları da dahil olmak üzere konumun saat dilimi verilerini döndürür.

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

Time Zone API ile bir 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'ndaki harita konumları için yerelleştirilmiş saat dilimi adları.
  • Saat dilimi, UTC ile yaz saati farkı olarak belirtilir.

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

Time Zone API ile yapabilecekleriniz

Time Zone API'de dünyanın yüzeyindeki konumların saat dilimi ile UTC saat farkı ve her konumun yaz saati uygulaması için istekte bulunabilirsiniz.

Time Zone API nasıl çalışır?

Time Zone API, enlem/boylam koordinatları için bir HTTPS isteği, zaman damgası olarak istenen tarih ve saat ile isteğe bağlı olarak bir dil kodu kabul eder. İstekte belirtilen biçimde veriler döndürür. Aşağıdaki örnekte, JSON'de istenen bir çıkışla Nevada, ABD için yapılan 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 sağlanan kaynaklar ve döndürdüğü veriler özetlenmektedir.

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

Konum ve zaman damgasıyla birlikte isteğinizi sağlarsınız. Gerekli parametrelere bakın.

  • Saat dilimi kimliği.
  • Saat dilimi adı, isteğe bağlı olarak yerelleştirilmiş
  • UTC saat diliminden saniye cinsinden kapalı
  • DST için ofset (saniye cinsinden)
  • Belirli yanıt örnekleri için Saat Dilimine bakın.
  • JSON
  • XML

Time Zone API nasıl kullanılır?

1 Hazırlanma Google Cloud projenizi ayarlayın ile başlayın ve sonraki kurulum talimatlarını tamamlayın.
2 Saat dilimi isteğini deneme Bir API anahtarınız olduktan 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ıt vermeyle 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ı sayfasına bakın.
5 Saat dilimi verilerini kendi uygulamanıza dahil edin. Zamana dayalı farklı yerel ayarlardaki kullanıcılar için uygulamaları ve web sitelerini geliştirmek üzere saat dilimi verilerini kullanabilirsiniz.

Kullanılabilir istemci kitaplıkları

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

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

Sırada ne var?