Maps Demo Key alın: Weather API'yi Maps Demo Key ile ücretsiz deneyin. Fatura bilgisi gerekmez.

Google, içerikleri tercih ettiğiniz dile çevirmek için yapay zeka teknolojisini kullanır. Yapay zeka çevirilerinde hata olabilir.

Dakikalık tahminleri öğrenme (Deneysel)

forecast:minutes uç noktası, belirli bir konum için yüksek çözünürlüklü, dakika dakika yağış tahmini (anlık hava durumu tahmini olarak da bilinir) sağlar.

API, 6 saatlik bir zaman aralığı için aşağıdaki bilgileri döndürür:

Tahmin zaman aralığının başlangıç ve bitiş zamanı
İstenen konumun saat dilimi
Her tahmin segmentinin başlangıç ve bitiş zamanı
Her segmentte beklenen yağış türü, olasılığı, miktarı ve yoğunluğu

Şartlar

Bu şartlar, Google ve sizin tarafınızdan kabul edilen Google Maps Platform Hizmetine Özel Şartlar'ın 6. bölümü (GKST Öncesi Teklif Şartları) uyarınca yayınlanmıştır.

1.1 İlişkilendirme Koşulları. Müşteri, Weather API'den Google Haritalar İçeriği kullanıyorsa Belgeler'e uygun şekilde Google'a atıfta bulunmalıdır.

1.2 Kısıtlamalar. Müşteriler, Weather API'den alınan Google Haritalar içeriğini bir Google hizmetini veya ürününü yeniden oluşturmak için kullanamaz (ör. Weather API'den alınan verileri, asıl amacı hava durumu bilgisi sağlamak olan bir hava durumu uygulamasında veya hava durumu modelinde kullanmak).

1.3 Önbelleğe alma. Müşteriler, geçerli Google Haritalar İçeriği'ni Weather API'den geçerli Önbelleğe Alma Süresi boyunca geçici olarak önbelleğe alabilir. Bu süre, Tablo 1.3.1'de (Önbelleğe Alma İzinleri) açıklanmıştır.

Tablo 1.3.1 (Önbelleğe Alma İzinleri)

Bu izinler, Google Haritalar Platformu Hizmetine Özel Şartlar'ın Tablo 17.2.1 bölümünde açıklanan izinlere ek olarak geçerlidir.

Google Haritalar İçeriği	Önbelleğe Alma Süresi
Dakikalık tahmin değerleri	Bir saat. Bu sürenin sonunda Müşteri, önbelleğe alınmış Google Haritalar İçeriği'ni silmelidir.

Dakika tahmini istekleri hakkında

Dakika tahminleri istemek için şu adrese bir HTTP GET isteği gönderin:

https://weather.googleapis.com/v1/forecast/minutes:lookup?key=API_KEY&location.latitude=LATITUDE&location.longitude=LONGITUDE

İstek parametrelerinize konumun enlem ve boylam koordinatlarını ekleyin.

İstek parametreleri

forecast.minutes uç noktası aşağıdaki istek parametrelerini kabul eder:

Parametre	Açıklama	Zorunlu veya isteğe bağlı
`location.latitude`	İstenen konumun enlem koordinatları.	Zorunlu
`location.longitude`	İstenen konumun boylam koordinatları.	Zorunlu
`unitsSystem`	İstenen birim sistemi. Değerler şunlardır: `UNITS_SYSTEM_UNSPECIFIED` `IMPERIAL` `METRIC` Birim sistemi belirtilmezse yanıt varsayılan olarak `METRIC` olur.	İsteğe bağlı
`pageSize`	Döndürülecek maksimum sonuç sayısını belirtir.	İsteğe bağlı
`pageToken`	Önceki bir istekten alınan sayfa jetonu. Sonraki veri sayfasını almak için bir sonraki istekte giriş parametresi olarak `pageToken` değerini iletin.	İsteğe bağlı

Dakikalık tahmin yanıtları hakkında

Weather API, yanıt gövdesinde aşağıdaki alanları döndürür:

