API локальних цін на пальне Online
Найкраща доступна ціна на пальне для БУДЬ-ЯКОЇ точки в Європі, яка визначається за трирівневою резервною драбиною так, щоб координата ніколи не поверталася порожньою там, де хоч якісь дані взагалі є: ціни на колонках від найближчих станцій, коли точка перебуває в зоні покриття на рівні станцій (сьогодні 39 країн; точний перелік із кількістю станцій по кожній країні повертається в об'єкті coverage будь-якої порожньої відповіді fuel-stations, а не з переліку, зафіксованого тут), інакше — регіональне середнє для адміністративного регіону, до якого належить точка (сьогодні лише Україна — фід областей UA, у 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 | Радіус пошуку на рівні заправок у км (за замовчуванням 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"
Оновлено