# Türkiye il ve ilçe konumları

Bu statik veri kümesi hava durumu planlayıcısının il ve ilçe seçimi içindir.
81 il ve 973 ilçeyi kapsar. Tarayıcı yalnızca `/data/turkey-locations.json`
dosyasını yükler; kullanıcı seçimi için üçüncü taraf coğrafi kodlama isteği yapılmaz.

## Şema

Üst nesne: `version`, `generatedOn`, `source`, `provinces`.

Her il: `id`, `name`, `lat`, `lon`, `osmId`, `districts`.
Her ilçe: `id`, `name`, `lat`, `lon`, `osmId`.

- İl `id` değeri sayısal plaka kodudur (1–81).
- İlçe `id` değeri TurkiyeAPI'nin sayısal ilçe kimliğidir; ülke genelinde benzersizdir.
- Koordinatlar WGS84 ondalık derecedir; `lat` enlem, `lon` boylamdır.
- `osmId`, koordinatın kaynak OSM ilişkisidir; her kayıt için izlenebilirlik sağlar.
- Türkçe adlar TurkiyeAPI'den aynen alınır. `Merkez` ilçesi kendi ilinin altında yer alır.

## Kaynaklar ve lisans

Koordinatlar **© OpenStreetMap katkıcıları**, **ODbL 1.0** kapsamında sunulur.
Kullanılan işlenmiş kaynak:

- [osadikoglu/turkey-admin-units-osm, osm-2026-09-13 sürümü](https://github.com/osadikoglu/turkey-admin-units-osm/releases/tag/osm-2026-09-13)
- Geofabrik Türkiye veri anı: `2026-09-13T20:21:20Z`.
- [OpenStreetMap atıf ve telif bilgileri](https://www.openstreetmap.org/copyright)
- Tam lisans: [turkey-locations.ODbL-1.0.txt](./turkey-locations.ODbL-1.0.txt).

İdari adlar ve kimlikler **TurkiyeAPI**, Copyright (c) 2022-2026 Ubeyde Emir
Özdemir, **MIT** lisanslı 2025 veri setinden alınmıştır:

- [Kaynak depo, sabit commit](https://github.com/ubeydeozdmr/turkiye-api/tree/a0ad8351cb52153e7a92aa7ba9a5bc1e3294da8d)
- Tam lisans: [turkey-locations.TurkiyeAPI-MIT.txt](./turkey-locations.TurkiyeAPI-MIT.txt).

Bu birleştirilmiş/türetilmiş konum veritabanı ODbL 1.0 kapsamında sunulur.
Serbestçe indirilebilir kopyası: [turkey-locations.json](./turkey-locations.json).
Bu lisans, konum veritabanına uygulanır; sitenin diğer yazılım ve içeriklerine
bu belgeyle bir lisans verilmez. Yukarıdaki kaynak atıfları korunmalıdır.

Arayüzde gösterilecek kısa atıf:

> Konumlar: © OpenStreetMap katkıcıları (ODbL 1.0) · TurkiyeAPI (MIT)

Atıftan bu belgeye veya ilgili lisans/kaynaklara bağlantı verin.

## Konum hassasiyeti

OSM kaynak üreticisi noktayı sırasıyla `admin_centre` üyesinden, `label`
üyesinden veya il/ilçe poligonunun ağırlık merkezinden seçer. Kaynak CSV,
kayıt bazında hangi dalın kullanıldığını saklamaz. Dolayısıyla `pointType`
üst kaynak bilgisinde `admin_centre-or-label-or-centroid` olarak belirtilir;
bir ilçenin tam belediye binası koordinatı veya doğrulanmış tesis noktası
olduğu iddia edilmez.

Hiçbir eksik ilçe koordinatı il merkeziyle doldurulmamıştır. 973 ilçenin
tamamı, kendi ilçe OSM ilişkisinden gelen enlem/boylamı kullanır. Bazı merkez
ilçeler ve iller doğal olarak aynı veya yakın temsil noktasına sahip olabilir.
Seçilen ilçeye göre hava durumu yaklaşık bir coğrafi noktayı temsil eder;
tesisin rakımı, mikroiklimi ve gerçek konumu farklı olabilir.

Arayüz için uygun açıklama:

> Seçilen ilçe için yaklaşık konum; tesisinizdeki koşullar farklı olabilir.

Bu veri resmî bir idari sınır veya ölçme/kadastro hizmeti değildir.

## Yapılan dönüşüm ve doğrulama

1. TurkiyeAPI adları/kimlikleri OSM il ve ilçe kayıtlarıyla ebeveyn il ve
   Türkçe-normalize ad üzerinden bire bir eşleştirilir.
2. OSM'nin `<İl adı> Merkez` adlandırması, TurkiyeAPI `Merkez` kaydıyla eşleştirilir.
3. Gereksiz nüfus, mahalle, köy ve posta kodu alanları çıkarılır.
4. Koordinat metinleri sayıya çevrilir; kaynak hassasiyeti değiştirilmez.
5. Kaynak CSV'nin yayımlanmış SHA-256 özeti, 81/973 kapsamı, benzersiz
   kimlikler, her ilin ilçe sayısı ve coğrafi aralıklar doğrulanır.

Eşleşme veya koordinat eksikse içe aktarma hata verir; tahmin, elle uydurma
veya il koordinatına sessiz geri dönüş uygulanmaz.

Yeniden üretme (yalnızca geliştirme sırasında ağ erişimi gerektirir):

`node scripts/import-turkey-locations.mjs`

Yerel veri doğrulaması (ağ erişimi gerektirmez):

`node scripts/import-turkey-locations.mjs --check`

`node --test tests/turkey-locations.test.mjs`