İçeriğe geç
SanaterServisBelgeler
Ücretsiz hesap

Hava durumu

Başlangıç ve kimlik doğrulamaŞehirlerNamaz vakitleriFinansHava durumuPuan durumuFikstürDünya yerleşim verisiGeçmiş ve arşiv

81 il için anlık ölçüm ve dört günlük tahmin; ikon kodu ve durum metniyle.

Erişimanahtar gerekliküme adı: hava
Uç noktalar3aşağıda tek tek açıklanır
KaynakOpen-Meteo
TazelemeSaatte bir81 il tek istekte

Anlık değerler hava nesnesinde, dört günlük tahmin hava.gunler dizisindedir; ilk gün bugündür.

Her iki yerde de durum hazır Türkçe metin, ikon ise kendi görsellerinizi eşlemeniz için sayısal koddur. Gece/gündüz ayrımı ikon kodunda (33/34) ve ayrıca gunduz alanında bulunur.

Uç noktalar

GET/v1/hava
81 ilin tamamı; iller nesnesi plakaya göre anahtarlanır.
GET/v1/hava/{il}
Tek il: anlık ölçüm + dört günlük tahmin.
GET/v1/hava/{il}/gecmis
Arşivden saatlik geçmiş ölçümler.

Parametreler

ParametreYerAçıklama
{il}yolPlaka ya da slug.
gunsorguYalnız /gecmis ucunda: kaç günlük geçmiş. Varsayılan 7, en çok 365.

Alanlar

hava (anlık)

AlanTipAçıklama
sicaklikfloatSıcaklık, °C.
hissedilenfloatHissedilen sıcaklık, °C.
nemintBağıl nem, %.
ruzgar_kmhfloatRüzgâr hızı, km/sa.
ruzgar_yonintRüzgârın geldiği yön, derece (0 = kuzey, 90 = doğu).
yagis_mmfloatSon saatteki yağış, mm.
gorus_kmfloatGörüş mesafesi, km.
gunduzboolÖlçüm anı gündüz müydü.
durumstringTürkçe durum metni (ör. Az bulutlu).
ikonintİkon kodu; aşağıdaki tabloya bakın.
olcumstringÖlçümün ait olduğu saat, YYYY-AA-GGTSS:DD.
gunlerdiziDört günlük tahmin.

hava.gunler[] (tahmin)

AlanTipAçıklama
tarihstringGün, YYYY-AA-GG. İlk öğe bugündür.
en_dusukfloatGünün en düşük sıcaklığı, °C.
en_yuksekfloatGünün en yüksek sıcaklığı, °C.
yagis_olasiligiintYağış olasılığı, %.
durumstringGünün baskın durumu, Türkçe.
ikonintGünün ikon kodu (gündüz kodu).

gecmis · olcumler[]

AlanTipAçıklama
zamanstringKaydın alındığı an.
sicaklik / hissedilenfloat°C.
nemint%.
ruzgar_kmhfloatkm/sa.
durum / ikonstring / intO andaki durum metni ve kodu.

Örnek yanıt

Örnek yanıt · /v1/hava/konya
{
  "ok": true,
  "kume": "hava",
  "kaynak": "open-meteo",
  "guncelleme": "2026-09-30T16:55:02+03:00",
  "yas_sn": 2728,
  "bayat": false,
  "il": { "id": 42, "ad": "Konya", "slug": "konya",
          "enlem": 37.87, "boylam": 32.48 },
  "hava": {
    "sicaklik": 19.3, "hissedilen": 16.7, "nem": 51,
    "ruzgar_kmh": 16, "ruzgar_yon": 31, "yagis_mm": 0,
    "gorus_km": 41.2, "gunduz": true,
    "durum": "Az bulutlu", "ikon": 2,
    "olcum": "2026-09-30T16:45",
    "gunler": [
      { "tarih": "2026-09-30", "en_dusuk": 9.6, "en_yuksek": 19.7,
        "yagis_olasiligi": 8, "durum": "Çok bulutlu", "ikon": 4 },
      … 4 gün
    ]
  }
}

Kullanım

curl
curl -H "X-Api-Key: ss_…" \
  https://api.sanater.com/v1/hava/konya
JavaScript · kart
const { il, hava } = await (await fetch(
  'https://api.sanater.com/v1/hava/42',
  { headers: { 'X-Api-Key': 'ss_…' } })).json();

baslik.textContent = il.ad;
derece.textContent = `${Math.round(hava.sicaklik)}°`;
durum.textContent  = hava.durum;
ikon.src = `/ikon/${hava.ikon}.svg`;
yarin.textContent = `Yarın ${hava.gunler[1].en_dusuk}° / ${hava.gunler[1].en_yuksek}°`;

Bilinmesi gerekenler

← Tüm belgelerÜcretsiz anahtar alın