API lokalnych cen paliw Online
Najlepsza dostępna cena paliwa dla DOWOLNEGO punktu w Europie, wyznaczana wg trzypoziomowej drabinki zapasowej, tak aby współrzędne nigdy nie zwracały pustej odpowiedzi tam, gdzie w ogóle mamy jakiekolwiek dane: ceny na dystrybutorach z najbliższych stacji, gdy punkt znajduje się w zasięgu na poziomie stacji (obecnie 39 krajów; dokładna lista wraz z liczbą stacji dla każdego kraju wraca w obiekcie coverage każdej pustej odpowiedzi fuel-stations, nigdy z listy zapisanej tutaj), w przeciwnym razie średnia regionalna dla jednostki administracyjnej, w której leży punkt (obecnie tylko Ukraina — kanał danych dla obwodów UA, w UAH), w ostateczności średnia krajowa dla danego kraju. Każda odpowiedź zawiera pole `resolution`, wskazujące poziom, który odpowiedział — `station` (dane to lista stacji z distance_km, każda we własnej walucie), `region` (jeden obiekt średniej dla obwodu wraz z `region`, kodem ISO 3166-2, np. UA-46, `region_name` i `region_center_dist_km`) lub `country` (jeden obiekt średniej krajowej). Poziomy region i country zwracają te same klucze cenowe: petrol/petrol95plus/petrol92/diesel/lpg + currency + datę aktualizacji. Rozgałęziaj logikę na podstawie `resolution`, nigdy na podstawie kształtu danych. Ukraina nie ma nigdzie cen na poziomie stacji, więc punkt UA otrzymuje odpowiedź na poziomie `region`, gdy dany obwód jest wyceniany, a w przeciwnym razie spada do poziomu `country`. Odpowiedź 404, gdy punkt leży poza wszystkimi obsługiwanymi krajami (środek oceanu, poza Europą). Poziomy region i country zawierają też obiekt `grades`, mapujący każdy klucz cenowy na jego kanoniczny gatunek oraz na nazwę, jakiej użyłby kierowca w danym kraju na dystrybutorze (UA `diesel` → ДП, PL `petrol` → Pb95). Do zwykłej średniej krajowej bez współrzędnych użyj produktu `fuel`, do czystego wyszukiwania stacji — `fuel-stations`, do rankingu cen — `fuel-cheapest`.
GET https://nakordoni.eu/api/v2/data/fuel-local
— 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 na poziomie stacji w km (domyślnie 25, maks. 25; alias: radius). Brak stacji w tym promieniu oznacza, że odpowiedź przechodzi na poziom kraju — wyszukiwanie nigdy nie rozszerza się samo. |
fuel_type | Opcjonalny filtr na poziomie stacji: diesel | e5 | e10 | superplus | super100 | premdiesel | truckdiesel | hvo | lpg | cng | adblue | e85 | lng. Ignorowany na poziomie kraju, który zawsze zwraca wszystkie gatunki raportowane przez dany kraj. 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 na poziomie stacji (domyślnie 5, maks. 20) |
lang | Język etykiet i nazwy kraju (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.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"
Zaktualizowano