İçeriğe geç
SanaterServisBelgeler
Ücretsiz hesap

Dünya yerleşim verisi

Başlangıç ve kimlik doğrulamaŞehirlerNamaz vakitleriFinansHava durumuPuan durumuFikstürDünya yerleşim verisiGeçmiş ve arşiv

Ülke → il/eyalet → ilçe; ad, slug, GeoNames kimliği ve Türkiye'de plaka.

Erişimanahtar gerekliküme adı: yerler
Uç noktalar5aşağıda tek tek açıklanır
KaynakGeoNames (CC BY 4.0)
TazelemeAyda birstatik veri

Adres formu, ülke/şehir seçici ya da coğrafi etiketleme için üç düzeyli yerleşim listesi. Ülke iki harfli kod, üç harfli kod ya da slug ile çağrılır — tr, tur ve turkiye aynı ülkeyi verir. İl için kod, slug ya da Türkiye'de plaka kullanılabilir.

Türkiye illerindeki plaka alanı şehirler, namaz ve hava uçlarıyla birebir eşleşir; aynı ili iki serviste ortak anahtarla birleştirebilirsiniz.

Uç noktalar

GET/v1/yerler
Küme özeti: ülke sayısı, güncelleme damgası, alt uçların listesi.
GET/v1/yerler/ulkeler
Tüm ülkeler tek yanıtta.
GET/v1/yerler/{ulke}
Ülkenin illeri/eyaletleri, ada göre sıralı.
GET/v1/yerler/{ulke}/{il}
İlin ilçeleri.
GET/v1/yerler/ara
Ad araması.

Parametreler

ParametreYerAçıklama
{ulke}yolÜlke kodu (tr), üç harfli kod (tur) ya da slug (turkiye). Büyük/küçük harf ve Türkçe harf duyarsızdır.
{il}yolİl kodu (71), slug (konya) ya da Türkiye'de plaka (42).
qsorguArama ucunda: en az iki harf. Kısa sorgu 400 döner.
ulkesorguArama ucunda: aramayı bu ülkenin il ve ilçelerine de yayar. Verilmezse yalnız ülke adları taranır.

Alanlar

ulkeler[] öğesi

AlanTipAçıklama
kodstringISO 3166-1 alfa-2 (TR).
kod3stringISO 3166-1 alfa-3 (TUR).
adstringTürkçe ülke adı.
ad_enstringİngilizce ülke adı.
slugstringTürkçe adın ASCII karşılığı; yol parçası olarak kullanılabilir.
baskentstring|nullBaşkent adı (İngilizce).
kitastring|nullKıta kodu: AS, EU, AF, NA, SA, OC, AN.
para_birimistring|nullISO 4217 kodu (TRY).
telefon_kodustring|nullUluslararası arama kodu (+90).
yuzolcumu_km2int|nullYüzölçümü, km².
nufusint|nullNüfus (GeoNames anlık görüntüsü).
dillerdiziDil/yerel kodları (["tr-TR","ku",…]).
il_sayisi / ilce_sayisiintBu veri kümesindeki il ve ilçe sayısı.

iller[] öğesi

AlanTipAçıklama
kodstringGeoNames admin1 kodu; ülke içinde benzersizdir. Plaka değildir.
adstringİl/eyalet adı.
slugstringAdın ASCII karşılığı.
geoname_idintGeoNames kimliği.
ilce_sayisiintBu ilin ilçe sayısı.
plakaint|nullYalnız Türkiye: 1–81 plaka. Öteki ülkelerde bu alan bulunmaz.

ilceler[] öğesi

AlanTipAçıklama
kodstringGeoNames admin2 kodu.
adstringİlçe adı.
slugstringAdın ASCII karşılığı.
geoname_idintGeoNames kimliği.

Arama yanıtı

AlanTipAçıklama
sorgustringAranan metin.
ulke_kapsamistring|null?ulke= verildiyse ülke kodu.
notstring|nullÜlke verilmediğinde il/ilçe aranmadığını söyleyen uyarı.
sonuc.ulke / sonuc.il / sonuc.ilcediziÜç düzeyin eşleşmeleri, her biri en çok 25 kayıt. İl ve ilçe öğelerine ayrıca ulke, ilçeye il_kodu eklenir.

Örnek yanıt

Örnek yanıt · /v1/yerler/tr/konya
{
  "ok": true,
  "kaynak": "GeoNames (CC BY 4.0)",
  "ulke": { "kod": "TR", "ad": "Türkiye" },
  "il": { "kod": "71", "ad": "Konya", "slug": "konya",
          "geoname_id": 306569, "ilce_sayisi": 31, "plaka": 42 },
  "adet": 31,
  "ilceler": [
    { "kod": "8632103", "ad": "Ahırlı", "slug": "ahirli",
      "geoname_id": 8632103 },
    … 31 kayıt
  ]
}

Kullanım

curl
curl -H "X-Api-Key: ss_…" \
  https://api.sanater.com/v1/yerler/tr/konya
JavaScript · bağlı seçim kutuları
const bas = { headers: { 'X-Api-Key': 'ss_…' } };

const { ulkeler } = await (await fetch(
  'https://api.sanater.com/v1/yerler/ulkeler', bas)).json();
ulkeSec.innerHTML = ulkeler
  .map(u => `<option value="${u.kod}">${u.ad}</option>`).join('');

ulkeSec.onchange = async () => {
  const { iller } = await (await fetch(
    `https://api.sanater.com/v1/yerler/${ulkeSec.value}`, bas)).json();
  ilSec.innerHTML = iller
    .map(i => `<option value="${i.kod}">${i.ad}</option>`).join('');
};

Bilinmesi gerekenler

← Tüm belgelerÜcretsiz anahtar alın