Hava Durumu API

81 il ve 973 ilçe için anlık hava, UV indeksi, 24 saatlik ve 7 günlük tahmin; Türkçe durum adlarıyla.

Ücretsiz pakette var JSON · Türkçe3 uç Kaynak: MET Norway, Open-Meteo

/v1/hava konum adı, il/ilçe ya da koordinatla çalışır; anlık sıcaklık, hissedilen, nem, rüzgâr, bulut, UV indeksi ve Türkçe durum adını ("parçalı bulutlu" gibi), ardından 24 saatlik ve 7 günlük tahmini döndürür. Tüm il ve ilçe merkezlerinin verisi önceden çekildiği için yanıtlar hızlıdır.

Daha fazla ayrıntı için /v1/hava/detay (çiy noktası, basınç, görüş, rüzgâr hamlesi, 16 güne kadar tahmin) ve /v1/hava/yagis (önümüzdeki 24 saat için 15 dakikalık yağış, kar ve olasılık) uçları vardır.

Hızlı başlangıç

Anahtarınızı X-API-Key başlığında gönderin (ücretsiz anahtar al). Anahtarı tarayıcı koduna koymayın; sunucunuzdan çağırıp sonucu önbelleğe alın.

<?php
$ch = curl_init('https://api.veriapi.pro/v1/hava?il=duzce&ilce=akcakoca');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT => 10,
    CURLOPT_HTTPHEADER => ['X-API-Key: va_ANAHTARINIZ'],
]);
$yanit = json_decode(curl_exec($ch), true);
curl_close($ch);
print_r($yanit['veri']);
const yanit = await fetch("https://api.veriapi.pro/v1/hava?il=duzce&ilce=akcakoca", {
  headers: { "X-API-Key": "va_ANAHTARINIZ" },
});
const { veri, kaynak } = await yanit.json();
console.log(veri);
import requests

r = requests.get("https://api.veriapi.pro/v1/hava?il=duzce&ilce=akcakoca",
                 headers={"X-API-Key": "va_ANAHTARINIZ"}, timeout=10)
print(r.json()["veri"])
curl -H "X-API-Key: va_ANAHTARINIZ" \
  "https://api.veriapi.pro/v1/hava?il=duzce&ilce=akcakoca"

Örnek yanıt

GET https://api.veriapi.pro/v1/hava?il=duzce&ilce=akcakoca — gerçek veriyle; listeler kısaltıldı.

{
  "veri": {
    "konum": {
      "id": 1045,
      "tur": "ilce",
      "ad": "Akçakoca",
      "il": "Düzce",
      "plaka": 81,
      "slug": "duzce-akcakoca",
      "enlem": 41.08897,
      "boylam": 31.12497
    },
    "anlik": {
      "zaman": "2026-11-02T01:00:00+03:00",
      "sicaklik": 15.1,
      "nem": 87.4,
      "basinc": 1016.8,
      "bulut": 96.9,
      "ruzgar_kmh": 9.7,
      "ruzgar_yon": 168.8,
      "durum": {
        "kod": "cloudy",
        "ad": "Bulutlu",
        "simge": "cloud",
        "gece": false
      },
      "yagis_mm": 0.0,
      "uv": {
        "deger": 0.0,
        "seviye": "Düşük"
      }
    },
    "saatlik": [
      {
        "zaman": "2026-11-02T01:00:00+03:00",
        "sicaklik": 15.1,
        "durum": {
          "kod": "cloudy",
          "ad": "Bulutlu",
          "simge": "cloud",
          "gece": false
        },
        "yagis_mm": 0.0,
        "ruzgar_kmh": 9.7,
        "uv": 0.0
      },
      {
        "zaman": "2026-11-02T02:00:00+03:00",
        "sicaklik": 15.4,
        "durum": {
          "kod": "cloudy",
          "ad": "Bulutlu",
          "simge": "cloud",
          "gece": false
        },
        "yagis_mm": 0.0,
        "ruzgar_kmh": 10.1,
        "uv": 0.0
      },
      {
        "zaman": "2026-11-02T03:00:00+03:00",
        "sicaklik": 15.6,
        "durum": {
          "kod": "cloudy",
          "ad": "Bulutlu",
          "simge": "cloud",
          "gece": false
        },
        "yagis_mm": 0.0,
        "ruzgar_kmh": 9.7,
        "uv": 0.0
      },
      "… 21 öğe daha"
    ],
    "gunluk": [
      {
        "tarih": "2026-11-02",
        "en_dusuk": 15.1,
        "en_yuksek": 19.1,
        "durum": {
          "kod": "fair_day",
          "ad": "Az bulutlu",
          "simge": "sun-cloud",
          "gece": false
        },
        "yagis_mm": 1.6,
        "uv_en_yuksek": {
          "deger": 2.9,
          "seviye": "Düşük"
        }
      },
      {
        "tarih": "2026-11-03",
        "en_dusuk": 14.6,
        "en_yuksek": 19.1,
        "durum": {
          "kod": "partlycloudy_day",
          "ad": "Parçalı bulutlu",
          "simge": "sun-cloud",
          "gece": false
        },
        "yagis_mm": 6.2,
        "uv_en_yuksek": {
          "deger": 2.7,
          "seviye": "Düşük"
        }
      },
      {
        "tarih": "2026-11-04",
        "en_dusuk": 13.2,
        "en_yuksek": 16.8,
        "durum": {
          "kod": "heavyrain",
          "ad": "Kuvvetli yağmurlu",
          "simge": "rain",
          "gece": false
        },
        "yagis_mm": 35.0,
        "uv_en_yuksek": {
          "deger": 2.6,
          "seviye": "Düşük"
        }
      },
      "… 4 öğe daha"
    ],
    "model_guncelleme": "2026-11-01T22:17:51+03:00"
  },
  "kaynak": [
    {
      "kod": "met",
      "ad": "MET Norway",
      "lisans": "CC BY 4.0 / NLOD 2.0",
      "atif": "Data from MET Norway",
      "url": "https://api.met.no/"
    }
  ],
  "guncelleme": "2026-11-02T01:06:10",
  "bayat": false
}

