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"
Оновлено