Yaqin yoqilg'i shoxobchalari API Online
Nuqta yoki shaharga eng yaqin yoqilg‘i quyish shoxobchalari, har bir yoqilg‘i turi bo‘yicha joriy narxlar bilan, masofa bo‘yicha saralangan. 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 — bu nakordoni.eu yoqilg‘i sahifalaridagi ma'lumotlar bilan bir xil; boshqa hollarda milliy o‘rtacha qiymatlar uchun fuel API-ning country rejimidan foydalaning. Narxlar har bir shoxobchaning o‘z valyutasida qaytariladi (Polsha shoxobchalari uchun PLN, boshqa joylarda EUR) — har bir shoxobchaning currency maydonini o‘qing, xom raqamlarni hech qachon solishtirmang. 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-stations
— 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 | Ixtiyoriy filtr: diesel | e5 | e10 | superplus | super100 | premdiesel | truckdiesel | hvo | lpg | cng | adblue | e85 | lng (mavjudlik shoxobcha/mintaqaga qarab farq qiladi; Polsha shoxobchalari Pb95 ni e5, Pb98 ni superplus va ON ni diesel deb bildiradi). Kolonkalardagi mahalliy nomlar 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` bo'yicha aniqlanadi (koordinatali mahsulotlarda esa nuqta tushgan mamlakat bo'yicha), chunki bir xil nom hamma joyda bir xil turni anglatmaydi: „95“ Daniya, Finlyandiya, Fransiya, Britaniya, Belgiya yoki Niderlandiya kolonkasida E10, Polsha yoki Germaniya 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.anchor.lat | The point actually searched (after city geocoding), with lng, ppid and radius_km. |
data.anchor.fuel_type | The canonical grade the list was filtered to; fuel_type_requested is what you sent, fuel_type_local the local pump name and fuel_type_country the country the name was read in. |
data.stations[].name | Station, with brand and address. Each physical station appears ONCE: its grades are nested under prices, not spread over repeated rows. `brand` is the chain when we know it and null when we do not — never a placeholder token, so treat null as "independent or unknown" and fall back to `name`. Address detail varies by national feed: some report a full street address, others only the town. |
data.stations[].station_ref | Stable key for the station (name + position). Key your records on it whenever id is null — id is set only for rows that come from our station directory. |
data.stations[].prices | Object keyed by grade (diesel, e5, e10, lpg …): price, currency and currency_symbol, local_name (the pump name used in that country), label, updated_at, confirmed_at, age_hours and stale. Each station carries its own currency, so never compare the raw numbers. A station with no quote at all carries an empty object here. TWO CLOCKS, and they answer different questions — do not derive one from the other: `updated_at` is when this price last MOVED, so a forecourt that has held the same price for ten days keeps a ten-day-old stamp and that is correct, not stale data; `confirmed_at` is when we last CONFIRMED the quote against its feed, and it is the clock `age_hours` and `stale` are measured on (age_hours = now − confirmed_at). Read `confirmed_at`/`stale` for freshness and `updated_at` for price history. Both are floored to the hour, so `now − confirmed_at` can sit up to an hour above `age_hours`, which is measured before the floor; `confirmed_at` is never earlier than `updated_at`, because a price change is itself a confirmation. |
data.stations[].grades | The grade keys present in prices, alongside freshest_age_hours and a station-level stale flag (true only when NO quote of that station is current). |
data.stations[].distance_km | Distance from the anchor, with lat and lng of the station itself. |
data.count | Stations returned; data.total_found is how many matched inside the radius before limit was applied. |
data.notices | Present whenever we adjusted a parameter you sent: each entry names the param, the requested and the applied value, and the reason. |
data.coverage | Only when nothing matched. grade (the fuel_type your wording resolved to, or null), station_countries and station_counts measured from the live station index and scoped to that grade, sparse_coverage for countries with 25 priced stations or fewer, measured_at, a note explaining all of it, and fuel_type_note when the grade name could not be placed OR when we recognise the grade but price it nowhere in this country. |
curl "https://nakordoni.eu/api/v2/data/fuel-stations?city=Munich&country=DE&radius_km=20&fuel_type=diesel" \ -H "Authorization: Bearer NKD-DEV-XXXX-XXXX-XXXX"
Yangilandi