Yakındaki En Ucuz Yakıt API Online
Bir noktanın veya şehrin çevresindeki en ucuz benzin istasyonları, seçilen yakıt türüne göre fiyata göre sıralanır (eşitlik durumunda en yakın kazanır). İstasyon düzeyindeki kapsama 39 Avrupa ülkesini kapsar ve sabit değil, ÖLÇÜLMÜŞTÜR: her boş yanıt, coverage nesnesinde ülke başına istasyon sayılarıyla birlikte, istediğiniz sınıfla sınırlı güncel ülke listesini döndürür — bu nedenle bu açıklamadaki bir listeyi değil, onu okuyun. Sıralama, tek bir arama alanı içinde yakıt türüne göre yapılır ve fiyatlar her istasyonun kendi para birimini taşır (Polonya'da PLN, diğer yerlerde EUR). Hiçbir istasyon eşleşmediğinde, yanıt sessiz bir boş liste yerine bir coverage nesnesi içerir: canlı dizinden ölçülen station_countries ve station_counts (bir fuel_type belirttiğinizde `grade` ile sınırlı), 25 veya daha az fiyatlandırılmış istasyona sahip ülkeler için sparse_coverage, measured_at ve bir yanıtın neden boş olabileceğine dair iki nedeni ayıran fuel_type_note — yerleştiremediğimiz bir sınıf adı ile tanıdığımız ama o ülkede fiyatlandırmadığımız bir sınıf arasındaki fark.
GET https://nakordoni.eu/api/v2/data/fuel-cheapest
— kota sınıfı: cheap
| Parametre | Açıklama |
|---|---|
lat | Enlem |
lon | Boylam |
city | Şehir adı — lat/lon yerine kullanılır, koordinatlara çevrilir |
country | ISO-2 ülke kodu, şehri netleştirir |
radius_km | Arama yarıçapı (km) (varsayılan 25, en fazla 25; alias: radius) |
fuel_type | diesel (varsayılan) | e5 | e10 | superplus | super100 | premdiesel | truckdiesel | hvo | lpg | cng | adblue | e85 | lng — fiyat sıralaması her yakıt türü için ayrı yapılır. Yerel pompa adları da kabul edilir — ON, Olej napędowy, Pb95, Nafta, Dizel, Gázolaj, Motorină, Benzină 95, ДП, А-95, Motorin, Gasóleo, Sans plomb 95, Bleifrei … — bunlar `country` bağlamında çözümlenir (koordinat tabanlı ürünlerde ise noktanın düştüğü ülkeye göre), çünkü aynı ifade her yerde aynı yakıt türü anlamına gelmez: “95” Danimarka, Finlandiya, Fransa, İngiltere, Belçika veya Hollanda pompasında E10, Polonya veya Almanya pompasında ise E5’tir. Yanıt `fuel_type` (kanonik), `fuel_type_requested` (yazdığınız hâliyle) ve `fuel_type_local` alanlarını döndürür. Yerini belirleyemediğimiz bir ad asla varsayılan bir yakıt türüyle değiştirilmez; yanıt boş döner ve bunu belirtir. Ülkelere göre adların tam tablosu: /api/v2/data/fuel-grades. |
limit | En fazla istasyon (varsayılan 5, en fazla 20) |
lang | Etiketlerin dili (varsayılan en) |
Yanıt alanları — yanıt zarfındaki data nesnesinin içinde. [] bir listeyi gösterir; yani data.items[].name her öğenin name alanıdır. Değerimiz olmayan bir alan null olur, hiç bulunmaz ya da boş liste döner — asla yer tutucu koymayız.
| Alan | Açıklama |
|---|---|
data.stations[] | The same station objects as fuel-stations (grades nested under prices, one entry per physical station), ranked cheapest first for the chosen grade — closest wins a tie, and a station without a quote for that grade ranks last. |
data.anchor | The point searched and the resolved grade: lat, lng, radius_km, fuel_type, fuel_type_requested, fuel_type_local, fuel_type_country. |
data.count | Stations returned; data.total_found is how many matched inside the radius before limit was applied. |
data.coverage | Only when nothing matched — grade, station_countries + station_counts measured from the live index (scoped to that grade), sparse_coverage, measured_at, and fuel_type_note for both an unplaceable grade name and a recognised grade we do not price in this country. |
curl "https://nakordoni.eu/api/v2/data/fuel-cheapest?city=Munich&country=DE&radius_km=25" \ -H "Authorization: Bearer NKD-DEV-XXXX-XXXX-XXXX"
Güncellendi