KURUMSAL & KAMUREST API + MCP

7 bölge, 81 il, 992 ilçe
tek veri seti

Türkiye'nin EV şarj altyapısı, ülkenin tam idari coğrafyasına bağlanmış halde. Pazar analizi, altyapı planlama ve akademik araştırma için makine tarafından okunabilir tek kaynak, GeoJSON sınırlarıyla birlikte. Veri EPDK kaynağından günlük güncellenir.

~49.000
Mahalle granülaritesi
16.998
Faal istasyon
100k
Saatlik istek · enterprise
~ cities/izmir · GeoJSON export200 OK
# İl sınırı, poligonuyla birlikte
curl "https://dash.yonga.io/api/cities/izmir?populate=polygon" \
  -H "Authorization: Bearer $YONGA_TOKEN"

populate=polygon ham GeoJSON döndürür — QGIS, ArcGIS veya PostGIS'e doğrudan beslenebilir.

Kurumsal & kamu kullanım senaryoları

Strateji, planlama, araştırma

BAKANLIK · BELEDİYE

Altyapı planlama

İlçe ve mahalle bazında istasyon yoğunluğu, güç kapasitesi (total_power_kw) ve operatör dağılımı. GeoJSON sınırlarla mevcut planlama yazılımınıza doğrudan girer.

YATIRIM

Pazar ve yatırım analizi

Operatör bazında ulusal ve bölgesel dağılım, ağ büyüklüğü sıralaması ve kapsama açıkları. Hangi ağın nerede büyüdüğünü değişim günlüklerinden izlersiniz.

OTOMOTİV

EV pazarı raporlama

İl bazında şarj yoğunluğunu kendi satış verinizle korele edin. Bayi ağı planlaması ve pazar sunumları için standart, atıflanabilir kaynak.

ENERJİ

Şebeke yük çalışmaları

İl ve ilçe bazında kurulu şarj gücü ve AC/DC soket kırılımı. Talep senaryolarınız için coğrafi taban veri.

DANIŞMANLIK

Müşteri raporları

Strateji firmaları için lisanslanmış veri; müşteri raporlarınızda Yonga kaynak gösterilebilir. Kapsam ve lisans şartlarını birlikte tanımlıyoruz.

AKADEMİ

Araştırma ve ar-ge

Üniversite ve araştırma merkezleri için indirimli erişim. Akademik yayında atıf zorunlu; arşiv tutmadığımız için atıfta veriyi çektiğiniz tarihi belirtirsiniz.

Coğrafi katman

İdari hiyerarşi,
tek yol adresiyle

Yonga'nın ayırt edici tarafı istasyon listesi değil, o listenin Türkiye'nin tam idari hiyerarşisine bağlanmış olması.

Bir il poligonu yaklaşık 50 KB'dır. Toplu poligon çekimlerini enterprise kademede planlıyoruz.

7 bölge

GET /regions · GET /regions/{slug}

Bölge detayı şarj toplamlarını ve illeri taşır. Bölgesel karşılaştırma raporları için tek çağrı.

81 il

GET /cities/{slug}

Koordinatlar, total_stations, total_networks, AC/DC soket sayıları, total_power_kw, top_networks sıralaması ve isteğe bağlı GeoJSON poligon.

992 ilçe

GET /cities/{citySlug}/districts

Sınır poligonlarıyla birlikte. İlçe düzeyinde beyaz alan ve yoğunluk analizinin tabanı.

~49.000 mahalle

GET /cities/{citySlug}/districts/{districtSlug}

992 ilçenin 958'inde mahalle verisi tamamlanmış durumda. Şehir içi mikro-analiz için en ince granülarite.

Geometri seçenekleri

geometry=none | bbox | centroid | full

MCP tarafında geometriyi ihtiyacınıza göre seçersiniz: sınırlayıcı kutu, merkez nokta ya da tam poligon.

Tek araçla gezinme

geo(path="ankara/cankaya/kizilay")

MCP'de tüm hiyerarşi tek araçla adreslenir. Her yanıt breadcrumb ve kanonik slug'ları taşır.

Tarihsel veri

Arşiv değil,
her gün güncel veri

Günlük yenileme
Her gün

Güncel EPDK verisi her gün tazelenir; API her zaman en son durumu döner. Tarihsel zaman serisi tutmuyoruz.

Enterprise
EPDK JSON dökümü

Enterprise kullanıcılar, bizimle iletişime geçerek güncel EPDK verisinin ham JSON dökümünü alabilir.

Değişiklik kaydı · aktif
/events/stations-changelog?days=N
/events/networks-changelog?days=N

İstasyon ve ağ değişiklik kayıtları aktif: seçtiğiniz pencerede eklenen ve pasifleşen kayıtlar, sayılarıyla.

Geçmişe dönük veri setleri sunmuyoruz. Güncel verinin JSON dökümü için bizimle iletişime geçin.

