API najlacnejšieho paliva v okolí Online
Najlacnejšie čerpacie stanice v okolí bodu alebo mesta, zoradené podľa ceny pre zvolený druh paliva (pri zhode vyhráva bližšia stanica). Pokrytie na úrovni staníc zahŕňa 39 európskych krajín a je MERANÉ, nie pevne dané: každá prázdna odpoveď vracia aktuálny zoznam krajín s počtom staníc pre každú krajinu v objekte coverage, obmedzený na značku (grade), na ktorú ste sa pýtali — vychádzajte z toho, nie zo zoznamu v tomto popise. Poradie sa zostavuje pre jeden druh paliva v rámci jednej oblasti hľadania a ceny nesú vlastnú menu danej stanice (PLN v Poľsku, EUR inde). Ak žiadna stanica nezodpovedá, odpoveď obsahuje objekt coverage namiesto tichého prázdneho zoznamu: station_countries a station_counts namerané z aktuálneho indexu (obmedzené na `grade`, ak bol uvedený fuel_type), sparse_coverage pre krajiny s 25 alebo menej ocenenými stanicami, measured_at a fuel_type_note, ktorá rozlišuje dva dôvody prázdnej odpovede — názov značky, ktorú sa nepodarilo rozpoznať, oproti značke, ktorú rozpoznávame, ale v danej krajine ju neoceňujeme.
GET https://nakordoni.eu/api/v2/data/fuel-cheapest
— trieda kvóty: cheap
| Parameter | Popis |
|---|---|
lat | Zemepisná šírka |
lon | Zemepisná dĺžka |
city | Názov mesta — alternatíva k lat/lon, prevedie sa na súradnice |
country | Kód krajiny ISO-2, spresňuje mesto |
radius_km | Polomer vyhľadávania v km (predvolene 25, max. 25; alias: radius) |
fuel_type | diesel (predvolené) | e5 | e10 | superplus | super100 | premdiesel | truckdiesel | hvo | lpg | cng | adblue | e85 | lng — cenové poradie sa zostavuje pre každý druh paliva samostatne. Akceptujeme aj miestne názvy z výdajných stojanov — ON, Olej napędowy, Pb95, Nafta, Dizel, Gázolaj, Motorină, Benzină 95, ДП, А-95, Motorin, Gasóleo, Sans plomb 95, Bleifrei … — rozlišujú sa podľa `country` (pri produktoch so súradnicami podľa krajiny, do ktorej bod spadá), pretože rovnaké označenie neznamená všade rovnaký druh: „95“ je na dánskom, fínskom, francúzskom, britskom, belgickom či holandskom stojane E10 a na poľskom alebo nemeckom E5. Odpoveď vracia `fuel_type` (kanonický), `fuel_type_requested` (v podobe, akú ste zadali) a `fuel_type_local`. Názov, ktorý nedokážeme priradiť, nikdy nenahrádzame predvoleným druhom — odpoveď príde prázdna a uvedie to. Úplná tabuľka názvov podľa krajín: /api/v2/data/fuel-grades. |
limit | Maximum staníc (predvolene 5, max. 20) |
lang | Jazyk označení (predvolene en) |
Polia odpovede — vnútri objektu data v obálke odpovede. [] označuje zoznam, takže data.items[].name je pole name každého prvku. Pole býva null, chýba alebo je prázdny zoznam, keď preň nemáme hodnotu — zástupný údaj nedopĺňame.
| Pole | Popis |
|---|---|
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"
Aktualizované