Yaqin arzon yoqilg'i API Online
Nuqta yoki shahar atrofidagi eng arzon yoqilg‘i quyish shoxobchalari, tanlangan yoqilg‘i turi bo‘yicha narxiga qarab saralangan (teng bo‘lganda yaqinrog‘i g‘alaba qozonadi). Shoxobcha darajasidagi qamrov Yevropaning 39 mamlakatini qamrab oladi va u O‘LCHANADI, qat'iy belgilangan emas: har qanday bo‘sh javob coverage obyektida joriy mamlakatlar ro‘yxatini, har bir mamlakat bo‘yicha shoxobchalar sonini, so‘ralgan marka doirasida qaytaradi — shuning uchun ushbu tavsifdagi ro‘yxat o‘rniga aynan shuni o‘qing. Saralash bitta qidiruv hududi ichida har bir yoqilg‘i turi bo‘yicha alohida amalga oshiriladi, narxlar esa har bir shoxobchaning o‘z valyutasida beriladi (Polshada PLN, boshqa joylarda EUR). Hech qanday shoxobcha mos kelmasa, javobda jimgina bo‘sh ro‘yxat o‘rniga coverage obyekti bo‘ladi: jonli indeksdan o‘lchangan station_countries va station_counts (fuel_type ko‘rsatilgan bo‘lsa, `grade` doirasida), narxi ko‘rsatilgan shoxobchalari 25 tadan oshmaydigan mamlakatlar uchun sparse_coverage, measured_at va javob nima uchun bo‘sh bo‘lishi mumkinligining ikki sababini ajratadigan fuel_type_note — biz aniqlay olmagan marka nomi bilan biz taniydigan, ammo shu mamlakatda narxini e'lon qilmaydigan marka o‘rtasidagi farq.
GET https://nakordoni.eu/api/v2/data/fuel-cheapest
— kvota sinfi: cheap
| Parametr | Tavsif |
|---|---|
lat | Kenglik |
lon | Uzunlik |
city | Shahar nomi — lat/lon o'rniga, koordinatalarga aylantiriladi |
country | ISO-2 mamlakat kodi, shaharni aniqlashtiradi |
radius_km | Qidiruv radiusi, km (standart 25, maksimum 25; alias: radius) |
fuel_type | diesel (standart) | e5 | e10 | superplus | super100 | premdiesel | truckdiesel | hvo | lpg | cng | adblue | e85 | lng — narx bo‘yicha reyting har bir yoqilg‘i turi uchun alohida tuziladi. Mahalliy kolonka nomlari ham qabul qilinadi — ON, Olej napędowy, Pb95, Nafta, Dizel, Gázolaj, Motorină, Benzină 95, ДП, А-95, Motorin, Gasóleo, Sans plomb 95, Bleifrei … — ular `country` konteksti asosida aniqlanadi (koordinatalarga asoslangan mahsulotlarda esa nuqta tushgan mamlakat asosida), chunki bir xil ibora hamma joyda bir xil turni anglatmaydi: „95“ daniya, finlyandiya, fransuz, britaniya, belgiya yoki niderlandiya kolonkasida E10, polsha yoki nemis kolonkasida esa E5 hisoblanadi. Javob `fuel_type` (kanonik), `fuel_type_requested` (siz kiritgan ko‘rinishda) va `fuel_type_local` maydonlarini qaytaradi. Biz aniqlay olmagan nom hech qachon standart tur bilan almashtirilmaydi — javob bo‘sh qaytadi va buni bildiradi. Mamlakatlar bo‘yicha nomlarning to‘liq jadvali: /api/v2/data/fuel-grades. |
limit | Maksimal shoxobchalar (standart 5, maksimum 20) |
lang | Yorliqlar tili (standart en) |
Javob maydonlari — javob konvertidagi data obyekti ichida. [] ro‘yxatni bildiradi, ya’ni data.items[].name har bir elementning name maydonidir. Qiymatimiz bo‘lmagan maydon null bo‘ladi, umuman bo‘lmaydi yoki bo‘sh ro‘yxat qaytadi — o‘rniga hech qachon soxta qiymat qo‘ymaymiz.
| Maydon | Tavsif |
|---|---|
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"
Yangilandi