🇹🇷 Turkey Province Image & Data

Türkiye'nin en kapsamlı adres veri paketi! 81 il, 973 ilçe, 100+ mahalle ve 70+ sokak bilgisi. TypeScript desteği ile!

📊 Veri İstatistikleri

• 🇹🇷 81 İl - Tüm Türkiye
• 🏘️ 973 İlçe - Eksiksiz liste
• 🏠 600+ Mahalle - Büyük şehirler (İstanbul, Ankara, İzmir, Adana, Bursa, Antalya)
• 🛣️ 190+ Sokak/Cadde - Meşhur caddeler
• 🖼️ 81 İl Resmi - Görsel içerik

📦 Kurulum

npm install turkey_province_image

🚀 Kullanım

JavaScript

const turkeyData = require('turkey_province_image');

// Tüm illeri getir (81 il)
const cities = turkeyData.getAllCities();

// Tüm ilçeleri getir (973 ilçe)
const districts = turkeyData.getAllDistricts();

// İstanbul'un ilçelerini getir (39 ilçe)
const istanbulDistricts = turkeyData.getDistrictsByCity('34');

// Ankara Çankaya mahallelerini getir
const neighborhoods = turkeyData.getNeighborhoodsByDistrict('0607');

// İstanbul Beyoğlu sokaklarını getir
const streets = turkeyData.getStreetsByDistrict('3413');

TypeScript

import turkeyData, { City, District, Neighborhood, Street, Region } from 'turkey_province_image';

// Type-safe kullanım
const city: City | undefined = turkeyData.getCityByCode('34');
const districts: District[] = turkeyData.getDistrictsByCity('34');
const region: Region = 'Marmara';
const marmaraCities: City[] = turkeyData.getCitiesByRegion(region);

📊 Veri Yapısı

İller (Cities) - 81 Adet ✅

interface City {
  cityCode: string;        // "34"
  cityName: string;        // "İSTANBUL"
  plateCode: string;       // "34"
  region: Region;          // "Marmara"
  cityPic: string;         // "/pic/34.jpg"
  postalCode: string;      // "34000"
}

7 Coğrafi Bölge:

• 🌊 Marmara (11 il)
• 🏛️ Ege (8 il)
• ☀️ Akdeniz (8 il)
• 🌾 İç Anadolu (12 il)
• ⛰️ Karadeniz (19 il)
• 🏔️ Doğu Anadolu (14 il)
• 🌅 Güneydoğu Anadolu (9 il)

İlçeler (Districts) - 973 Adet ✅

interface District {
  cityCode: string;        // "34"
  cityName: string;        // "İSTANBUL"
  districtCode: string;    // "3420"
  districtName: string;    // "FATİH"
  postalCode: string;      // "34080"
}

Tüm iller için ilçeler mevcut:

• İstanbul: 39 ilçe
• Ankara: 25 ilçe
• İzmir: 30 ilçe
• Bursa: 17 ilçe
• Antalya: 19 ilçe
• ve diğer 76 il...

Mahalleler (Neighborhoods) - 600+ Adet

interface Neighborhood {
  cityCode: string;           // "34"
  cityName: string;           // "İSTANBUL"
  districtCode: string;       // "3420"
  districtName: string;       // "FATİH"
  neighborhoodCode: string;   // "342005"
  neighborhoodName: string;   // "BEYAZIT"
  postalCode: string;         // "34126"
}

Büyük şehirler için kapsamlı mahalle verileri:

• İstanbul: 200+ mahalle (Fatih, Kadıköy, Üsküdar, Beyoğlu, Beşiktaş vb.)
• Ankara: 130+ mahalle (Çankaya, Keçiören, Yenimahalle, Altındağ, Mamak)
• İzmir: 110+ mahalle (Konak, Karşıyaka, Bornova, Buca, Karabağlar)
• Adana: 40+ mahalle
• Bursa: 50+ mahalle
• Antalya: 50+ mahalle

Sokaklar (Streets) - 190+ Adet

interface Street {
  cityCode: string;           // "34"
  districtCode: string;       // "3413"
  neighborhoodCode: string;   // "341301"
  streetCode: string;         // "3413011"
  streetName: string;         // "İSTİKLAL CADDESİ"
}

Meşhur caddeler:

