Belirli bir konumda son saatten itibaren 24 saate kadar saatlik geçmiş hava durumu verilerini döndürür.
HTTP isteği
GET https://weather.googleapis.com/v1/history/hours:lookup
URL, gRPC Kod Dönüştürme söz dizimini kullanır.
Sorgu parametreleri
Parametreler | |
---|---|
location |
Zorunlu. Saatlik geçmiş verilerinin alınacağı konum. |
units |
İsteğe bağlı. Döndürülen hava durumu koşulları için kullanılacak birim sistemi. Bu parametre sağlanmazsa döndürülen hava koşulları metrik sistemde olur (varsayılan = METRIC). |
page |
İsteğe bağlı. Sayfa başına döndürülecek maksimum saatlik geçmiş kayıt sayısı. 1 ile 24 (dahil) arasında bir değerdir. Varsayılan değer, izin verilen maksimum değer olan 24'tür. |
page |
İsteğe bağlı. Önceki bir istekten alınan sayfa jetonu. Sonraki sayfayı almak için kullanılır. |
hours |
İsteğe bağlı. Son saatten itibaren getirilecek toplam saat miktarını sınırlar. 1 ile 24 arasında (dahil) bir değerdir. Varsayılan değer, izin verilen maksimum değer olan 24'tür. |
language |
İsteğe bağlı. İstemcinin yanıtın dilini seçmesine olanak tanır. Söz konusu dil için veri sağlanamazsa API en yakın eşlemeyi kullanır. İzin verilen değerler IETF BCP-47 standardını temel alır. Varsayılan değer "en"dir. |
İstek içeriği
İstek metni boş olmalıdır.
Yanıt gövdesi
hours.lookup RPC'si için yanıt.
Başarılı olursa yanıt metni aşağıdaki yapıyla birlikte verileri içerir:
JSON gösterimi |
---|
{ "historyHours": [ { object ( |
Alanlar | |
---|---|
history |
İstekte belirtilen saat sayısına ve sayfa boyutuna göre saatlik geçmiş kayıtlar. |
time |
İstenen konumdaki saat dilimi. |
next |
Sonraki sayfayı almak için kullanılan jeton. |
Yetkilendirme kapsamları
Aşağıdaki OAuth kapsamını gerektirir:
https://www.googleapis.com/auth/cloud-platform
HistoryHour
Belirli bir konumdaki saatlik geçmiş kaydını temsil eder.
JSON gösterimi |
---|
{ "interval": { object ( |
Alanlar | |
---|---|
interval |
Bu geçmiş verilerin geçerli olduğu bir saatlik aralık (UTC saatinde) (zaman damgalarının en yakın saate yuvarlanması). |
display |
Bu saatlik kaydın hesaplandığı konumun saat diliminde yerel tarih ve saat (medeni saat). Bu alan, istemcide görüntüleme amacıyla kullanılabilir. Not: Bu tarih; yıl, ay, gün, saat ve UTC'den saat farkı bilgilerinden oluşur. |
weather |
Geçmiş hava durumu. |
temperature |
Geçmiş sıcaklık. |
feels |
İstenen konumda sıcaklığın nasıl hissedildiğine dair ölçüm. |
dew |
Geçmiş çiy noktası sıcaklığı. |
heat |
Geçmiş ısı endeksi sıcaklığı. |
wind |
Geçmişteki rüzgar soğutma etkisi, cilde maruz kalan hava sıcaklığı. |
wet |
Geçmiş yaş termometre sıcaklığı, suyun buharlaştırılmasıyla elde edilebilen en düşük sıcaklık. |
precipitation |
Geçmiş yağış olasılığı ve son bir saat içinde biriken yağış miktarı. |
air |
Geçmiş hava basıncı koşulları. |
wind |
Geçmiş rüzgar koşulları. |
visibility |
Geçmiş görünürlük. |
ice |
Geçmiş buz kalınlığı. |
is |
Bu saat yerel gün doğumu (dahil) ile gün batımı (hariç) saatleri arasındaysa doğru değerini döndürür. Aksi takdirde gecedir (güneş batışı ile bir sonraki güneşin doğuşu arasında). Not: Aralık sırasıyla yerel gündoğumu ve günbatımı saatleriyle kesişiyorsa bu saat gündüz veya gece olarak kabul edilir (ör. aralık 05:00 ile 06:00 arasındaysa ve gündoğumu 05:59'daysa isDaytime doğru olur). |
relative |
Bağıl nemin geçmiş yüzdesi (0 ile 100 arasında değerler). |
uv |
Geçmişteki ultraviyole (UV) indeksi. |
thunderstorm |
Geçmiş yıldırım olasılığı (0 ile 100 arasında değerler). |
cloud |
Gökyüzünün bulutlarla kaplı olduğu geçmiş yüzde (0 ile 100 arasında değerler). |