EPDK ham verisi vs Yonga API

EPDK’nın resmi şarj istasyonu verisi açık ve değerli. Türkiye’deki lisanslı her şarj istasyonu orada kayıtlı. Ama ham hâliyle bir uygulamanın, filo yazılımının ya da analiz ekibinin doğrudan kullanabileceği biçimde değil.

Bu yazıda EPDK’nın resmi API’si ile Yonga API’yi yan yana koyuyoruz: Yonga neyi ekliyor, neyi eklemiyor. İkinci soru en az birincisi kadar önemli, çünkü entegrasyon planınızı neyin olmadığını bilerek yapmanız gerekir.

EPDK resmi API: açık veri, sıkı limitler

EPDK verisi doğrulanmış ve güvenilir, ancak erişim modeli toplu indirmeye yakındır. Tüm istasyon listesini saatte bir, tekil istasyon detayını dakikada bir çekebilirsiniz. Bu limitlerle:

• Kullanıcı konumuna göre “yakınımdaki istasyonlar” sorgusu yapamazsınız; listeyi indirip mesafeyi kendiniz hesaplarsınız.
• Kayıtları il, ilçe ve mahalleye bağlamak, ağ adlarını tekilleştirmek ve soket bilgisini normalize etmek sizin işiniz olur.
• Hangi istasyonun eklendiğini ya da kayıttan düştüğünü görmek için iki indirmeyi kendiniz karşılaştırırsınız.

Yonga’nın eklediği katman

Yonga, EPDK’yı kaynak olarak kullanır. Veri EPDK kaynağından günlük güncellenir; üzerine şunları ekler.

Normalize şema ve tek endpoint

Tüm ağların istasyonları aynı şemayla, tek bir uç noktadan gelir: GET /charging-stations. Her istasyon ağına, iline, ilçesine ve soketlerine (AC/DC, bağlantı standardı, kW) bağlıdır. OpenAPI 3.1 şeması https://dash.yonga.io/docs/api.json adresindedir.

Yarıçap araması

Koordinat ve yarıçap verdiğinizde sonuçlar en yakından uzağa sıralanır ve her satır km cinsinden distance taşır:

curl "https://dash.yonga.io/api/charging-stations?latitude=39.92&longitude=32.85&radius=5&connector_type=CCS2&power_min=50&fields=summary" \
  -H "Authorization: Bearer $TOKEN"

socket_type (AC/DC), connector_type (CCS2, Type2, CHAdeMO), power_min / power_max, city, district ve network filtreleri birlikte kullanılabilir.

Tek çağrıda operatör dağılımı

“Bu ilçede hangi ağlar var, kaçar istasyonla?” sorusu sayfalama gerektirmez:

curl "https://dash.yonga.io/api/charging-stations?district=cankaya&socket_type=DC&group_by=network" \
  -H "Authorization: Bearer $TOKEN"

Yanıt, her operatör için tek satır ve station_count döndürür.

İl → ilçe → mahalle coğrafyası

/regions, /cities, /cities/{il}/districts ve /cities/{il}/districts/{ilçe} uç noktaları istasyon toplamlarını, AC/DC soket sayılarını ve kurulu gücü idari birim bazında verir. İsteğe bağlı olarak GeoJSON poligonları da eklenebilir.

Tarifeler

GET /charging-networks/{slug}/pricing, tarifesi kayıtlı ağlar için AC ve DC ₺/kWh fiyatlarını döndürür. Her ağ için tarife verisi henüz yok; olmayan ağlarda alan boş gelir.

Değişiklik günlüğü

GET /events/stations-changelog?days=30, son N günde eklenen ve kayıttan düşen istasyonları döndürür. İki EPDK indirmesini kendiniz karşılaştırmanıza gerek kalmaz.

MCP sunucusu

Aynı veri https://dash.yonga.io/mcp adresindeki MCP sunucusundan da sunulur. Claude ya da ChatGPT gibi bir asistan “Çankaya’da en az 100 kW DC şarjı olan en yakın 3 istasyon” sorusunu doğrudan araç çağrısıyla yanıtlayabilir. REST ile aynı token ve aynı limitler geçerlidir.

Yan yana karşılaştırma

Kriter	EPDK resmi API	Yonga API
Erişim limiti	Liste saatte 1, detay dakikada 1	Kademeye göre saatte 100.000 isteğe kadar
Format	Ham	Normalize JSON, OpenAPI şeması
Yarıçap araması	Yok	latitude / longitude / radius
Coğrafya	Adres metni	İl → ilçe → mahalle, GeoJSON
Operatör dağılımı	Kendiniz hesaplarsınız	group_by=network
Değişiklik takibi	Kendiniz karşılaştırırsınız	Changelog uç noktası
AI asistan erişimi	Yok	MCP sunucusu
Güncelleme	Kaynak	EPDK kaynağından günlük

Erişim kademeleri ve dakikalık tavanlar çözümler sayfasındaki limit tablosunda yer alır.

Yonga’nın sunmadıkları

Entegrasyonu planlamadan önce bunları bilmeniz gerekir:

• Anlık soket doluluğu yok. Bir soketin şu an dolu mu boş mu olduğunu bildirmiyoruz. Kayıtlı bir durum alanı vardır, ama canlı müsaitlik değildir.
• Webhook ya da push bildirim yok. Erişim pull modelidir. Değişiklikleri changelog uç noktasından, istediğiniz sıklıkta çekersiniz.
• Hazır SDK yok. Standart REST ve JSON her dilin HTTP istemcisiyle çalışır. OpenAPI şemasını istemci üreticinize verebilirsiniz.
• Şarj seansı, ödeme ve harcama verisi yok. Yonga altyapı verisidir, işlem verisi değildir.
• Rota motoru yok. Koordinat ve yarıçap sorgusu sağlarız; rotayı kendi motorunuz hesaplar.

Tam liste çözümler sayfasında.

Sonuç

EPDK verisi açıktır ve sektör için vazgeçilmez bir kaynaktır. Yonga bunun yerini almaz, onu kaynak olarak kullanır. Fark, ham kaydı sorgulanabilir bir veri setine dönüştüren katmandadır: normalize şema, yarıçap araması, idari coğrafya, değişiklik günlüğü ve MCP.

Sorularınız için [email protected] adresine yazabilir ya da iletişim sayfasından görüşme talep edebilirsiniz.