• İstanbul: İstiklal Caddesi, Bağdat Caddesi, Divanyolu (45 cadde)
• Ankara: Atatürk Bulvarı, Tunalı Hilmi, GMK Bulvarı (35 cadde)
• İzmir: Kordon, Kemeraltı, Anafartalar, Bağdat Caddesi (35 cadde)
• Adana: Atatürk Caddesi, Fevzipaşa Bulvarı (15 cadde)
• Bursa: Altıparmak Caddesi, Cumhuriyet Caddesi (15 cadde)
• Antalya: Atatürk Caddesi, Lara Sahil Yolu (15 cadde)
• Gaziantep, Kocaeli, Konya: Ana caddeler (30 cadde)

🔧 API Metodları (24 adet)

İl (City) Metodları

getAllCities(): City[]                          // Tüm illeri getir (81)
getCityByCode(code: string | number): City     // Plaka koduna göre
getCityByName(name: string): City              // İsme göre
getCitiesByRegion(region: Region): City[]      // Bölgeye göre
searchCities(query: string): City[]            // Arama yap

İlçe (District) Metodları

getAllDistricts(): District[]                        // Tüm ilçeleri getir (973)
getDistrictsByCity(cityCode: string): District[]     // İle göre ilçeler
getDistrictByCode(districtCode: string): District    // Kod ile getir
searchDistricts(query: string): District[]           // Arama yap

Mahalle (Neighborhood) Metodları

getAllNeighborhoods(): Neighborhood[]                             // Tüm mahalleler
getNeighborhoodsByCity(cityCode: string): Neighborhood[]          // İle göre
getNeighborhoodsByDistrict(districtCode: string): Neighborhood[] // İlçeye göre
getNeighborhoodByCode(neighborhoodCode: string): Neighborhood    // Kod ile
searchNeighborhoods(query: string): Neighborhood[]               // Arama

Sokak (Street) Metodları

getAllStreets(): Street[]                                // Tüm sokaklar
getStreetsByCity(cityCode: string): Street[]             // İle göre
getStreetsByDistrict(districtCode: string): Street[]     // İlçeye göre
getStreetsByNeighborhood(nhCode: string): Street[]       // Mahalleye göre
getStreetByCode(streetCode: string): Street              // Kod ile
searchStreets(query: string): Street[]                   // Arama

💡 Kullanım Örnekleri

Örnek 1: Tam Hiyerarşi

// İstanbul'un tüm verilerini al
const istanbul = turkeyData.getCityByCode('34');
const districts = turkeyData.getDistrictsByCity('34');
const neighborhoods = turkeyData.getNeighborhoodsByCity('34');
const streets = turkeyData.getStreetsByCity('34');

console.log(`${istanbul.cityName}:`);
console.log(`  ${districts.length} ilçe`);
console.log(`  ${neighborhoods.length} mahalle`);
console.log(`  ${streets.length} sokak`);

// Çıktı:
// İSTANBUL:
//   39 ilçe
//   49 mahalle
//   20 sokak

Örnek 2: Bölgesel İstatistik

// Marmara Bölgesi analizi
const marmaraCities = turkeyData.getCitiesByRegion('Marmara');
let totalDistricts = 0;

marmaraCities.forEach(city => {
  const districts = turkeyData.getDistrictsByCity(city.cityCode);
  totalDistricts += districts.length;
  console.log(`${city.cityName}: ${districts.length} ilçe`);
});

console.log(`\nMarmara Toplam: ${marmaraCities.length} il, ${totalDistricts} ilçe`);

Örnek 3: Arama ve Filtreleme

// "Merkez" geçen tüm ilçeleri bul
const merkezDistricts = turkeyData.searchDistricts('MERKEZ');
console.log(`${merkezDistricts.length} ilçe merkez olarak adlandırılıyor`);

// Atatürk geçen tüm sokakları bul
const ataturkStreets = turkeyData.searchStreets('ATATÜRK');
console.log(`${ataturkStreets.length} Atatürk caddesi/sokağı var`);

Örnek 4: Adres Doğrulama

