API најјефтиног горива у близини Online
Најјефтиније бензинске станице око одређене тачке или града, рангиране по цени за изабрану врсту горива (у случају изједначења победује најближа). Покривеност на нивоу станице обухвата 39 европских земаља и МЕРИ СЕ, а није фиксна: сваки празан одговор враћа тренутну листу земаља са бројем станица по земљи у свом coverage објекту, ограниченим на grade који сте тражили — зато читајте то, а не листу у овом опису. Рангирање је по врсти горива унутар једне области претраге, а цене носе сопствену валуту сваке станице (PLN у Пољској, EUR на другим местима). Када ниједна станица не одговара, одговор садржи coverage објекат уместо тихе празне листе: station_countries и station_counts измерени из живог индекса (ограничени на `grade` када сте навели fuel_type), sparse_coverage за земље са 25 или мање станица са ценама, measured_at и fuel_type_note који раздваја два разлога зашто одговор може бити празан — назив марке који нисмо могли да препознамо, наспрам марке коју препознајемо али је не ценимо у тој земљи.
GET https://nakordoni.eu/api/v2/data/fuel-cheapest
— класа квоте: cheap
| Параметар | Опис |
|---|---|
lat | Географска ширина |
lon | Географска дужина |
city | Назив града — алтернатива за lat/lon, претвара се у координате |
country | ISO-2 код земље, прецизира град |
radius_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.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"
Ažurirano