Method: forecast.days.lookup

Belirli bir konumda, geçerli günden başlayarak 10 güne kadar günlük tahminleri döndürür.

HTTP isteği

GET https://weather.googleapis.com/v1/forecast/days:lookup

URL, gRPC Kod Dönüştürme söz dizimini kullanır.

Sorgu parametreleri

Parametreler
location

object (LatLng)

Zorunlu. Günlük hava durumu tahmininin 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 günlük hava durumu kaydı sayısı (1-10 arası bir değer). Varsayılan değer 5'tir.
pageToken

string

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

integer

İsteğe bağlıdır. Mevcut günden itibaren getirilecek toplam gün sayısını 1 ile 10 (1 ve 10 dahil) arasında bir değerle sınırlar. Varsayılan değer, izin verilen maksimum değer olan 10'dur.
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

days.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 
{
  "forecastDays": [
    {
      object (ForecastDay)
    }
  ],
  "timeZone": {
    object (TimeZone)
  },
  "nextPageToken": string
}
Alanlar
forecastDays[]

object (ForecastDay)

İstekte belirtilen gün sayısına ve sayfa boyutuna göre günlük tahmin 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

ForecastDay

Belirli bir konumdaki günlük hava durumu kaydını temsil eder.

JSON gösterimi 
{
  "interval": {
    object (Interval)
  },
  "displayDate": {
    object (Date)
  },
  "daytimeForecast": {
    object (ForecastDayPart)
  },
  "nighttimeForecast": {
    object (ForecastDayPart)
  },
  "maxTemperature": {
    object (Temperature)
  },
  "minTemperature": {
    object (Temperature)
  },
  "feelsLikeMaxTemperature": {
    object (Temperature)
  },
  "feelsLikeMinTemperature": {
    object (Temperature)
  },
  "maxHeatIndex": {
    object (Temperature)
  },
  "sunEvents": {
    object (SunEvents)
  },
  "moonEvents": {
    object (MoonEvents)
  }
}
Alanlar
interval

object (Interval)

Bu tahmin edilen günün başladığı (dahil) ve sona erdiği (hariç) UTC zaman aralığı. Not: Bir gün, yerel saatle 07:00'da başlar ve ertesi gün 07:00'da sona erer. Örneğin: Yerel saat dilimi UTC-7 ise aralık 14:00:00.000Z saatinde başlar ve ertesi gün aynı saatte sona erer.
displayDate

object (Date)

Bu günlük tahminin hesaplandığı konumun saat dilimindeki yerel tarih (resmi saat). Bu alan, istemcide görüntüleme amacıyla kullanılabilir.
daytimeForecast

object (ForecastDayPart)

Günün gündüz bölümü (yerel saatle 07:00-19:00) için hava durumu tahmini.
nighttimeForecast

object (ForecastDayPart)

Günün gece kısmındaki (yerel saatle 19:00-07:00) hava durumu tahminleri.
maxTemperature

object (Temperature)

Gün boyunca ölçülen maksimum (yüksek) sıcaklık.
minTemperature

object (Temperature)

Gün boyunca ölçülen minimum (düşük) sıcaklık.
feelsLikeMaxTemperature

object (Temperature)

Gün boyunca hissedilen maksimum (yüksek) sıcaklık.
feelsLikeMinTemperature

object (Temperature)

Gün boyunca hissedilen minimum (düşük) sıcaklık.
maxHeatIndex

object (Temperature)

Gün boyunca ölçülen maksimum ısı indeksi sıcaklığı.
sunEvents

object (SunEvents)

Güneşle ilgili olaylar (ör. gün doğumu, gün batımı).
moonEvents

object (MoonEvents)

Ayla ilgili olaylar (ör. ayın doğuşu, ayın batışı).

Tarih