function validateAddress(cityCode, districtCode, neighborhoodCode) {
  const city = turkeyData.getCityByCode(cityCode);
  if (!city) return { valid: false, error: 'İl bulunamadı' };
  
  const district = turkeyData.getDistrictByCode(districtCode);
  if (!district || district.cityCode !== cityCode) {
    return { valid: false, error: 'İlçe hatalı' };
  }
  
  const neighborhood = turkeyData.getNeighborhoodByCode(neighborhoodCode);
  if (!neighborhood || neighborhood.districtCode !== districtCode) {
    return { valid: false, error: 'Mahalle hatalı' };
  }
  
  return {
    valid: true,
    address: `${neighborhood.neighborhoodName}, ${district.districtName}, ${city.cityName}`
  };
}

const result = validateAddress('34', '3420', '342005');
console.log(result); // { valid: true, address: 'BEYAZIT, FATİH, İSTANBUL' }

📋 Özellikler

• ✅ 81 İl - Tüm Türkiye eksiksiz
• ✅ 973 İlçe - Resmi kaynaklara göre tam liste
• ✅ 600+ Mahalle - Büyük şehirler için kapsamlı
• ✅ 190+ Sokak - Meşhur caddeler ve bulvarlar
• ✅ TypeScript Desteği - Tam tip güvenliği
• ✅ 7 Coğrafi Bölge - Bölgesel filtreleme
• ✅ Detaylı Posta Kodları - İl, ilçe, mahalle bazında
• ✅ İl Görselleri - 81 adet resim
• ✅ Gelişmiş Arama - Tüm seviyelerde
• ✅ Hiyerarşik Veri - İl → İlçe → Mahalle → Sokak

📝 Güncellemeler

v3.2.0 (2025-12-15) - MAHALLE VE SOKAK GENİŞLETMESİ 🎉

• ✨ 600+ MAHALLE - Büyük şehirler için kapsamlı mahalle verileri
  • İstanbul: 200+ mahalle (11 ilçe)
  • Ankara: 130+ mahalle (6 ilçe)
  • İzmir: 110+ mahalle (5 ilçe)
  • Adana, Bursa, Antalya: 40-50 mahalle
• ✨ 190+ SOKAK/CADDE - Meşhur caddeler genişletildi
  • İstanbul: 45 cadde (Beyoğlu, Fatih, Kadıköy)
  • Ankara: 35 cadde (Çankaya, Keçiören, Yenimahalle)
  • İzmir: 35 cadde (Konak, Karşıyaka, Bornova)
  • Diğer büyük şehirler: 75 cadde
• 📚 Dokümantasyon güncellendi

v3.1.0 (2025-12-15) - BÜYÜK GÜNCELLEME

• ✨ 973 İLÇE EKLENDİ - Türkiye'nin tüm ilçeleri
• ✨ Mahalle ve sokak verileri eklendi

v3.0.0 (2025-12-15)

• ✨ TypeScript desteği eklendi
• ✨ İlk mahalle ve sokak verileri

v2.0.0 (2025-12-15)

• ✨ Coğrafi bölge bilgisi
• 🐛 İl isimleri düzeltildi

v1.0.0

• İlk sürüm: 81 il

🗂️ Veri Kaynakları

• T.C. İçişleri Bakanlığı
• Nüfus ve Vatandaşlık İşleri Genel Müdürlüğü
• PTT Posta Kodları
• Wikipedia - Türkiye'nin İlçeleri

🤝 Katkıda Bulunma

Katkıda bulunmak için CONTRIBUTING.md dosyasını inceleyebilirsiniz.

İhtiyaç duyulan katkılar:

• Tüm mahallelerin eklenmesi (50,000+ mahalle)
• Sokak verilerinin genişletilmesi
• Koordinat bilgileri (latitude/longitude)
• Nüfus ve demografik veriler

📄 Lisans

ISC

👤 Yazar

Halil Ertekin

• GitHub: @halilertekin

🐛 Sorun Bildirme

GitHub Issues

⭐ Destek

Projeyi beğendiyseniz yıldız vermeyi unutmayın!

Made with ❤️ in Turkey 🇹🇷

📦 Kurulum

npm install turkey_province_image

🚀 Kullanım

JavaScript

const turkeyData = require('turkey_province_image');

// Tüm illeri getir
const cities = turkeyData.getAllCities();
console.log(cities.length); // 81

// İl bilgisi getir
const istanbul = turkeyData.getCityByCode('34');
console.log(istanbul.cityName); // İSTANBUL

// İstanbul'un ilçelerini getir
const districts = turkeyData.getDistrictsByCity('34');
console.log(districts.length); // 39

