Mahalliy yoqilg'i narxlari API Online
Yevropadagi ISTALGAN nuqta uchun mavjud bo‘lgan eng yaxshi yoqilg‘i narxi, uch bosqichli zaxira zinapoyasi orqali aniqlanadi, shunda ma'lumotimiz mavjud bo‘lgan joyda koordinata hech qachon bo‘sh javob qaytarmaydi: nuqta shoxobcha darajasidagi qamrov ichida bo‘lsa (bugungi kunda 39 mamlakat; har bir mamlakat bo‘yicha aniq sonlari bilan to‘liq ro‘yxat har qanday bo‘sh fuel-stations javobining coverage obyektida qaytadi, hech qachon shu yerda yozilgan ro‘yxatdan emas) — eng yaqin shoxobchalardagi kolonka narxlari, aks holda nuqta joylashgan ma'muriy hudud uchun mintaqaviy o‘rtacha (bugungi kunda faqat Ukraina — UAH dagi UA viloyat feed'i), aks holda mamlakat uchun milliy o‘rtacha. Har bir javobda javob bergan bosqichni nomlaydigan `resolution` maydoni bo‘ladi — `station` (ma'lumot distance_km bilan shoxobchalar ro‘yxati, har biri o‘z valyutasida), `region` (bitta viloyat-o‘rtacha obyekti, shuningdek `region` — UA-46 kabi ISO 3166-2 kodi, `region_name` va `region_center_dist_km`) yoki `country` (bitta milliy-o‘rtacha obyekti). region va country bosqichlari bir xil narx kalitlarini qaytaradi: petrol/petrol95plus/petrol92/diesel/lpg + currency + yangilangan sana. Javob shakliga emas, `resolution`ga qarab tarmoqlaning. Ukrainada hech qayerda shoxobcha bo‘yicha narxlar yo‘q, shuning uchun UA nuqtasi viloyat narxi mavjud bo‘lsa `region` bosqichida javob beradi va aks holda `country`ga tushadi. Nuqta qamrab olingan barcha mamlakatlardan tashqarida bo‘lsa (okean o‘rtasida, Yevropadan tashqarida) — 404. region va country bosqichlari, shuningdek, har bir narx kalitini uning kanonik markasiga va shu mamlakat haydovchisi kolonkada ishlatadigan nomga bog‘laydigan `grades` obyektini ham o‘z ichiga oladi (UA `diesel` → ДП, PL `petrol` → Pb95). Koordinatasiz oddiy milliy o‘rtacha uchun `fuel` mahsulotidan, sof shoxobcha qidiruvi uchun `fuel-stations`dan, narx bo‘yicha saralash uchun `fuel-cheapest`dan foydalaning.
GET https://nakordoni.eu/api/v2/data/fuel-local
— 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 | Shoxobcha darajasidagi qidiruv radiusi, km (standart 25, eng ko‘pi 25; alias: radius). Uning ichida birorta shoxobcha bo‘lmasa, javob mamlakat darajasiga o‘tadi — qidiruv hech qachon o‘z-o‘zidan kengaymaydi. |
fuel_type | Shoxobcha darajasidagi ixtiyoriy filtr: diesel | e5 | e10 | superplus | super100 | premdiesel | truckdiesel | hvo | lpg | cng | adblue | e85 | lng. Mamlakat darajasida e’tiborga olinmaydi — u yerda mamlakat xabar qiladigan barcha turlar doimo qaytariladi. 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 | Shoxobcha darajasida maksimal shoxobchalar (standart 5, maksimum 20) |
lang | Yorliqlar va mamlakat nomi 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.resolution | Which tier answered: station | region | country. Branch on this, never on the shape. |
data.anchor | The point the answer was resolved for: lat, lng, ppid, radius_km and the fuel_type fields. |
data.country | ISO-2 country the point fell in; region is its ISO 3166-2 code at the region tier. |
data.data | At station tier a list of stations (see fuel-stations). At region and country tier one averages object: petrol, petrol95plus, petrol92, petrol98, diesel, lpg, lpg_eur, currency, updated, trend_petrol, trend_diesel, country_name. |
data.data.region_name | Region tier only: the region's name, with region_center_dist_km — how far its centre sits from your point. |
data.grades | Region and country tier only: each price key mapped to its canonical grade and the local pump name. |
data.labels | Localised UI strings — for rendering, not data. |
curl "https://nakordoni.eu/api/v2/data/fuel-local?lat=50.45&lon=30.52&lang=uk" \ -H "Authorization: Bearer NKD-DEV-XXXX-XXXX-XXXX"
Yangilandi