Dakikalık tahminleri öğrenme (Deneysel)

forecast:minutes uç noktası, belirli bir konum için yüksek çözünürlüklü, dakikaya göre 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 bir öngörme segmentinin başlangıç ve bitiş zamanı
  • Her segment sırasında tahmin edilen yağış türü, olasılığı, miktarı ve yoğunluğu

Şartlar

Bu şartlar, Google ve sizin tarafınızdan kabul edildiği üzere Google Haritalar Platformu Hizmetine Özgü Şartlar'ın 6. Bölümü (GKST Öncesi Teklif Şartları) uyarınca yayınlanmıştır.

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

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

1.3 Önbelleğe Alma. Müşteriler, Tablo 1.3.1'de (Önbelleğe Alma İzinleri) açıklandığı gibi, geçerli Google Haritalar İçeriği'ni Weather API'sinden geçerli Önbelleğe Alma Süresi boyunca geçici olarak önbelleğe alabilir.

Tablo 1.3.1 (Önbelleğe Alma İzinleri)

Bu izinler, Google Haritalar Platformu Hizmetine Özgü Şartlar'ın Tablo 17.2.1'inde açıklanan izinlere ek olarak verilir.

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.

Dakikalık tahmin istekleri hakkında

Dakikalık tahmin 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

Bir 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. Verilerin bir sonraki 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 metninde 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, başlangıçtaki referans noktasını yansıtır.
overallPredictionTimeframe.endTime Tahmin zaman aralığının bitiş zamanı. Bu süre, başlangıç zamanından altı saat sonra ayarlanır.
timeZone İstenen konumun saat dilimi.
segments timeFrame ile gösterilen, dakikaya göre tahmin segmentleri.
segments.timeFrame Segmentle alakalı zaman aralığı.
segments.timeFrame.startTime Segmentin başlangıç zamanı.
segments.timeFrame.endTime Segmentin bitiş zamanı.
segments.type Bu segment sırasında tahmin edilen yağış türü. Değerler şunlardır:
  • DOMINANT_PRECIPITATION_TYPE_UNSPECIFIED
  • NONE
  • RAIN
  • SNOW
  • HAIL
segments.probability Bu segmentte yağmur yağma olasılığı tahmin edilir. Değerler, yüzde olarak 0 ile 100 arasında değişir.
segments.qpf Yağış sayısal tahmini.
segments.qpf.quantity Bu segment sırasında beklenen yağış miktarı.
segments.qpf.unit Biriken yağmur miktarını ölçmek için kullanılan birim (ör. MILLIMETERS, INCHES).
segments.snowfallAmount Bu segment sırasında tahmin edilen kar miktarı.
segments.snowfallAmount.quantity Bu segment sırasında 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. Değerler şunlardır:
  • PRECIPITATION_INTENSITY_UNSPECIFIED
  • NO_INTENSITY
  • LIGHT
  • MODERATE
  • HEAVY
nextPageToken Sonraki sayfayı almak için pageToken olarak gönderilebilen 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 dakika bazında 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 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"
    },
    ...
  ]
}