// Çankaya'nın mahallelerini getir
const neighborhoods = turkeyData.getNeighborhoodsByDistrict('0607');
console.log(neighborhoods);

// Arama yap
const searchResults = turkeyData.searchCities('ANKARA');
console.log(searchResults);

TypeScript

import turkeyData, { City, District, Neighborhood, Street, Region } from 'turkey_province_image';

// Type-safe kullanım
const city: City | undefined = turkeyData.getCityByCode('34');
const districts: District[] = turkeyData.getDistrictsByCity('34');
const region: Region = 'Marmara';
const marmaraCities: City[] = turkeyData.getCitiesByRegion(region);

📊 Veri Yapısı

İller (Cities) - 81 Adet

interface City {
  cityCode: string;        // "34"
  cityName: string;        // "İSTANBUL"
  plateCode: string;       // "34"
  region: Region;          // "Marmara"
  cityPic: string;         // "/pic/34.jpg"
  postalCode: string;      // "34000"
}

7 Coğrafi Bölge:

• Marmara (11 il)
• Ege (8 il)
• Akdeniz (8 il)
• İç Anadolu (12 il)
• Karadeniz (19 il)
• Doğu Anadolu (14 il)
• Güneydoğu Anadolu (9 il)

İlçeler (Districts) - 100+ Adet

interface District {
  cityCode: string;        // "34"
  cityName: string;        // "İSTANBUL"
  districtCode: string;    // "3420"
  districtName: string;    // "FATİH"
  postalCode: string;      // "34080"
}

Kapsam: İstanbul (39), İzmir (30), Ankara (25), Adana (15)

Mahalleler (Neighborhoods) - 40+ Adet

interface Neighborhood {
  cityCode: string;           // "34"
  cityName: string;           // "İSTANBUL"
  districtCode: string;       // "3420"
  districtName: string;       // "FATİH"
  neighborhoodCode: string;   // "342005"
  neighborhoodName: string;   // "BEYAZIT"
  postalCode: string;         // "34126"
}

Sokaklar (Streets) - 20+ Adet

interface Street {
  cityCode: string;           // "34"
  districtCode: string;       // "3413"
  neighborhoodCode: string;   // "341301"
  streetCode: string;         // "3413011"
  streetName: string;         // "İSTİKLAL CADDESI"
}

🔧 API Metodları

İl (City) Metodları

// Tüm illeri getir
getAllCities(): City[]

// Plaka koduna göre il getir
getCityByCode(code: string | number): City | undefined

// İsme göre il getir (büyük/küçük harf duyarsız)
getCityByName(name: string): City | undefined

// Bölgeye göre illeri getir
getCitiesByRegion(region: Region): City[]

// İl araması yap
searchCities(query: string): City[]

İlçe (District) Metodları

// Tüm ilçeleri getir
getAllDistricts(): District[]

// İl koduna göre ilçeleri getir
getDistrictsByCity(cityCode: string | number): District[]

// İlçe koduna göre ilçe getir
getDistrictByCode(districtCode: string): District | undefined

// İlçe araması yap
searchDistricts(query: string): District[]

Mahalle (Neighborhood) Metodları

// Tüm mahalleleri getir
getAllNeighborhoods(): Neighborhood[]

// İl koduna göre mahalleleri getir
getNeighborhoodsByCity(cityCode: string | number): Neighborhood[]

// İlçe koduna göre mahalleleri getir
getNeighborhoodsByDistrict(districtCode: string): Neighborhood[]

// Mahalle koduna göre mahalle getir
getNeighborhoodByCode(neighborhoodCode: string): Neighborhood | undefined

// Mahalle araması yap
searchNeighborhoods(query: string): Neighborhood[]

Sokak (Street) Metodları

// Tüm sokakları getir
getAllStreets(): Street[]

// İl koduna göre sokakları getir
getStreetsByCity(cityCode: string | number): Street[]

// İlçe koduna göre sokakları getir
getStreetsByDistrict(districtCode: string): Street[]

// Mahalle koduna göre sokakları getir
getStreetsByNeighborhood(neighborhoodCode: string): Street[]

// Sokak koduna göre sokak getir
getStreetByCode(streetCode: string): Street | undefined

// Sokak araması yap
searchStreets(query: string): Street[]

💡 Kullanım Örnekleri

Örnek 1: Bölgesel İstatistik

