Türkiye'nin il ve ilçe listesine JSON olarak ihtiyacınız varsa iki istek yeter: GET /v1/konumlar/iller 81 ili, GET /v1/konumlar/iller/{il}/ilceler seçilen ilin ilçelerini döndürür. İl, İlçe, Mahalle API toplam 81 il ve 973 ilçeyi (resmî sayıyla aynı) plaka kodu, URL'ye uygun ad (slug) ve enlem/boylam ile verir. İl ve ilçe uçları ücretsiz paket dahil her pakette açıktır.
Neden hazır bir liste yerine API?
GitHub'da paylaşılan il-ilçe JSON dosyaları işe yarar, ama çoğu zaman birkaç sorun çıkar: yeni kurulan ilçeler eksik kalır, yazımlar tutarsızdır (ör. "Eyyübiye" / "Eyyubiye"), koordinat yoktur ve dosyanın kaynağı belli değildir. API'deki liste tek bir kaynaktan, resmî ilçe sayısıyla (973) birebir tutar ve her il ile ilçenin koordinatını içerir. Aynı konum adları VeriApi.Pro'nun namaz, hava ve nöbetçi eczane uçlarında da kullanıldığı için listeyi bir kez alıp tüm verilerde aynı konumu kullanırsınız.
İlleri çekmek
curl -H "X-API-Key: va_ANAHTARINIZ" "https://api.veriapi.pro/v1/konumlar/iller"
{
"veri": [
{"id": 1, "tur": "il", "ad": "Adana", "il": "Adana", "plaka": 1, "slug": "adana", "enlem": 36.98636, "boylam": 35.32529},
{"id": 17, "tur": "il", "ad": "Adıyaman", "il": "Adıyaman", "plaka": 2, "slug": "adiyaman", "enlem": 37.76339, "boylam": 38.27714}
],
"kaynak": [{"kod": "veriapi", "ad": "VeriApi.Pro", "atif": "Veri: VeriApi.Pro"}]
}
(Örnekte iki il gösterilmiştir; yanıt 81 ilin tamamını içerir.)
Bir ilin ilçelerini çekmek
İl parametresi olarak ad, slug ya da plaka kodu kullanılabilir: duzce, Düzce ve 81 aynı sonucu verir.
curl -H "X-API-Key: va_ANAHTARINIZ" "https://api.veriapi.pro/v1/konumlar/iller/duzce/ilceler"
{
"veri": {
"il": {"ad": "Düzce", "plaka": 81, "slug": "duzce", "enlem": 40.84167, "boylam": 31.15833},
"ilceler": [
{"ad": "Akçakoca", "il": "Düzce", "plaka": 81, "slug": "duzce-akcakoca", "enlem": 41.08897, "boylam": 31.12497},
{"ad": "Çilimli", "il": "Düzce", "plaka": 81, "slug": "duzce-cilimli", "enlem": 40.89306, "boylam": 31.04667}
]
}
}
İlçe slug'ı (duzce-akcakoca) diğer uçlarda konum parametresi olarak kullanılabilir; örneğin /v1/namaz?konum=duzce-akcakoca.
Örnek: il seçince ilçeleri dolduran açılır liste
Kayıt ve adres formlarında en sık ihtiyaç bu. API anahtarı tarayıcıya yazılmamalı; bu yüzden küçük bir PHP dosyası istekleri sunucunuzdan yapar ve sonucu bir gün önbellekte tutar (il ve ilçe listesi neredeyse hiç değişmez).
konum.php
<?php
header('Content-Type: application/json; charset=utf-8');
$il = $_GET['il'] ?? '';
if ($il !== '' && !preg_match('/^[a-z0-9-]{2,40}$/', $il)) {
http_response_code(400);
exit('{"hata":"geçersiz il"}');
}
$yol = $il === '' ? '/v1/konumlar/iller' : '/v1/konumlar/iller/' . $il . '/ilceler';
$dosya = sys_get_temp_dir() . '/konum_' . ($il ?: 'iller') . '.json';
if (!is_file($dosya) || time() - filemtime($dosya) > 86400) {
$ch = curl_init('https://api.veriapi.pro' . $yol);
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_TIMEOUT => 10,
CURLOPT_HTTPHEADER => ['X-API-Key: ' . getenv('VERIAPI_KEY')],
]);
$yanit = curl_exec($ch);
if (curl_getinfo($ch, CURLINFO_HTTP_CODE) === 200) {
file_put_contents($dosya, $yanit);
}
curl_close($ch);
}
readfile($dosya);
Form ve JavaScript
<select id="il"><option value="">İl seçin</option></select>
<select id="ilce" disabled><option value="">Önce il seçin</option></select>
<script>
const ilKutusu = document.getElementById("il");
const ilceKutusu = document.getElementById("ilce");
function secenek(deger, metin) {
const o = document.createElement("option");
o.value = deger;
o.textContent = metin;
return o;
}
fetch("/konum.php")
.then((r) => r.json())
.then(({ veri }) => veri.forEach((il) => ilKutusu.append(secenek(il.slug, il.ad))));
ilKutusu.addEventListener("change", async () => {
ilceKutusu.replaceChildren(secenek("", "İlçe seçin"));
ilceKutusu.disabled = !ilKutusu.value;
if (!ilKutusu.value) return;
const { veri } = await (await fetch("/konum.php?il=" + encodeURIComponent(ilKutusu.value))).json();
veri.ilceler.forEach((ilce) => ilceKutusu.append(secenek(ilce.slug, ilce.ad)));
});
</script>
Bu yapıda ziyaretçi sayısından bağımsız olarak günde en fazla 82 istek yaparsınız (1 il listesi + 81 ilin ilçeleri); ücretsiz paketin günlük 500 birimi fazlasıyla yeter.
Koordinattan il ve ilçe bulmak
Mobil uygulamalarda kullanıcının konumundan il ve ilçeyi bulmak için /v1/konumlar/bul?enlem=40.84&boylam=31.16 isteği en yakın konumu (60 km içinde) döndürür. Aynı parametreler namaz ve hava uçlarında da çalışır.
Mahalle, köy ve posta kodu
İl ve ilçenin altındaki 45.000'den fazla mahalle ve köy için /v1/konumlar/ilceler/{ilce}/yerler ve /v1/konumlar/yerler/ara uçları ücretli paketlerde açıktır. Mahallelerin posta kodları için Posta Kodu API sayfasına bakın. Tüm parametreler dokümantasyonda.
Sık sorulan sorular
Türkiye'de kaç il ve ilçe var?
81 il ve 973 ilçe. API'deki liste bu resmî sayıyla birebir aynıdır.
İl ilçe listesi API'si ücretsiz mi?
Evet. /v1/konumlar/iller ve /v1/konumlar/iller/{il}/ilceler ücretsiz pakette de açıktır; her istek 1 birimdir ve ücretsiz pakette günde 500 birim hakkınız vardır.
Listede plaka kodu ve koordinat var mı?
Evet. Her il ve ilçede plaka kodu, URL'ye uygun ad (slug), enlem ve boylam bulunur. Koordinatlar il ve ilçe merkezini gösterir.
İl adını mı, plaka kodunu mu göndermeliyim?
İkisi de çalışır. il parametresine "Düzce", "duzce" ya da "81" yazabilirsiniz; ilçe için il ile birlikte ilçe adını ya da doğrudan ilçe slug'ını (duzce-akcakoca) kullanın.
Listeyi indirip kendi veritabanıma kaydedebilir miyim?
Evet. İl ve ilçe listesi nadiren değişir; bir kez çekip kendi veritabanınızda tutmanız ve ara sıra yenilemeniz en verimli yoldur.
#İl ilçe listesi#JSON#PHP#JavaScript#Form
Yazar
Kod8 Yazılım Kurucu Ortağı
Serkan Bayraklı 2002'den beri yazılım geliştiriyor. Kod8 Yazılım'ın kurucu ortağıdır ve VeriApi.Pro'yu geliştirir.
Verileri sitenize ekleyin
Döviz, namaz vakitleri, hava durumu, deprem ve daha fazlası; tek anahtar, Türkçe JSON. Ücretsiz paketle başlayın.