Weather API'ye genel bakış

Weather API, dünyanın dört bir yanındaki konumlar için gerçek zamanlı ve yakın çevreye özel hava durumu verileri istemenize olanak tanır. Bu verilerle canlı hava durumu kontrol panellerini, hava durumu güncelleme uygulamalarını, rota hava durumu yer paylaşımlarını ve hava durumuna dayalı sağlık veya aktivite izleyicileri destekleyebilirsiniz. Hava durumu bilgileri arasında mevcut sıcaklık, yağış, bağıl nem, rüzgar hızı, UV indeksi ve daha fazlası yer alır.

API, belirli bir enlem ve boylamdaki konum için aşağıdaki tabloda yer alan verilerle ilgili uç noktalar (https://weather.googleapis.com/v1/...) sağlar.

REST uç noktalarına genel bakış

API uç noktası URL Açıklama Belgelenmiş parametreler
Güncel hava koşulları https://weather.googleapis.com/v1/currentConditions:lookup Canlı hava koşulları location.latitude, location.longitude
Saatlik tahmin https://weather.googleapis.com/v1/forecast/hours:lookup 240 saate kadar hava durumu tahmini location.latitude, location.longitude
Günlük tahmin https://weather.googleapis.com/v1/forecast/days:lookup 10 güne kadar tahmini hava koşulları location.latitude, location.longitude
Saatlik geçmiş https://weather.googleapis.com/v1/history/hours:lookup 24 saate kadar önbelleğe alınmış geçmiş koşullar location.latitude, location.longitude
Kötü hava koşulları uyarıları https://weather.googleapis.com/v1/publicAlerts:lookup Kötü hava koşulları uyarıları key, location.latitude, location.longitude

Yaygın kullanım alanları

Weather API'nin özellikleri

Weather API verileri şunları içerir:

  • Hava durumu ve simgeler: weatherCondition konumundaki mevcut hava durumunu (ör. "Bulutlu" veya "Yer yer kar yağışlı") gösteren bir açıklama ve ilgili simge.
  • Sıcaklık: Mevcut sıcaklık (temperature), minimum ve maksimum sıcaklıklar (günlük tahminlerde minTemperature ve maxTemperature veya currentConditionsHistory içinde) ve hissedilen sıcaklık (feelsLikeTemperature).
  • Yağış: Toplam yağış ve yağış türü (kar, yağmur, buz, karışık).
  • Rüzgar: Rüzgar soğutması (windChill), rüzgar yönü (wind.direction), rüzgar hızı (wind.speed) ve rüzgar hamlesi (wind.gust).
  • Buz kalınlığı: Buzun kalınlığı.
  • Nem: Çiğlenme noktası (dewPoint), ısı endeksi (heatIndex), yaş termometre sıcaklığı (wetBulbTemperature) ve bağıl nem (relativeHumidity).
  • UV indeksi: Ultraviyole (UV) indeksi (uvIndex).
  • Gök gürültülü fırtına olasılığı: Gök gürültülü fırtına olasılığının yüzdesi.
  • Görüş mesafesi: Bir nesnenin net bir şekilde görülebildiği mesafe.
  • Hava basıncı: Ortalama deniz seviyesi hava basıncı.
  • Güneş ve ay etkinlikleri: Gün doğumu, gün batımı, ay doğumu ve ay batımı saatleri.
  • Bulutluluk: Gökyüzünün bulutlarla kaplı yüzdesi.

Weather API'yi kullanma

1 Kurulumu tamamlama Google Cloud projenizi ayarlama bölümünden başlayın ve sonraki talimatları uygulayın.
2 Mevcut koşulları öğrenme Mevcut koşulları alma bölümüne bakın.
3 Saatlik hava durumu tahminini öğrenme Saatlik hava durumu tahminini alma bölümüne bakın.
4 Günlük hava durumu tahminini alma Günlük hava durumu tahminini alma bölümüne bakın.
5 Saatlik geçmişi alma Saatlik geçmişi alma bölümünü inceleyin.
6 Hava durumu uyarıları alma Hava durumu uyarıları alma başlıklı makaleyi inceleyin.

Hava kalitesi indeksi (HKİ) ve partikül kirleticiler (PM2.5, PM10) için Air Quality API'yi (https://airquality.googleapis.com/v1/currentConditions:lookup) kullanın. Weather API bu değerleri döndürmez.

Çevreyle ilgili diğer API'ler şunlardır:

  • Polen sayıları: Pollen API (https://pollen.googleapis.com/v1/forecast:lookup)
  • Güneş radyasyonu ve çatı potansiyeli: Solar API (https://solar.googleapis.com/v1/buildingInsights:findClosest)

Sırada ne var?