Alan	Açıklama
`overallPredictionTimeframe`	Tahminlerin genel zaman aralığı.
`overallPredictionTimeframe.startTime`	Tahmin zaman aralığının başlangıç zamanı. Bu, ilk referans noktasını yansıtır.
`overallPredictionTimeframe.endTime`	Tahmin zaman aralığının bitiş zamanı. Bu süre, başlangıç zamanından altı saat sonrasına ayarlanır.
`timeZone`	İstenen konumun saat dilimi.
`segments`	`timeFrame` ile gösterilen dakika düzeyindeki tahmin segmentleri.
`segments.timeFrame`	Segmentle alakalı zaman aralığı.
`segments.timeFrame.startTime`	Segmentin başlangıç zamanı.
`segments.timeFrame.endTime`	Segmentin bitiş zamanı.
`segments.type`	İlgili segmentte beklenen yağış türü. Değerler şunlardır: `DOMINANT_PRECIPITATION_TYPE_UNSPECIFIED` `NONE` `RAIN` `SNOW` `HAIL`
`segments.probability`	İlgili segmentte tahmin edilen yağış olasılığı. Değerler 0 ile 100 arasında değişen yüzdelerdir.
`segments.qpf`	Sayısal yağış tahmini.
`segments.qpf.quantity`	İlgili segmentte beklenen yağış miktarı.
`segments.qpf.unit`	Biriken yağış miktarını ölçmek için kullanılan birim (ör. `MILLIMETERS`, `INCHES`).
`segments.snowfallAmount`	Bu segmentte beklenen kar miktarı.
`segments.snowfallAmount.quantity`	İlgili segmentte tahmin edilen kar miktarı (sıvı su eşdeğeri olarak).
`segments.snowfallAmount.unit`	Biriken kar miktarını ölçmek için kullanılan birim (ör. `MILLIMETERS`, `INCHES`).
`segments.intensity`	Segmentin yağış yoğunluğu (`PrecipitationIntensity`). Olası değerlere örnekler: `PRECIPITATION_INTENSITY_UNSPECIFIED` `NO_INTENSITY` `MID_LIGHT` `LIGHT` `MID_MODERATE` `MODERATE` `MID_HEAVY` `HEAVY` Not: İstemcinizin bilinmeyen değerleri işleyebildiğinden emin olun.
`nextPageToken`	Sonraki sayfayı almak için `pageToken` olarak gönderilebilecek bir jeton. Bu alan atlanırsa sonraki sayfa yoktur.

Dakikalık tahmin örneği

Aşağıdaki örnekte, Batı Virginia'daki bir konum için dakikalık tahmin bilgileri istenmektedir:

curl -H "Content-Type: application/json" -X GET "https://weather.googleapis.com/v1/forecast/minutes:lookup?key=API_KEY&location.latitude=37.60451&location.longitude=-80.59044&unitsSystem=METRIC&pageSize=5"

Yanıttaki segments nesnesi, genel tahmin zaman aralığının her bir segmentini gösterir:

  {
  "overallPredictionTimeframe": {
    "startTime": "2026-05-11T12:10:00Z",
    "endTime": "2026-05-11T18:12:00Z"
  },
  "timeZone": {
    "id": "America/New_York"
  },
  "segments": [
    {
      "timeFrame": {
        "startTime": "2026-05-11T12:20:00Z",
        "endTime": "2026-05-11T12:22:00Z"
      },
      "type": "RAIN",
      "probability": 21,
      "qpf": {
        "quantity": 0.1333,
        "unit": "MILLIMETERS"
      },
      "snowfallAmount": {
        "quantity": 0.0,
        "unit": "MILLIMETERS"
      },
      "intensity": "MODERATE"
    },
    {
      "timeFrame": {
        "startTime": "2026-05-11T12:22:00Z",
        "endTime": "2026-05-11T12:24:00Z"
      },
      "type": "RAIN",
      "probability": 21,
      "qpf": {
        "quantity": 0.1333,
        "unit": "MILLIMETERS"
      },
      "snowfallAmount": {
        "quantity": 0.0,
        "unit": "MILLIMETERS"
      },
      "intensity": "MODERATE"
    },
    ...
  ]
}