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"