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.
/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
| Parametre | Tür | Açı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
| Parametre | Tür | Açı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
| Parametre | Tür | Açı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