
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 ×tamp=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 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 İstemcisi
- Google Haritalar Hizmetleri için Python İstemcisi
- Google Haritalar Hizmetleri için Go İstemcisi
- Google Haritalar Hizmetleri için Node.js İstemcisi
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?
- Saat dilimi isteklerini nasıl yapacağınızı öğrenin: Saat dilimi istekleri ve yanıtları bölümüne gidin.
- En iyi uygulamalardan yararlanın: Web hizmetleriyle ilgili en iyi uygulamalar başlıklı makaleyi inceleyin.