Belirli bir konumda, geçerli saatten itibaren 240 saate kadar saatlik tahminleri döndürür.
HTTP isteği
GET https://weather.googleapis.com/v1/forecast/hours:lookup
URL, gRPC Kod Dönüştürme söz dizimini kullanır.
Sorgu parametreleri
| Parametreler | |
|---|---|
| location | 
 Zorunlu. Saatlik tahminin 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 tahmin kaydı sayısı. 1 ile 24 arasında (dahil) 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ı. Mevcut saatten itibaren getirilecek toplam saat miktarını sınırlar. 1 ile 240 (dahil) arasında bir değerdir. Varsayılan değer, izin verilen maksimum değer olan 240'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 | 
|---|
| { "forecastHours": [ { object ( | 
| Alanlar | |
|---|---|
| forecast | 
 Saatlik tahmin, istekte belirtilen saat sayısına ve sayfa boyutuna göre kaydedilir. | 
| 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
ForecastHour
Belirli bir konumdaki saatlik hava durumu tahmini kaydını temsil eder.
| JSON gösterimi | 
|---|
| { "interval": { object ( | 
| Alanlar | |
|---|---|
| interval | 
 Bu tahmin verilerinin geçerli olduğu bir saatlik aralık (UTC saatinde) (zaman damgaları en yakın saate yuvarlanır). | 
| display | 
 Bu saatlik tahminin hesaplandığı konumun saat diliminde yerel tarih ve saat (resmi 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 | 
 Tahmin edilen hava durumu. | 
| temperature | 
 Tahmin edilen sıcaklık. | 
| feels | 
 İstenen konumda sıcaklığın nasıl hissedileceğinin ölçümü. | 
| dew | 
 Tahmin edilen çiy noktası sıcaklığı. | 
| heat | 
 Tahmin edilen ısı endeksi sıcaklığı. | 
| wind | 
 Tahmin edilen rüzgar soğutma etkisi, cilde maruz kalan hava sıcaklığı. | 
| wet | 
 Tahmin edilen yaş termometre sıcaklığı, suyun buharlaştırılmasıyla elde edilebilen en düşük sıcaklıktır. | 
| precipitation | 
 Öngörülen yağış olasılığı ve son bir saat içinde biriken yağış miktarı. | 
| air | 
 Tahmin edilen hava basıncı koşulları. | 
| wind | 
 Tahmin edilen rüzgar koşulları. | 
| visibility | 
 Tahmin edilen görünürlük. | 
| ice | 
 Tahmini 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 | 
 Tahmin edilen bağıl nem yüzdesi (0 ile 100 arasında değerler). | 
| uv | 
 Öngörülen ultraviyole (UV) indeksi. | 
| thunderstorm | 
 Tahmin edilen gök gürültülü fırtına olasılığı (0 ile 100 arasında değerler). | 
| cloud | 
 Gökyüzünün bulutlarla kaplı olduğu tahmini yüzde (0 ile 100 arasında değerler). |