TR GeoJSON Builder

Türkiye ilçelerinin coğrafi koordinatlarını (enlem/boylam) OpenStreetMap API'lerinden alarak JSON ve CSV formatında çıktı üreten araç.

Özellikler

• Overpass API ve Nominatim API kullanarak geocoding
• Önbellek sistemi ile tekrar eden istekleri önler
• JSON ve CSV formatında çıktı
• Rate limiting ile API limitlerini aşmaz
• CLI arayüzü ile kolay kullanım

Kurulum

git clone https://github.com/cengelstudio/tr-geojson-builder.git
cd tr-geojson-builder

Node.js 18+ gerekli.

Kullanım

Hızlı Başlangıç

npm start

CLI ile Özel Parametreler

# Giriş ve çıkış dosyalarını belirt
./bin/tr-geocode.mjs -i data/districts.json -o dist/districts

# Önbellek dosyasını değiştir
./bin/tr-geocode.mjs -i data/districts.json -o dist/districts --cache .cache/my_cache.json

# Rate limiting ayarları
./bin/tr-geocode.mjs --rateMin 1000 --rateMax 2000

Çıktı Formatları

JSON Çıktısı

{
  "ilce_id": "3442",
  "ilce_adi": "KADIKÖY",
  "sehir_id": "34",
  "sehir_adi": "İSTANBUL",
  "lat": 40.9912955,
  "lon": 29.0245631,
  "via": "nominatim",
  "osm_type": "relation",
  "osm_id": 1276548,
  "display_name": "Kadıköy, İstanbul, Marmara Bölgesi, Türkiye"
}

CSV Çıktısı

ilce_id,ilce_adi,sehir_id,sehir_adi,lat,lon,via,osm_type,osm_id,display_name
3442,KADIKÖY,34,İSTANBUL,40.9912955,29.0245631,nominatim,relation,1276548,"Kadıköy, İstanbul, Marmara Bölgesi, Türkiye"

Dosya Yapısı

├── data/districts.json     # Giriş: İlçe listesi
├── dist/                   # Çıktı: JSON ve CSV dosyaları
├── .cache/                 # Önbellek: Geocoding sonuçları
└── src/                    # Kaynak kodlar