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 tahmin 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 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 Şartları. Müşteri, Hava Durumu API'sinden 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ığı şekilde, Hava Durumu API'sinden alınan geçerli Google Haritalar İçeriği'ni geçerli Önbelleğe Alma Dönemi için geçici olarak önbelleğe alabilir.

Tablo 1.3.1 (Önbelleğe Alma İzinleri)

Bu izinler, Google Haritalar Platformu Hizmeti'ne Özel Ş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.

Dakika tahmini 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

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 sonraki sayfasını almak için sonraki istekte giriş parametresi olarak pageToken değerini iletin. İsteğe bağlı

Dakika bazında 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 sonra sona erer.
timeZone İstenen konumun saat dilimi.
segments timeFrame ile gösterilen, dakika düzeyinde tahmin segmentleri.
segments.timeFrame Segmentle ilgili 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 Bu segment sırasında yağış olasılığı tahmini. Değerler 0 ile 100 arasında değişen yüzdelerdir.
segments.qpf Miktar olarak yağış tahmini.
segments.qpf.quantity Bu segmentteki tahmini 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 Bu segmentteki tahmini 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 Bir sonraki sayfayı almak için pageToken olarak gönderilebilen bir jeton. Bu alan atlanırsa sonraki sayfalar olmaz.

Dakikalık tahmin örneği

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

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 belirtir:

  {
  "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"
    },
    ...
  ]
}