Method: history.hours.lookup

Belirli bir konumdaki saatlik geçmiş hava durumu verilerini son saatten başlayarak 24 saate kadar 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

object (LatLng)

Zorunlu. Saatlik geçmiş verilerin alınacağı konum.

unitsSystem

enum (UnitsSystem)

İsteğe bağlıdır. Döndürülen hava durumu koşulları için kullanılacak birim sistemi. Belirtilmezse döndürülen hava durumu koşulları metrik sistemde olur (varsayılan = METRIC).

pageSize

integer

İsteğe bağlıdır. Sayfa başına döndürülecek maksimum saatlik geçmiş kayıt sayısı (1 ile 24 arasında bir değer). Varsayılan değer, izin verilen maksimum değer olan 24'tür.

pageToken

string

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

hours

integer

İsteğe bağlıdır. Son saatten itibaren getirilecek toplam saat sayısını 1 ile 24 (dahil) arasında bir değerle sınırlar. Varsayılan değer, izin verilen maksimum değer olan 24'tür.

languageCode

string

İsteğe bağlıdır. İstemcinin yanıtın dilini seçmesine olanak tanır. Bu dil için veri sağlanamıyorsa API, en yakın eşleşmeyi kullanır. İzin verilen değerler IETF BCP-47 standardına dayanır. Varsayılan değer "en"dir.

İstek metni

İstek metni boş olmalıdır.

Yanıt metni

hours.lookup RPC'sinin yanıtı.

Başarılı olursa yanıt metni aşağıdaki yapıyla birlikte verileri içerir:

JSON gösterimi
{
  "historyHours": [
    {
      object (HistoryHour)
    }
  ],
  "timeZone": {
    object (TimeZone)
  },
  "nextPageToken": string
}
Alanlar
historyHours[]

object (HistoryHour)

İstekte belirtilen saat sayısına ve sayfa boyutuna göre saatlik geçmiş kayıtlar.

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

HistoryHour

Belirli bir konumdaki saatlik geçmiş 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 geçmiş verilerin geçerli olduğu bir saatlik aralık (UTC saatine göre) (zaman damgaları en yakın saate yuvarlanır).

displayDateTime

object (DateTime)

Bu saatlik kaydın hesaplandığı konumun saat dilimindeki 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 farkı içerir.

weatherCondition

object (WeatherCondition)

Geçmişteki hava durumu.

temperature

object (Temperature)

Geçmişteki sıcaklık.

feelsLikeTemperature

object (Temperature)

İstenen konumda hissedilen sıcaklığın ölçüsü.

dewPoint

object (Temperature)

Geçmişteki çiy noktası sıcaklığı.

heatIndex

object (Temperature)

Geçmişteki ısı endeksi sıcaklığı.

windChill

object (Temperature)

Geçmişteki hissedilen sıcaklık, deriye temas eden hava sıcaklığı.

wetBulbTemperature

object (Temperature)

Geçmişteki yaş termometre sıcaklığı, suyu buharlaştırarak elde edilebilecek en düşük sıcaklık.

precipitation

object (Precipitation)

Geçmiş yağış olasılığı ve son bir saatte biriken yağış miktarı.

airPressure

object (AirPressure)

Geçmişteki hava basıncı koşulları.

wind

object (Wind)

Geçmişteki rüzgar koşulları.

visibility

object (Visibility)

Geçmiş görünürlük.

iceThickness

object (IceThickness)

Geçmişteki buz kalınlığı.

isDaytime

boolean

Bu saat, yerel gün doğumu (dahil) ve gün batımı (hariç) saatleri arasındaysa doğru. Aksi takdirde gece (güneşin batışı ile bir sonraki güneşin doğuşu arasında) olur. Not: Bu saat, aralık sırasıyla yerel gün doğumu ve gün batımı saatleriyle kesişiyorsa gündüz veya gece olarak kabul edilir (ör. aralık 05:00-06:00 ise ve gün doğumu 05:59'da ise isDaytime true olur).

relativeHumidity

integer

Bağıl nemin geçmişteki yüzdesi (0-100 arasındaki değerler).

uvIndex

integer

Geçmişteki ultraviyole (UV) indeksi.

thunderstormProbability

integer

Geçmişteki gök gürültülü fırtına olasılığı (0 ile 100 arasındaki değerler).

cloudCover

integer

Gökyüzünün bulutlarla kaplı olduğu geçmişteki yüzdelik değer (0 ile 100 arasındaki değerler).