API najtańszego paliwa w pobliżu Online
Najtańsze stacje paliw w okolicy punktu lub miasta, uszeregowane według ceny dla wybranego rodzaju paliwa (przy remisie wygrywa stacja bliższa). Zasięg na poziomie stacji obejmuje 39 krajów europejskich i jest MIERZONY, a nie ustalony na sztywno: każda pusta odpowiedź zwraca aktualną listę krajów wraz z liczbą stacji dla każdego kraju w obiekcie coverage, ograniczoną do gatunku (grade), o który zapytano — czytaj tę wartość, a nie listę w tym opisie. Ranking jest tworzony dla jednego rodzaju paliwa w obrębie jednego obszaru wyszukiwania, a ceny podawane są w walucie właściwej dla danej stacji (PLN w Polsce, EUR gdzie indziej). Gdy żadna stacja nie pasuje, odpowiedź zawiera obiekt coverage zamiast cichej pustej listy: station_countries i station_counts zmierzone na podstawie aktywnego indeksu (ograniczone do `grade`, jeśli podano fuel_type), sparse_coverage dla krajów mających 25 lub mniej stacji z cenami, measured_at oraz fuel_type_note, które rozróżnia dwa powody pustej odpowiedzi — nazwę gatunku, której nie udało się rozpoznać, od gatunku rozpoznanego, ale niewycenianego w danym kraju.
GET https://nakordoni.eu/api/v2/data/fuel-cheapest
— klasa limitu: cheap
| Parametr | Opis |
|---|---|
lat | Szerokość geograficzna |
lon | Długość geograficzna |
city | Nazwa miasta — alternatywa dla lat/lon, zamieniana na współrzędne |
country | Kod kraju ISO-2, ujednoznacznia miasto |
radius_km | Promień wyszukiwania w km (domyślnie 25, maks. 25; alias: radius) |
fuel_type | diesel (domyślnie) | e5 | e10 | superplus | super100 | premdiesel | truckdiesel | hvo | lpg | cng | adblue | e85 | lng — ranking cenowy jest liczony osobno dla każdego rodzaju paliwa. Lokalne nazwy z dystrybutorów są również akceptowane — ON, Olej napędowy, Pb95, Nafta, Dizel, Gázolaj, Motorină, Benzină 95, ДП, А-95, Motorin, Gasóleo, Sans plomb 95, Bleifrei … — rozpoznawane w kontekście `country` (a w produktach współrzędnych — kraju, w którym leży punkt), ponieważ to samo określenie nie wszędzie oznacza ten sam gatunek: „95” to E10 na dystrybutorze duńskim, fińskim, francuskim, brytyjskim, belgijskim czy niderlandzkim, a E5 na polskim lub niemieckim. W odpowiedzi zwracane są `fuel_type` (kanoniczny), `fuel_type_requested` (w postaci wpisanej przez Ciebie) oraz `fuel_type_local`. Nazwa, której nie potrafimy przypisać, nigdy nie jest podmieniana na gatunek domyślny — odpowiedź wraca pusta i to sygnalizuje. Pełna tabela nazw według krajów: /api/v2/data/fuel-grades. |
limit | Maks. liczba stacji (domyślnie 5, maks. 20) |
lang | Język etykiet (domyślnie en) |
Pola odpowiedzi — wewnątrz obiektu data w kopercie odpowiedzi. [] oznacza listę, więc data.items[].name to pole name każdego elementu. Pole bywa null, nieobecne lub jest pustą listą, gdy nie mamy wartości — nigdy nie wstawiamy atrapy.
| Pole | Opis |
|---|---|
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"
Zaktualizowano