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"