const marmaraCities = turkeyData.getCitiesByRegion('Marmara');
console.log(`Marmara Bölgesi: ${marmaraCities.length} il`);
marmaraCities.forEach(city => {
  console.log(`- ${city.cityName} (${city.plateCode})`);
});

Örnek 2: Hiyerarşik Veri

// İstanbul'un tüm verilerini al
const istanbul = turkeyData.getCityByCode('34');
const districts = turkeyData.getDistrictsByCity('34');
const neighborhoods = turkeyData.getNeighborhoodsByCity('34');
const streets = turkeyData.getStreetsByCity('34');

console.log(`${istanbul.cityName}:`);
console.log(`  ${districts.length} ilçe`);
console.log(`  ${neighborhoods.length} mahalle`);
console.log(`  ${streets.length} sokak`);

Örnek 3: Arama ve Filtreleme

// "Çankaya" geçen tüm ilçeleri bul
const cankayaDistricts = turkeyData.searchDistricts('ÇANKAYA');

// Atatürk geçen tüm sokakları bul
const ataturkStreets = turkeyData.searchStreets('ATATÜRK');

// Ankara'daki Çankaya ilçesinin mahallelerini getir
const ankara = turkeyData.getCityByName('ANKARA');
const cankaya = turkeyData.getDistrictsByCity(ankara.cityCode)
  .find(d => d.districtName === 'ÇANKAYA');
const neighborhoods = turkeyData.getNeighborhoodsByDistrict(cankaya.districtCode);

🖼️ Resimler

Her ilin pic/ klasöründe 01.jpg - 81.jpg formatında görseli bulunmaktadır.

const ankara = turkeyData.getCityByCode('6');
console.log(ankara.cityPic); // /pic/06.jpg

📋 Özellikler

• ✅ Türkiye'nin 81 ilinin tam listesi
• ✅ 100+ ilçe (İstanbul, Ankara, İzmir, Adana vb.)
• ✅ 40+ mahalle (örnek veriler)
• ✅ 20+ sokak (örnek veriler)
• ✅ Plaka kodları ve il kodları
• ✅ Her ilin coğrafi bölgesi (7 bölge)
• ✅ Detaylı posta kodları (il, ilçe, mahalle bazında)
• ✅ İl görselleri (81 adet)
• ✅ TypeScript desteği (type definitions dahil)
• ✅ Kolay arama ve filtreleme fonksiyonları
• ✅ Hiyerarşik veri yapısı (il → ilçe → mahalle → sokak)

📝 Güncellemeler

v3.0.0 (2025-12-15)

• ✨ TypeScript desteği eklendi (index.d.ts)
• ✨ Mahalle verileri eklendi (40+ mahalle)
• ✨ Sokak verileri eklendi (20+ sokak)
• ✨ İlçe sayısı genişletildi (100+ ilçe: İstanbul 39, İzmir 30, Ankara 25)
• ✨ Yeni API metodları: getCitiesByRegion, searchCities, searchDistricts, vb.
• ✨ Bölge bazlı filtreleme
• ✨ Kapsamlı arama fonksiyonları
• 📚 README tamamen yenilendi

v2.0.0 (2025-12-15)

• ✨ Coğrafi bölge bilgisi eklendi
• ✨ Posta kodu bilgisi eklendi
• ✨ İlçe verileri eklendi
• 🐛 İl ismi yazım hataları düzeltildi

v1.0.0

• İlk sürüm: 81 il kodu ve resimleri

🤝 Katkıda Bulunma

Projeye katkıda bulunmak isterseniz CONTRIBUTING.md dosyasını inceleyebilirsiniz.

Özellikle şu alanlarda katkı beklenmektedir:

• Diğer illerin ilçe bilgilerinin tamamlanması (750+ ilçe)
• Tüm mahallelerin eklenmesi (50,000+ mahalle)
• Sokak verilerinin genişletilmesi
• Test coverage artırılması
• Örnek uygulamalar (React, Vue, Angular)

📄 Lisans

ISC

👤 Yazar

Halil Ertekin

• GitHub: @halilertekin

🐛 Sorun Bildirme

GitHub Issues

⭐ Destek

Projeyi beğendiyseniz yıldız vermeyi unutmayın!

📚 Kaynaklar

• Türkiye İller Listesi
• PTT Posta Kodları

Made with ❤️ in Turkey 🇹🇷