🇹🇷 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

``bash
npm install turkey_province_image
`

🚀 Kullanım

$3

`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');
`

$3

`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ı

$3

`typescript
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)

$3

`typescript
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...

$3

`typescript
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

$3

`typescript
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)

$3

`typescript
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
`

$3

`typescript
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
`

$3

`typescript
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
`

$3

`typescript
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

$3

`javascript
// İ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
`

$3

`javascript
// 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);
`

$3

`javascript
// "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);
`

$3

`javascript
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

$3

- ✨ 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

$3

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

$3

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

$3

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

$3

- İ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

`bash
npm install turkey_province_image
`

🚀 Kullanım

$3

`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);
`

$3

`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ı

$3

`typescript
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)

$3

`typescript
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)

$3

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

$3

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

🔧 API Metodları

$3

`typescript
// 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[]
`

$3

`typescript
// 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[]
`

$3

`typescript
// 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[]
`

$3

`typescript
// 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

$3

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

$3

`javascript
// İ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);
`

$3

`javascript
// "Ç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.

`javascript
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

$3


- ✨ 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

$3

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

$3

- İ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 🇹🇷