API lokalnih cena goriva Online
Најбоља доступна цена горива за БИЛО КОЈУ тачку у Европи, одређена кроз тростепену лествицу резервних опција тако да се координата никада не враћа празна тамо где уопште имамо податке: цене на пумпи са најближих станица када је тачка унутар покривености на нивоу станице (39 земаља данас; тачна листа са бројем по земљи враћа се у coverage објекту сваког празног fuel-stations одговора, никада из листе записане овде), иначе — регионални просек за административни регион у који тачка спада (само Украјина данас — украјински извор по областима, у UAH), иначе — национални просек за земљу. Сваки одговор носи поље `resolution` које именује ниво који је одговорио — `station` (подаци су листа станица са distance_km, свака у сопственој валути), `region` (један објекат са просеком по области плус `region`, ISO 3166-2 код попут UA-46, `region_name` и `region_center_dist_km`) или `country` (један објекат са националним просеком). Нивои region и country враћају исте кључеве за цену: petrol/petrol95plus/petrol92/diesel/lpg + currency + датум ажурирања. Гранајте се према `resolution`, никада према облику. Украјина нигде нема цене по станицама, па тачка у UA добија одговор на нивоу `region`, где је област наведена са ценом, а иначе пада на `country`. 404 када је тачка изван сваке покривене земље (насред океана, ван Европе). Нивои region и country такође носе `grades` објекат који мапира сваки кључ цене на његову канонску марку и на назив који би возач у тој земљи користио на пумпи (UA `diesel` → ДП, PL `petrol` → Pb95). За обичан национални просек без координата користите производ `fuel`, за чисто претраживање станица `fuel-stations`, за рангирање по цени `fuel-cheapest`.
GET https://nakordoni.eu/api/v2/data/fuel-local
— класа квоте: cheap
| Параметар | Опис |
|---|---|
lat | Географска ширина |
lon | Географска дужина |
city | Назив града — алтернатива за lat/lon, претвара се у координате |
country | ISO-2 код земље, прецизира град |
radius_km | Полупречник претраге на нивоу пумпе у km (подразумевано 25, највише 25; алијас: radius). Ако у њему нема ниједне пумпе, одговор прелази на ниво земље — претрага се никада сама не проширује. |
fuel_type | Опциони филтер на нивоу пумпе: diesel | e5 | e10 | superplus | super100 | premdiesel | truckdiesel | hvo | lpg | cng | adblue | e85 | lng. На нивоу земље се занемарује — тамо се увек враћају све врсте које земља пријављује. Прихватају се и локални називи са точионика — ON, Olej napędowy, Pb95, Nafta, Dizel, Gázolaj, Motorină, Benzină 95, ДП, А-95, Motorin, Gasóleo, Sans plomb 95, Bleifrei … — они се разрешавају према `country` (а код производа са координатама, према земљи у коју тачка пада), јер иста формулација не значи свуда исту врсту: „95“ је E10 на данском, финском, француском, британском, белгијском или холандском точионику, а E5 на пољском или немачком. Одговор враћа `fuel_type` (канонски), `fuel_type_requested` (онако како сте га унели) и `fuel_type_local`. Назив који не можемо да сврстамо никада се не замењује подразумеваном врстом — одговор стиже празан и то наводи. Потпуна табела назива по земљама: /api/v2/data/fuel-grades. |
limit | Максимум пумпи на нивоу пумпи (подразумевано 5, макс. 20) |
lang | Језик ознака и назива земље (подразумевано en) |
Поља одговора — унутар објекта data у коверти одговора. [] означава листу, па је data.items[].name поље name сваког елемента. Поље је null, недостаје или је празна листа када немамо вредност — никада не убацујемо замену.
| Поље | Опис |
|---|---|
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"
Ažurirano