Legolcsóbb közeli üzemanyag API Online
A ponthoz vagy városhoz közeli legolcsóbb töltőállomások, a kiválasztott üzemanyagfajta ára szerint rangsorolva (holtverseny esetén a közelebbi nyer). Az állomásszintű lefedettség 39 európai országra terjed ki, és MÉRT érték, nem rögzített: minden üres válasz visszaadja az aktuális országlistát a coverage objektumban szereplő országonkénti állomásszámmal, a kért fajtára szűkítve — ezt olvassa, ne a leírásban szereplő listát. A rangsorolás egy üzemanyagfajtára vonatkozik egy keresési területen belül, az árak pedig az adott állomás saját pénznemében szerepelnek (PLN Lengyelországban, EUR máshol). Ha egyetlen állomás sem felel meg, a válasz egy coverage objektumot tartalmaz néma üres lista helyett: station_countries és station_counts az élő indexből mérve (a `grade`-re szűkítve, ha fuel_type-ot adott meg), sparse_coverage azokra az országokra, ahol 25 vagy annál kevesebb árazott állomás van, measured_at, valamint egy fuel_type_note, amely elválasztja az üres válasz két lehetséges okát — egy olyan fajtanevet, amelyet nem sikerült beazonosítani, egy olyan fajtától, amelyet felismerünk, de az adott országban nem árazunk.
GET https://nakordoni.eu/api/v2/data/fuel-cheapest
— kvótaosztály: cheap
| Paraméter | Leírás |
|---|---|
lat | Szélesség |
lon | Hosszúság |
city | Város neve — a lat/lon alternatívája, koordinátákká alakítva |
country | ISO-2 országkód, egyértelműsíti a várost |
radius_km | Keresési sugár km-ben (alapértelmezett 25, max. 25; alias: radius) |
fuel_type | diesel (alapértelmezett) | e5 | e10 | superplus | super100 | premdiesel | truckdiesel | hvo | lpg | cng | adblue | e85 | lng — az árrangsor üzemanyagtípusonként külön készül. A helyi kútoszlop-megnevezések is elfogadottak — ON, Olej napędowy, Pb95, Nafta, Dizel, Gázolaj, Motorină, Benzină 95, ДП, А-95, Motorin, Gasóleo, Sans plomb 95, Bleifrei … —, ezeket a `country` alapján oldjuk fel (koordinátás termékeknél pedig azon ország alapján, amelybe a pont esik), mert ugyanaz a megnevezés nem mindenütt ugyanazt a fajtát jelenti: a „95” dán, finn, francia, brit, belga vagy holland kútnál E10, lengyelnél vagy németnél viszont E5. A válasz visszaadja a `fuel_type` (kanonikus), a `fuel_type_requested` (ahogyan beírta) és a `fuel_type_local` mezőt. Az általunk nem azonosítható megnevezést sosem cseréljük alapértelmezett fajtára — a válasz üresen érkezik, és ezt jelzi. A megnevezések teljes, országonkénti táblázata: /api/v2/data/fuel-grades. |
limit | Kutak maximuma (alapértelmezett 5, max. 20) |
lang | A címkék nyelve (alapértelmezett: en) |
Válaszmezők — a válaszboríték data objektumán belül. A [] listát jelöl, tehát a data.items[].name az egyes elemek name mezője. Egy mező null, hiányzik vagy üres lista, ha nincs rá értékünk — helykitöltőt soha nem teszünk oda.
| Mező | Leírás |
|---|---|
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"
Frissítve