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