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