Kurumsal erişim

Barındırma değil, erişim modeli

Yonga bulutta çalışan bir API ve MCP sunucusudur. On-premise, VPC veya air-gapped dağıtım sunmuyoruz. Kurumsal ihtiyaçları erişim tarafında karşılıyoruz:

Enterprise kademe

Saatte 100.000, dakikada 2.000 istek. Toplu coğrafi çekim ve gecelik senkronizasyon iş yükleri için ölçülendirilmiştir.

  • · Saatlik + dakikalık çift limit
  • · X-RateLimit-* başlıklarıyla izleme
  • · Kullanım profilinize göre birlikte belirlenir

Yetenek bazlı token

Sanctum bearer token'lar yetenek taşır. Ekiplerinize yalnızca ihtiyaç duydukları veri grubunu açan token'lar üretilir.

  • · stations:read — istasyon uç noktaları
  • · networks:read — ağ operatörleri
  • · map:read — bölge, il, ilçe, mahalle
  • · stats:read — değişim günlükleri

Toplu ve build-zamanı erişim

Sayfalama yapmadan çalışan uç noktalar, veri ambarı ve statik site senaryoları için tasarlanmıştır.

  • · /charging-stations/map — il başına tüm pinler
  • · /docs/api.json — OpenAPI 3.1 spesifikasyonu
Barındırma & uyumluluk
Bursa veri merkezi · KVKK · TLS
Altyapı Türkiye'de, Bursa veri merkezinde barındırılıyor. Veri seti kamuya açık EPDK kayıt verisine dayanır; kişisel veri içermez. Kimlik doğrulama Bearer token ile yapılır, tüm trafik TLS üzerinden taşınır. Kurumsal satın alma süreciniz ek belge gerektiriyorsa kapsamı birlikte değerlendirelim — elimizde olanı olduğu gibi, olmayanı açıkça söyleyerek paylaşırız.
Teknik dosya iste
Kapsam dışı

Sunmadıklarımız

Gösterge paneli, rapor veya istatistik ekranı yok.

Yonga bir API ve MCP sunucusudur; görselleştirmeyi kendi araçlarınızla yaparsınız. Yakın yol haritasında panel yok.

On-premise, VPC veya air-gapped dağıtım yok.

Yonga bulutta çalışan bir API ve MCP sunucusudur. SAML/OIDC SSO, müşteri yönetimli anahtar ve PrivateLink da kapsam dışıdır.

Anlık soket doluluğu ve rezervasyon yok.

Bir soketin şu an dolu mu boş mu olduğunu bildirmiyoruz. Kayıtlı durum alanı (active / inactive / maintenance) vardır, canlı müsaitlik değildir.

Uptime metriği ve kesinti geçmişi yok.

Arıza süresi, kesinti geçmişi veya sektör uptime medyanı tutmuyoruz.

Şarj seansı, ödeme ve ciro verisi yok.

Altyapı verisi sunuyoruz, işlem verisi değil. Şarj başlatma ve ödeme için ağ operatörünün kendi roaming/OCPI entegrasyonu gerekir.

Tarihsel zaman serisi yok.

Geçmiş durumları saklamıyoruz: veri EPDK kaynağından günlük güncellenir ve API her zaman son hâli döner. Enterprise kullanıcılar talep üzerine güncel verinin JSON dökümünü alabilir. Neyin değiştiğini changelog uç noktaları gösterir — seçtiğiniz son N günde eklenen ve pasifleşen istasyon ve ağlar.

Erişim kademeleri

Limit tablosu

KademeSaatlik istekDakikalık istek
Kimliksiz6020
free10020
basic1.00060
pro10.000300
beta20.000500
enterprise100.0002.000

Saatlik değer kotayı, dakikalık değer ani yük tavanını belirler; ikisi aynı anda geçerlidir. Aynı limitler /api/* ve /mcp için ortaktır.

MCP sunucusu

Araştırma ekibiniz
doğrudan sorsun

Aynı veri Model Context Protocol sunucusu olarak da açık: POST https://dash.yonga.io/mcp. Claude, Claude Code veya Cursor'a bağlanır; analistleriniz doğal dilde sorar, ajan list_charging_stations, geo ve list_networks araçlarını çağırır.

6 araç, REST ile aynı token, aynı { data, meta } zarfı, aynı kademe limitleri.

Örnek oturum
Araştırmacı

Ege Bölgesi'nde il başına DC soket yoğunluğu nedir?

GET /regions/ege → iller
her il için geo(path=…) → toplamlar
Ajan

8 il için toplam DC soket ve kurulu güç kırılımı hazır — tablo olarak vereyim mi?

Kapsamı birlikte tanımlayalım

Kurumsal projeniz için görüşelim.

Kamu projeleri, akademik çalışmalar, pazar analizi — ihtiyacınızı dinleyip elimizdekinin ne kadarını karşıladığını açık söyleyelim.