Doğum günü gibi tam veya kısmi bir takvim tarihini gösterir. Günün saati ve saat dilimi başka bir yerde belirtilmiştir veya önemsizdir. Tarih, Gregoryen Takvimi'ne göre belirlenir. Bu, aşağıdakilerden birini temsil edebilir:

  • Yıl, ay ve gün değerleri sıfır olmayan tam bir tarih.
  • Ay ve gün, sıfır yıl ile (örneğin, yıl dönümü).
  • Tek başına bir yıl, sıfır ay ve sıfır gün.
  • Yıl ve ay, sıfır günle (örneğin, kredi kartının son kullanma tarihi).

İlgili türler:

JSON gösterimi 
{
  "year": integer,
  "month": integer,
  "day": integer
}
Alanlar
year

integer

Tarihin yılı. 1 ile 9999 arasında olmalı veya yıl içermeyen bir tarih belirtmek için 0 olmalıdır.
month

integer

Yılın ayı. 1 ile 12 arasında olmalı veya ay ve gün içermeyen bir yıl belirtmek için 0 olmalıdır.
day

integer

Ayın günü. 1 ile 31 arasında olmalı ve yıl ile ay için geçerli olmalıdır. Yalnızca bir yılı veya günün önemli olmadığı bir yıl ve ayı belirtmek için 0 olmalıdır.

ForecastDayPart

Günün bir bölümüne ait tahmin kaydını temsil eder.

JSON gösterimi 
{
  "interval": {
    object (Interval)
  },
  "weatherCondition": {
    object (WeatherCondition)
  },
  "precipitation": {
    object (Precipitation)
  },
  "wind": {
    object (Wind)
  },
  "iceThickness": {
    object (IceThickness)
  },
  "relativeHumidity": integer,
  "uvIndex": integer,
  "thunderstormProbability": integer,
  "cloudCover": integer
}
Alanlar
interval

object (Interval)

Günün bu bölümünün başladığı (dahil) ve sona erdiği (hariç) UTC tarihi ve saati. Not: Bir günün bir kısmı, yerel saatle aynı gün 07:00'da başlar ve 19:00'da sona erer. Örneğin: Yerel saat dilimi UTC-7 ise gündüz aralığı 14:00:00.000Z saatinde başlayıp ertesi gün 02:00:00.000Z saatinde sona erer. Gece aralığı ise ertesi gün 02:00:00.000Z saatinde başlayıp aynı gün 14:00:00.000Z saatinde sona erer.
weatherCondition

object (WeatherCondition)

Tahmini hava durumu koşulu.
precipitation

object (Precipitation)

Tahmin edilen yağış.
wind

object (Wind)

Ortalama rüzgar yönü, maksimum hız ve rüzgar hamlesi.
iceThickness

object (IceThickness)

Günün bir bölümünde biriken buz miktarı.
relativeHumidity

integer

Bağıl nemin tahmin edilen yüzdesi (0 ile 100 arasındaki değerler).
uvIndex

integer

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

integer

Ortalama gök gürültülü fırtına olasılığı.
cloudCover

integer

Ortalama bulut örtüsü yüzdesi.

SunEvents

Güneşle ilgili olayları (ör. gün doğumu, gün batımı) gösterir.

JSON gösterimi 
{
  "sunriseTime": string,
  "sunsetTime": string
}
Alanlar
sunriseTime

string (Timestamp format)

Güneşin doğduğu saat.

