İ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.
/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)
| Parametre | Tür | Açı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)
| Parametre | Tür | Açı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