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 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 günlük tahmin kaydı sayısı. 1 ile 10 (dahil) arasında bir değerdir. Varsayılan değer 5'tir.
pageToken

string

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

integer

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

days.lookup RPC'ye verilen 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 tahmin 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)
  },
  "iceThickness": {
    object (IceThickness)
  }
}
Alanlar
interval

object (Interval)

Bu öngörülen günün UTC saat aralığı (başlangıç ve bitiş dahil). Not: Bir gün yerel saatle 07:00'de başlar ve ertesi gün 07:00'de 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 diliminde 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 tahmin edilen hava koşulları.
nighttimeForecast

object (ForecastDayPart)

Günün gece bölümü için öngörülen hava koşulları (yerel saatle 19:00 ile ertesi gün 07:00 arası).
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ı endeksi sıcaklığı.
sunEvents

object (SunEvents)

Güneşle ilgili olaylar (ör. güneşin doğuşu, güneşin batışı).
moonEvents

object (MoonEvents)

Ay ile ilgili etkinlikler (ör. ay doğuşu, ay batışı).
iceThickness

object (IceThickness)

Gün boyunca biriken buz miktarı.

Tarih

Doğum günü gibi takvim tarihlerinin tamamını veya bir kısmını temsil eder. Saat ve saat dilimi başka bir yerde belirtilmiş veya önemsizdir. Tarih, Gregoryen takvimine göredir. Bu durum aşağıdakilerden birini gösterebilir:

  • Sıfır olmayan yıl, ay ve gün değerleri içeren tam tarih.
  • Sıfır yılı olan bir ay ve gün (ör. yıldönümü).
  • Ay ve gün bilgisi olmayan bir yıl.
  • Sıfır gün içeren bir yıl ve ay (ör. 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 veya yıl olmadan tarih belirtmek için 0 olmalıdır.
month

integer

Yılın ayı. 1 ile 12 arasında veya ay ve gün olmadan 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. 0 değerini kullanarak da yıl veya gününün önemli olmadığı bir yıl ve ay belirtebilirsiniz.

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)
  },
  "relativeHumidity": integer,
  "uvIndex": integer,
  "thunderstormProbability": integer,
  "cloudCover": integer
}
Alanlar
interval

object (Interval)

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

object (WeatherCondition)

Tahmin edilen hava durumu.
precipitation

object (Precipitation)

Tahmini yağış.
wind

object (Wind)

Ortalama rüzgar yönü, maksimum hız ve rüzgar anlık hızı.
relativeHumidity

integer

Tahmin edilen bağıl nem yüzdesi (0 ile 100 arasında 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ı) temsil eder.

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

string (Timestamp format)

Güneş doğduğunda.

NOT: Bazı benzersiz durumlarda (ör. Kuzey Kutup Dairesinin kuzeyinde) bir gün boyunca gün doğumu saati olmayabilir. Bu durumlarda bu alanın değeri ayarlanmaz.

Oluşturulan çıktının her zaman Z normalleştirileceği ve 0, 3, 6 veya 9 kesirli basamak kullanacağı RFC 3339'u kullanır. "Z" dışındaki ofsetler de 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ş battığında.

NOT: Bazı benzersiz durumlarda (ör. Kuzey Kutup Dairesinin kuzeyinde) bir gün boyunca gün batımı zamanı olmayabilir. Bu durumlarda bu alanın değeri ayarlanmaz.

Oluşturulan çıktının her zaman Z normalleştirileceği ve 0, 3, 6 veya 9 kesirli basamak kullanacağı RFC 3339'u kullanır. "Z" dışındaki ofsetler de kabul edilir. Örnekler: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" veya "2014-10-02T15:01:23+05:30".

MoonEvents

Ay ile ilgili olayları (ör. ay doğuşu, ay batışı) temsil eder.

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 (https://en.wikipedia.org/wiki/Moonrise_and_moonset).

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

Oluşturulan çıktının her zaman Z normalleştirileceği ve 0, 3, 6 veya 9 kesirli basamak kullanacağı RFC 3339'u kullanır. "Z" dışındaki ofsetler de 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ına kaybolduğu saat (https://en.wikipedia.org/wiki/Moonrise_and_moonset).

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

Oluşturulan çıktının her zaman Z normalleştirileceği ve 0, 3, 6 veya 9 kesirli basamak kullanacağı RFC 3339'u kullanır. "Z" dışındaki ofsetler de 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ın evresi (ay evresi olarak da bilinir).

MoonPhase

Ayın evresini (ay döngüsü) gösterir.

Sıralamalar
MOON_PHASE_UNSPECIFIED Belirtilmemiş ay evresi.
NEW_MOON Ay, güneş tarafından aydınlatılmamalıdır.
WAXING_CRESCENT Ay, kuzey yarım kürede 🌒 sağ tarafında %0-50, güney yarım kürede 🌘 ise sol tarafında aydınlatılmıştır.
FIRST_QUARTER Ay, kuzey yarım kürede 🌓 sağ tarafında %50,1, güney yarım kürede 🌗 ise sol tarafında %50,1 aydınlatılmıştır.
WAXING_GIBBOUS Ay, kuzey yarımkürede 🌔 sağ tarafı, güney yarımkürede 🌖 ise sol tarafı %50-100 aydınlatılmış durumdadır.
FULL_MOON Ay tamamen aydınlatılmış olmalıdır.
WANING_GIBBOUS Ay, kuzey yarımkürede 🌖 sol tarafında %50-100, güney yarımkürede 🌔 sağ tarafında% 50-100 aydınlatılmış.
LAST_QUARTER Ay, kuzey yarımkürede 🌗 sol tarafında %50,1 ve güney yarımkürede 🌓 sağ tarafında %50,1 ışık alıyor.
WANING_CRESCENT Ay, kuzey yarımkürede 🌘 sol tarafında %0-50, güney yarımkürede 🌒 sağ tarafında% 0-50 aydınlatılmıştır.