Hava Kalitesi API

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-kalitesi?il=istanbul');
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-kalitesi?il=istanbul", {
  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-kalitesi?il=istanbul",
                 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-kalitesi?il=istanbul"

Örnek yanıt

GET https://api.veriapi.pro/v1/hava-kalitesi?il=istanbul — gerçek veriyle; listeler kısaltıldı.

{
  "veri": {
    "konum": {
      "id": 454,
      "tur": "il",
      "ad": "İstanbul",
      "il": "İstanbul",
      "plaka": 34,
      "slug": "istanbul",
      "enlem": 41.01,
      "boylam": 28.96028
    },
    "rakim": 55.0,
    "model_enlem": 41.0,
    "model_boylam": 29.0,
    "anlik": {
      "zaman": "2026-11-02T01:00",
      "avrupa_indeksi": 43,
      "abd_indeksi": 71,
      "pm2_5": 19.9,
      "pm10": 28.5,
      "no2": 20.7,
      "o3": 43.0,
      "so2": 7.0,
      "co": 234.0,
      "toz": 1.0,
      "uv": 0.0,
      "avrupa_seviye": {
        "kod": "orta",
        "ad": "Orta"
      },
      "abd_seviye": {
        "kod": "orta",
        "ad": "Orta"
      }
    },
    "saatlik": [
      {
        "zaman": "2026-11-02T01:00",
        "avrupa_indeksi": 43,
        "abd_indeksi": 71,
        "pm2_5": 19.9,
        "pm10": 28.5,
        "no2": 20.7,
        "o3": 43.0,
        "so2": 7.0,
        "co": 234.0,
        "toz": 1.0,
        "uv": 0.0,
        "avrupa_seviye": {
          "kod": "orta",
          "ad": "Orta"
        }
      },
      {
        "zaman": "2026-11-02T02:00",
        "avrupa_indeksi": 40,
        "abd_indeksi": 72,
        "pm2_5": 15.6,
        "pm10": 24.0,
        "no2": 19.7,
        "o3": 43.0,
        "so2": 6.3,
        "co": 210.0,
        "toz": 1.0,
        "uv": 0.0,
        "avrupa_seviye": {
          "kod": "makul",
          "ad": "Makul"
        }
      },
      {
        "zaman": "2026-11-02T03:00",
        "avrupa_indeksi": 37,
        "abd_indeksi": 72,
        "pm2_5": 13.5,
        "pm10": 20.6,
        "no2": 18.2,
        "o3": 45.0,
        "so2": 5.9,
        "co": 209.0,
        "toz": 1.0,
        "uv": 0.0,
        "avrupa_seviye": {
          "kod": "makul",
          "ad": "Makul"
        }
      },
      "… 21 öğe daha"
    ],
    "gunluk": [
      {
        "tarih": "2026-11-02",
        "avrupa_en_yuksek": 83,
        "pm2_5_ort": 35.4,
        "pm10_ort": 47.6,
        "avrupa_seviye": {
          "kod": "cok_kotu",
          "ad": "Çok kötü"
        }
      },
      {
        "tarih": "2026-11-03",
        "avrupa_en_yuksek": 71,
        "pm2_5_ort": 42.3,
        "pm10_ort": 53.3,
        "avrupa_seviye": {
          "kod": "kotu",
          "ad": "Kötü"
        }
      },
      {
        "tarih": "2026-11-04",
        "avrupa_en_yuksek": 60,
        "pm2_5_ort": 22.8,
        "pm10_ort": 29.3,
        "avrupa_seviye": {
          "kod": "orta",
          "ad": "Orta"
        }
      }
    ],
    "birimler": {
      "pm2_5": "µg/m³",
      "pm10": "µg/m³",
      "no2": "µg/m³",
      "o3": "µg/m³",
      "so2": "µg/m³",
      "co": "µg/m³",
      "toz": "µg/m³"
    },
    "not": "Model tahminidir (CAMS); ölçüm istasyonu değeri değildir."
  },
  "kaynak": [
    {
      "kod": "open_meteo",
      "ad": "Open-Meteo",
      "lisans": "CC BY 4.0; ticari kullanım izinli (11.2026)",
      "atif": "Hava verisi: Open-Meteo.com (CC BY 4.0)",
      "url": "https://open-meteo.com/"
    },
    {
      "kod": "cams",
      "ad": "Copernicus Atmosphere Monitoring Service (CAMS)",
      "lisans": "Copernicus lisansı (atıf ile serbest)",
      "atif": "Generated using Copernicus Atmosphere Monitoring Service Information",
      "url": "https://atmosphere.copernicus.eu/"
    }
  ],
  "guncelleme": "2026-11-02T01:15:14",
  "bayat": false
}

Uçlar ve parametreler

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 kalitesi uyarısı
• ✓Sağlık ve spor uygulamaları
• ✓Belediye ve çevre portalları

Kaynak ve lisans

• Open-Meteo · CC BY 4.0; ticari kullanım izinli (11.2026) · kaynak
  Atıf: Hava verisi: Open-Meteo.com (CC BY 4.0)
• Copernicus Atmosphere Monitoring Service (CAMS) · Copernicus lisansı (atıf ile serbest) · kaynak
  Atıf: Generated using Copernicus Atmosphere Monitoring Service Information

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

Sık sorulan sorular