Parsel sorgulama ve parsel analizi API'si
Ada ve parsel numarasıyla Tapu Kadastro kaydındaki parsel sınırını, yüzölçümünü ve niteliğini; parselin rakımını, eğimini, en yakın diri faya uzaklığını, arazi örtüsünü ve tabi olduğu çevre düzeni planını tek istekte JSON olarak alın. Değerleme şirketleri, bankalar, emlak ve gayrimenkul yazılımları için.
Kimlik doğrulama
Panelde Ayarlar sayfasının Kurumsal API bölümünden anahtar oluşturun. Anahtarı her istekte Authorization başlığında gönderin. Anahtar gizlidir; yalnızca sunucunuzda saklayın.
Authorization: Bearer ps_ANAHTARINIZ
Taban adres: https://parselstudyo.com/api/v1Uç noktalar
| İstek | Döner | Birim |
|---|---|---|
GET /parsel?mahalleId=&ada=&parsel= | Ada/parsel ile parsel: sınır (GeoJSON), yüzölçümü, nitelik, mevki, pafta, zemin durumu | 1 |
GET /nokta?lat=&lon= | Koordinattaki parsel; yanıtta il, ilçe ve mahalle kimlikleri de döner | 1 |
POST /analiz | Geometri ya da ada/parsel için istenen bölümler: arazi, fay, ortu, plan | Bölüm başına 1; ada/parselle +1 |
GET /idari, /idari?ilId=, /idari?ilceId= | İl, ilçe ve mahalle listeleri (Tapu Kadastro kimlikleriyle) | Ücretsiz |
GET /durum | Birim bakiyesi, sınırlar ve bugün kalan parsel sorgusu | Ücretsiz |
POST /orders, GET /orders/{id} | Ada/parselden ilan videosu siparişi ve durum sorgusu | 1 video kredisi |
POST /analiz
Gövdede ya geometry (GeoJSON Point, Polygon ya da MultiPolygon; koordinat sırası [boylam, enlem]) ya da mahalleId, ada ve parsel gönderilir. include verilmezse dört bölümün tamamı döner. Ada/parsel ile çağrıldığında parselin tapu bilgileri de yanıta eklenir.
araziParsel merkezinde rakım (m), parsel çevresine uydurulan düzlemden eğim (%), eğim sınıfı ve bakı (derece ve yön).fayEn yakın diri fay hattına uzaklık (km) ve fay türü; 150 km içinde fay yoksa enYakin: null.ortuParsel içindeki 10 metrelik piksellerden arazi örtüsü dağılımı (en çok 4 sınıf, yüzde).planNoktanın düştüğü 1/100.000 pafta kodu ve noktanın ilini kapsayan çevre düzeni planları: plan adı, Bakanlık sayfası, pafta ve plan hükümleri bağlantıları.
curl -X POST https://parselstudyo.com/api/v1/analiz \
-H "Authorization: Bearer ps_ANAHTARINIZ" \
-H "Content-Type: application/json" \
-d '{"mahalleId":165693,"ada":224,"parsel":6}'{
"merkez": { "lon": 38.477716, "lat": 37.840493 },
"parsel": {
"il": "Adıyaman", "ilce": "Kahta", "mahalle": "Bölükyayla Köyü",
"ada": "224", "parsel": "6", "alan": 26274.12, "nitelik": "Susuz Tarla",
"mevkii": "", "pafta": "M40-B-20-B", "zemin": "Ana Taşınmaz",
"geometry": { "type": "Polygon", "coordinates": [[[38.47612, 37.84044], …]] }
},
"arazi": { "rakimM": 694, "egimYuzde": 7.8, "egimSinifi": "orta eğimli", "bakiDerece": 54, "bakiYon": "kuzeydoğu" },
"fay": { "enYakin": { "mesafeKm": 16.4, "tur": "ters" }, "aramaYaricapiKm": 150 },
"ortu": [ { "sinif": "Tarım alanı", "yuzde": 78 }, { "sinif": "Çayır / mera", "yuzde": 22 } ],
"plan": {
"paftaKodu": "M40", "il": "Adıyaman",
"planlar": [ { "ad": "Adıyaman - Şanlıurfa - Diyarbakır Planlama Bölgesi", "sayfa": "https://mpgm.csb.gov.tr/x-i-82181", "pafta": "https://webdosya.csb.gov.tr/…", "hukumler": "https://webdosya.csb.gov.tr/…" } ]
},
"kaynaklar": [ "Tapu ve Kadastro Genel Müdürlüğü (TKGM) parsel sorgu", "…" ],
"uyari": "Bilgilendirme amaçlıdır; imar durumu belgesi, tapu kaydı veya değerleme raporu yerine geçmez.",
"birim": 5,
"kalanBirim": 995
}Birimler ve fiyatlar
İlk anahtarınızla hesabınıza 100 ücretsiz birim yüklenir. Sonrasında birim paketlerini panelden kartla, tek seferde alırsınız; birimler süresizdir.
- 1.000 API birimi (birim başı ₺1,49)
- Parsel sorgusu, arazi, diri fay, arazi örtüsü ve çevre düzeni planı
- Birimler süresiz
- Günde 1.000 parsel sorgusuna kadar
- 10.000 API birimi (birim başı ₺1,00)
- Tüm uç noktalar
- Birimler süresiz
- Günde 1.000 parsel sorgusuna kadar; daha yüksek hacim için kurumsal teklif
Günde 1.000 parsel sorgusunun üzerindeki hacim, sözleşmeli kullanım ve fatura için [email protected] adresinden kurumsal teklif isteyin.
Sınırlar
- Anahtar başına dakikada 60 istek.
- Günde 1.000 parsel sorgusu (parsel, nokta ve ada/parselli analiz çağrıları); sayaç Türkiye saatiyle gece yarısı sıfırlanır.
- Polygon en çok 2.000 köşe içerebilir; çok büyük parsellerde arazi örtüsü hesaplanmaz ve o bölümün birimi iade edilir.
- Kalan bakiye her yanıtta X-Units-Remaining başlığıyla döner; GET /durum ile ücretsiz sorgulanır.
Hata kodları
Hatalarda yanıt gövdesi { "error": "kod", "message": "açıklama" } biçimindedir.
| 400 | invalid_params, invalid_body, bad_geometry, out_of_area | Eksik ya da hatalı parametre, geçersiz GeoJSON, Türkiye dışı koordinat |
| 401 | unauthorized | Anahtar yok, hatalı ya da iptal edilmiş |
| 402 | insufficient_units | Birim bakiyesi isteğe yetmiyor; yanıtta gereken birim ve bakiye döner |
| 404 | not_found | Parsel ya da koordinatta kayıtlı parsel bulunamadı (birim düşmez) |
| 429 | rate_limited, daily_limit | Dakikada 60 istek ya da günlük 1.000 parsel sorgusu sınırı |
| 502 | upstream | Tapu Kadastro servisi yanıt vermedi (birim düşmez); kısa bir süre sonra yeniden deneyin |
Sık sorulan sorular
Birim nedir, nasıl düşer?
Her parsel sorgusu ve analizdeki her bölüm 1 birimdir. Birim istekten önce ayrılır; parsel bulunamazsa, servis yanıt vermezse ya da bir bölüm üretilemezse o kısmın birimi aynı anda iade edilir. Yanıttaki birim ve kalanBirim alanları ile X-Units-Used ve X-Units-Remaining başlıkları harcanan ve kalan birimi gösterir.
Ücretsiz deneme var mı?
Evet. Panelde ilk API anahtarınızı oluşturduğunuzda hesabınıza bir kez 100 ücretsiz birim yüklenir. Kart bilgisi istenmez.
Birimlerin süresi var mı?
Hayır. Birimler süresizdir; abonelik ya da otomatik yenileme yoktur. Bakiye bittiğinde panelden yeni paket alırsınız.
Daha yüksek hacim için ne yapmalıyım?
Günde 1.000 parsel sorgusunun üzerindeki ihtiyaçlar ve sözleşmeli kullanım için [email protected] adresine yazın; hacme göre kurumsal teklif hazırlarız.
Yanıtlar resmî belge yerine geçer mi?
Hayır. Veriler kamu kurumlarının yayımladığı kaynaklardan ve açık veri setlerinden derlenir; bilgilendirme amaçlıdır. İmar durumu belgesi, tapu kaydı, zemin etüdü veya lisanslı değerleme raporu yerine geçmez.
Anahtarımı nerede saklamalıyım?
Anahtar yalnızca sunucunuzda, ortam değişkeni gibi gizli bir yerde tutulmalıdır; tarayıcıda ya da mobil uygulamada açıkça yer almamalıdır. Anahtar sızarsa panelden yenisini üretin; eskisi hemen geçersiz olur.
Kaynaklar ve atıf
Son kullanıcıya gösterilen ekranlarda yanıttaki kaynaklar listesinin ve şu uyarının yer alması gerekir: Bilgilendirme amaçlıdır; imar durumu belgesi, tapu kaydı veya değerleme raporu yerine geçmez.