NOT: Bazı özel durumlarda (ör. Kuzey Kutup Dairesi'nin kuzeyinde) bir gün için gün doğumu saati olmayabilir. Bu durumlarda bu alan ayarlanmamış olur.

Zaman damgasında RFC 3339 kullanılır. Yani oluşturulan çıkış her zaman Z ile normalleştirilir ve 0, 3, 6 veya 9 kesirli basamak kullanılır. "Z" dışındaki zaman farkları da kabul edilir. Örnekler: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" veya "2014-10-02T15:01:23+05:30".
sunsetTime

string (Timestamp format)

Güneşin battığı saat.

NOT: Bazı özel durumlarda (ör. Kuzey Kutup Dairesi'nin kuzeyinde) bir gün için gün batımı saati olmayabilir. Bu durumlarda bu alan ayarlanmamış olur.

Zaman damgasında RFC 3339 kullanılır. Yani oluşturulan çıkış her zaman Z ile normalleştirilir ve 0, 3, 6 veya 9 kesirli basamak kullanılır. "Z" dışındaki zaman farkları da kabul edilir. Örnekler: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" veya "2014-10-02T15:01:23+05:30".

MoonEvents

Ayla ilgili olayları (ör. ayın doğuşu, ayın batışı) gösterir.

JSON gösterimi 
{
  "moonriseTimes": [
    string
  ],
  "moonsetTimes": [
    string
  ],
  "moonPhase": enum (MoonPhase)
}
Alanlar
moonriseTimes[]

string (Timestamp format)

Ayın üst kısmının ufuk çizgisinin üzerinde göründüğü zaman (bkz. https://en.wikipedia.org/wiki/Moonrise_and_moonset).

NOT: Çoğu durumda, günde tek bir ay doğumu saati olur. Diğer durumlarda ise liste boş olabilir (ör. ay, ertesi gün gece yarısından sonra doğduğunda). Ancak, benzersiz durumlarda (ör. kutup bölgelerinde) listede birden fazla değer olabilir. Bu durumlarda değerler artan düzende sıralanır.

Zaman damgasında RFC 3339 kullanılır. Yani oluşturulan çıkış her zaman Z ile normalleştirilir ve 0, 3, 6 veya 9 kesirli basamak kullanılır. "Z" dışındaki zaman farkları da kabul edilir. Örnekler: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" veya "2014-10-02T15:01:23+05:30".
moonsetTimes[]

string (Timestamp format)

Ayın üst kısmının ufuk çizgisinin altında kaybolduğu zaman (bkz. https://en.wikipedia.org/wiki/Moonrise_and_moonset).

NOT: Çoğu durumda, ayın batma zamanı günde bir kez olur. Diğer durumlarda ise liste boş olabilir (ör. ay, ertesi gün gece yarısından sonra battığında). Ancak, benzersiz durumlarda (ör. kutup bölgelerinde) listede birden fazla değer olabilir. Bu durumlarda değerler artan düzende sıralanır.

Zaman damgasında RFC 3339 kullanılır. Yani oluşturulan çıkış her zaman Z ile normalleştirilir ve 0, 3, 6 veya 9 kesirli basamak kullanılır. "Z" dışındaki zaman farkları da kabul edilir. Örnekler: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" veya "2014-10-02T15:01:23+05:30".
moonPhase

enum (MoonPhase)

Ay evresi (diğer adıyla ayın evresi).

MoonPhase

Ay evresini (diğer adıyla ayın evresi) gösterir.

Sıralamalar
MOON_PHASE_UNSPECIFIED Belirtilmemiş ay evresi.
NEW_MOON Ay, güneş tarafından aydınlatılmaz.
WAXING_CRESCENT Ay, Kuzey Yarım Küre'de sağ tarafı %0-50 oranında, Güney Yarım Küre'de ise sol tarafı% 0-50 oranında aydınlatılmış şekilde gösterilir 🌒.
FIRST_QUARTER Ay, Kuzey Yarım Küre'de sağ tarafı 🌓, Güney Yarım Küre'de ise sol tarafı 🌗% 50,1 oranında aydınlatılmış şekilde görünür.
WAXING_GIBBOUS Ay, kuzey yarım kürede sağ tarafı %50-100 oranında, güney yarım kürede ise sol tarafı% 50-100 oranında aydınlatılmış olarak gösterilir 🌔🌖.
FULL_MOON Ay tamamen aydınlatılmıştır.
WANING_GIBBOUS Kuzey yarım kürede Ay'ın sol tarafı %50-100 oranında aydınlatılır 🌖, güney yarım kürede ise sağ tarafı aydınlatılır 🌔.
LAST_QUARTER Ay, kuzey yarım kürede sol tarafında %50,1, güney yarım kürede ise sağ tarafında %50,1 oranında aydınlanıyor. 🌗🌓
WANING_CRESCENT Ay, kuzey yarım kürede sol tarafında (%0-50) 🌘, güney yarım kürede ise sağ tarafında (%0-50) 🌒 aydınlatılır.