Helyi üzemanyagár API Online
A legjobb elérhető üzemanyagár Európa BÁRMELY pontjára, egy háromszintű tartalék-létrán lefelé haladva meghatározva, hogy egy koordináta soha ne térjen vissza üresen ott, ahol egyáltalán van adatunk: kúti árak a legközelebbi állomásokról, ha a pont állomásszintű lefedettségen belül van (ma 39 ország; a pontos lista országonkénti darabszámmal bármely üres fuel-stations válasz coverage objektumában érkezik vissza, soha nem egy itt rögzített listából), egyébként regionális átlag arra a közigazgatási régióra, amelybe a pont esik (ma csak Ukrajna — az UA oblaszty-hírfolyam, UAH-ban), egyébként az adott ország országos átlaga. Minden válasz tartalmaz egy `resolution` mezőt, amely megnevezi a választ adó szintet — `station` (az adat egy állomáslista distance_km-mel, mindegyik a saját pénznemében), `region` (egy oblaszty-átlag objektum plusz `region`, egy ISO 3166-2 kód, például UA-46, `region_name` és `region_center_dist_km`) vagy `country` (egy országos átlag objektum). A region és country szintek ugyanazokat az árkulcsokat adják vissza: petrol/petrol95plus/petrol92/diesel/lpg + currency + frissítés dátuma. Az elágazást a `resolution` alapján végezze, soha ne az alak alapján. Ukrajnának sehol nincs állomásszintű ára, ezért egy UA pont a `region` szinten kap választ, ha az adott oblaszty árazott, egyébként visszaesik `country`-ra. 404, ha a pont minden lefedett országon kívül esik (nyílt óceán, Európán kívül). A region és country szintek egy `grades` objektumot is tartalmaznak, amely minden árkulcsot a kanonikus fajtájához és ahhoz a névhez rendel, amelyet egy sofőr az adott országban a kútnál használna (UA `diesel` → ДП, PL `petrol` → Pb95). Egyszerű, koordináták nélküli országos átlaghoz használja a `fuel` terméket, tiszta állomáskereséshez a `fuel-stations`-t, árrangsorhoz a `fuel-cheapest`-et.
GET https://nakordoni.eu/api/v2/data/fuel-local
— 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 a kút szintjén, km-ben (alapértelmezett 25, maximum 25; alias: radius). Ha ezen belül nincs kút, a válasz az országszintre esik vissza — a keresés magától soha nem bővül. |
fuel_type | Opcionális szűrő a kút szintjén: diesel | e5 | e10 | superplus | super100 | premdiesel | truckdiesel | hvo | lpg | cng | adblue | e85 | lng. Országszinten figyelmen kívül marad, ott mindig az adott ország által jelentett összes fajtát visszaadjuk. 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 a kút szintjén (alapértelmezett 5, max. 20) |
lang | A címkék és az országnév 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.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"
Frissítve