API lokálnych cien palív Online
Najlepšia dostupná cena paliva pre AKÝKOĽVEK bod v Európe, určená podľa trojúrovňového záložného rebríčka tak, aby sa súradnica nikdy nevrátila prázdna tam, kde máme vôbec nejaké údaje: ceny pri výdajných stojanoch z najbližších staníc, ak bod leží v pokrytí na úrovni staníc (dnes 39 krajín; presný zoznam s počtom staníc pre každú krajinu sa vracia v objekte coverage akejkoľvek prázdnej odpovede fuel-stations, nikdy zo zoznamu zapísaného tu), inak regionálny priemer pre správny región, do ktorého bod patrí (dnes iba Ukrajina — feed oblastí UA, v UAH), inak národný priemer pre danú krajinu. Každá odpoveď nesie pole `resolution`, ktoré pomenúva úroveň, ktorá odpovedala — `station` (údaje sú zoznam staníc s distance_km, každá vo vlastnej mene), `region` (jeden objekt oblastného priemeru plus `region`, kód ISO 3166-2 ako UA-46, `region_name` a `region_center_dist_km`) alebo `country` (jeden objekt národného priemeru). Úrovne region a country vracajú rovnaké cenové kľúče: petrol/petrol95plus/petrol92/diesel/lpg + currency + dátum aktualizácie. Vetvite logiku podľa `resolution`, nikdy podľa tvaru údajov. Ukrajina nemá nikde ceny na úrovni staníc, takže bod v UA dostane odpoveď na úrovni `region`, ak je daná oblasť ocenená, inak sa vráti na `country`. 404, ak bod leží mimo všetkých pokrytých krajín (otvorený oceán, mimo Európy). Úrovne region a country nesú aj objekt `grades`, ktorý mapuje každý cenový kľúč na jeho kanonickú značku a na názov, ktorý by vodič v danej krajine použil pri stojane (UA `diesel` → ДП, PL `petrol` → Pb95). Pre obyčajný národný priemer bez súradníc použite produkt `fuel`, pre čisté vyhľadávanie staníc `fuel-stations`, pre zoradenie podľa ceny `fuel-cheapest`.
GET https://nakordoni.eu/api/v2/data/fuel-local
— 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 na úrovni staníc v km (predvolene 25, maximum 25; alias: radius). Ak v ňom nie je žiadna stanica, odpoveď prepadne na úroveň krajiny — vyhľadávanie sa nikdy nerozšíri samo. |
fuel_type | Voliteľný filter na úrovni čerpacích staníc: diesel | e5 | e10 | superplus | super100 | premdiesel | truckdiesel | hvo | lpg | cng | adblue | e85 | lng. Na úrovni krajiny sa ignoruje, tam sa vždy vracajú všetky druhy, ktoré krajina hlási. 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 na úrovni staníc (predvolene 5, max. 20) |
lang | Jazyk označení a názvu krajiny (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.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"
Aktualizované