İl ve İlçe Sınırları API

Bir koordinatın hangi il ve ilçede olduğunu sınır poligonuyla kesin olarak bulun; ilçe sınırlarını GeoJSON alın.

Ücretsiz pakette var JSON · Türkçe2 uç Kaynak: OpenStreetMap (Geoapify üzerinden)

/v1/konumlar/sinir/bul?enlem=&boylam= noktayı içeren ilçeyi ilçe sınırına göre döndürür; en yakın ilçe merkezine bakan yöntemlerin aksine sınır komşusu ilçeleri karıştırmaz. Sınır dışında kalan noktalarda (deniz) en yakın ilçe verilir ve kesin: false ile belirtilir.

/v1/konumlar/sinir?konum=ankara-cankaya bir ilçenin, ?il=ankara bir ilin tüm ilçelerinin sınırını GeoJSON olarak verir; harita uygulamalarına doğrudan eklenebilir. Sınırlar OpenStreetMap verisidir (ODbL) ve 90 günde bir yenilenir.

Hızlı başlangıç

Anahtarınızı X-API-Key başlığında gönderin (ücretsiz anahtar al). Anahtarı tarayıcı koduna koymayın; sunucunuzdan çağırıp sonucu önbelleğe alın.

<?php
$ch = curl_init('https://api.veriapi.pro/v1/konumlar/sinir/bul?enlem=39.9255&boylam=32.8663');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT => 10,
    CURLOPT_HTTPHEADER => ['X-API-Key: va_ANAHTARINIZ'],
]);
$yanit = json_decode(curl_exec($ch), true);
curl_close($ch);
print_r($yanit['veri']);
const yanit = await fetch("https://api.veriapi.pro/v1/konumlar/sinir/bul?enlem=39.9255&boylam=32.8663", {
  headers: { "X-API-Key": "va_ANAHTARINIZ" },
});
const { veri, kaynak } = await yanit.json();
console.log(veri);
import requests

r = requests.get("https://api.veriapi.pro/v1/konumlar/sinir/bul?enlem=39.9255&boylam=32.8663",
                 headers={"X-API-Key": "va_ANAHTARINIZ"}, timeout=10)
print(r.json()["veri"])
curl -H "X-API-Key: va_ANAHTARINIZ" \
  "https://api.veriapi.pro/v1/konumlar/sinir/bul?enlem=39.9255&boylam=32.8663"

Örnek yanıt

GET https://api.veriapi.pro/v1/konumlar/sinir/bul?enlem=39.9255&boylam=32.8663 — gerçek veriyle; listeler kısaltıldı.

{
  "veri": {
    "ilce": {
      "id": 86,
      "tur": "ilce",
      "ad": "Çankaya",
      "il": "Ankara",
      "plaka": 6,
      "slug": "ankara-cankaya",
      "enlem": 39.86093,
      "boylam": 32.84176
    },
    "kesin": true,
    "not": null
  },
  "kaynak": [
    {
      "kod": "osm_geoapify",
      "ad": "OpenStreetMap (Geoapify üzerinden)",
      "lisans": "ODbL 1.0 (Open Database License); Geoapify saklama ve yeniden dağıtıma izin verir",
      "atif": "© OpenStreetMap katkıcıları (ODbL) — https://www.openstreetmap.org/copyright; Powered by Geoapify (https://www.geoapify.com)",
      "url": "https://www.openstreetmap.org/copyright"
    }
  ],
  "guncelleme": null,
  "bayat": false
}

Uçlar ve parametreler

GET /v1/konumlar/sinir/bul ücretsiz pakette 1 birim

Koordinat hangi il ve ilçede? (sınır poligonuyla kesin)

ParametreTürAçıklama
enlem* sayı
boylam* sayı
GET /v1/konumlar/sinir ücretli paket 2 birim

İl ya da ilçe sınırı (GeoJSON; il → ilçeleriyle FeatureCollection)

ParametreTürAçıklama
konum metin
il metin
ilce metin

Konum alan uçlarda konum (slug), il + ilce (ad, slug ya da plaka) ya da enlem + boylam kullanılabilir. Tüm parametreler: OpenAPI belgesi.

Nerelerde kullanılır?

  • ✓Kullanıcının konumundan il / ilçe göstermek
  • ✓Harita üzerinde ilçe sınırları çizmek
  • ✓Adres verisini ilçeye göre gruplamak

Kaynak ve lisans

  • OpenStreetMap (Geoapify üzerinden) · ODbL 1.0 (Open Database License); Geoapify saklama ve yeniden dağıtıma izin verir · kaynak
    Atıf: © OpenStreetMap katkıcıları (ODbL) — https://www.openstreetmap.org/copyright; Powered by Geoapify (https://www.geoapify.com)

Her yanıtın kaynak alanı bu bilgiyi taşır; veriyi gösterdiğiniz yerde atıf metnini yazın.

Sık sorulan sorular

Koordinattan ilçe bulma ücretsiz mi?

Evet, /v1/konumlar/sinir/bul her pakette açıktır. GeoJSON sınır ucu Başlangıç ve üstü paketlerdedir (2 birim).

Ne kadar hassas?

İlçe sınırları yaklaşık 1 km sadeleştirilmiş OpenStreetMap poligonlarıdır; sınırın hemen yanındaki noktalarda küçük sapma olabilir.

Bu sayfa şu aramalar için de: ters geocoding api türkiye · reverse geocoding türkiye · ilçe sınırları geojson · koordinattan ilçe bulma