Uçlar ve parametreler

GET /v1/hava ücretsiz pakette 1 birim

Anlık hava, UV indeksi, 24 saatlik ve 7 günlük tahmin

ParametreTürAçıklama
konum metin Konum slug'ı (ör. duzce-akcakoca)
il metin İl adı, slug'ı ya da plaka kodu (ör. duzce, 81)
ilce metin İlçe adı (il ile birlikte)
enlem sayı Enlem (en yakın konum)
boylam sayı Boylam
GET /v1/hava/detay ücretli paket 2 birim

Ayrıntılı hava: hissedilen, çiy noktası, basınç, görüş, hamle; 16 gün

ParametreTürAçıklama
saat tam sayı varsayılan: 48
gun tam sayı varsayılan: 7
konum metin Konum slug'ı (ör. duzce-akcakoca)
il metin İl adı, slug'ı ya da plaka kodu (ör. duzce, 81)
ilce metin İlçe adı (il ile birlikte)
enlem sayı Enlem (en yakın konum)
boylam sayı Boylam
GET /v1/hava/yagis ücretli paket 2 birim

Yağış tahmini: 15 dakikalık ve saatlik, olasılık, kar

ParametreTürAçıklama
konum metin Konum slug'ı (ör. duzce-akcakoca)
il metin İl adı, slug'ı ya da plaka kodu (ör. duzce, 81)
ilce metin İlçe adı (il ile birlikte)
enlem sayı Enlem (en yakın konum)
boylam sayı Boylam

Konum alan uçlarda konum (slug), il + ilce (ad, slug ya da plaka) ya da enlem + boylam kullanılabilir. Tüm parametreler: OpenAPI belgesi.

Nerelerde kullanılır?

  • ✓Haber sitesinde hava durumu bandı
  • ✓Yerel portalda ilçe hava sayfası
  • ✓Tarım ve etkinlik planlama uygulamaları
  • ✓Mobil hava widget'ı

Kaynak ve lisans

  • MET Norway · CC BY 4.0 / NLOD 2.0 · kaynak
    Atıf: Data from MET Norway
  • Open-Meteo · CC BY 4.0; ticari kullanım izinli (11.2026) · kaynak
    Atıf: Hava verisi: Open-Meteo.com (CC BY 4.0)

Her yanıtın kaynak alanı bu bilgiyi taşır; veriyi gösterdiğiniz yerde atıf metnini yazın.

Sık sorulan sorular

Hava durumu API'si ücretsiz mi?

Evet; /v1/hava (anlık hava, UV, 24 saatlik ve 7 günlük tahmin) ücretsiz pakette açıktır ve hazır hava widget'ı vardır. Ayrıntılı 16 günlük tahmin ve 15 dakikalık yağış uçları Başlangıç ve üstü paketlerdedir (istek başına 2 birim).

Veri kaynağı ne?

Anlık hava ve 7 günlük tahmin MET Norway'den (CC BY 4.0), ayrıntılı tahmin ve yağış Open-Meteo'dan gelir; yanıttaki atıf metnini gösterdiğiniz yerde yazmanız gerekir.

Ne sıklıkla güncellenir?

Konumlar kaynağın yeni tahmin yayımlama sıklığına göre (genellikle saatte bir) yenilenir.

Koordinatla sorgulayabilir miyim?

Evet; enlem ve boylam verirseniz 60 km içindeki en yakın il/ilçe merkezi kullanılır.

Bu sayfa şu aramalar için de: hava durumu json · türkçe hava durumu api · ilçe hava durumu api · weather api türkiye · uv indeksi api