Method: forecast.hours.lookup

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

object (LatLng)

Zorunlu. Saatlik tahminin alınacağı konum.

unitsSystem

enum (UnitsSystem)

İ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).

pageSize

integer

İ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.

pageToken

string

İsteğe bağlı. Önceki bir istekten alınan sayfa jetonu. Sonraki sayfayı almak için kullanılır.

hours

integer

İ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.

languageCode

string

İ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 (ForecastHour)
    }
  ],
  "timeZone": {
    object (TimeZone)
  },
  "nextPageToken": string
}
Alanlar
forecastHours[]

object (ForecastHour)

Saatlik tahmin, istekte belirtilen saat sayısına ve sayfa boyutuna göre kaydedilir.

timeZone

object (TimeZone)

İstenen konumdaki saat dilimi.

nextPageToken

string

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 (Interval)
  },
  "displayDateTime": {
    object (DateTime)
  },
  "weatherCondition": {
    object (WeatherCondition)
  },
  "temperature": {
    object (Temperature)
  },
  "feelsLikeTemperature": {
    object (Temperature)
  },
  "dewPoint": {
    object (Temperature)
  },
  "heatIndex": {
    object (Temperature)
  },
  "windChill": {
    object (Temperature)
  },
  "wetBulbTemperature": {
    object (Temperature)
  },
  "precipitation": {
    object (Precipitation)
  },
  "airPressure": {
    object (AirPressure)
  },
  "wind": {
    object (Wind)
  },
  "visibility": {
    object (Visibility)
  },
  "iceThickness": {
    object (IceThickness)
  },
  "isDaytime": boolean,
  "relativeHumidity": integer,
  "uvIndex": integer,
  "thunderstormProbability": integer,
  "cloudCover": integer
}
Alanlar
interval

object (Interval)

Bu tahmin verilerinin geçerli olduğu bir saatlik aralık (UTC saatinde) (zaman damgaları en yakın saate yuvarlanır).

displayDateTime

object (DateTime)

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.

weatherCondition

object (WeatherCondition)

Tahmin edilen hava durumu.

temperature

object (Temperature)

Tahmin edilen sıcaklık.

feelsLikeTemperature

object (Temperature)

İstenen konumda sıcaklığın nasıl hissedileceğinin ölçümü.

dewPoint

object (Temperature)

Tahmin edilen çiy noktası sıcaklığı.

heatIndex

object (Temperature)

Tahmin edilen ısı endeksi sıcaklığı.

windChill

object (Temperature)

Tahmin edilen rüzgar soğutma etkisi, cilde maruz kalan hava sıcaklığı.

wetBulbTemperature

object (Temperature)

Tahmin edilen yaş termometre sıcaklığı, suyun buharlaştırılmasıyla elde edilebilen en düşük sıcaklıktır.

precipitation

object (Precipitation)

Öngörülen yağış olasılığı ve son bir saat içinde biriken yağış miktarı.

airPressure

object (AirPressure)

Tahmin edilen hava basıncı koşulları.

wind

object (Wind)

Tahmin edilen rüzgar koşulları.

visibility

object (Visibility)

Tahmin edilen görünürlük.

iceThickness

object (IceThickness)

Tahmini buz kalınlığı.

isDaytime

boolean

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).

relativeHumidity

integer

Tahmin edilen bağıl nem yüzdesi (0 ile 100 arasında değerler).

uvIndex

integer

Öngörülen ultraviyole (UV) indeksi.

thunderstormProbability

integer

Tahmin edilen gök gürültülü fırtına olasılığı (0 ile 100 arasında değerler).

cloudCover

integer

Gökyüzünün bulutlarla kaplı olduğu tahmini yüzde (0 ile 100 arasında değerler).