API nejlevnějšího paliva v okolí Online
Nejlevnější čerpací stanice v okolí bodu nebo města, seřazené podle ceny pro zvolený druh paliva (při shodě vítězí bližší stanice). Pokrytí na úrovni stanic zahrnuje 39 evropských zemí a je MĚŘENÉ, nikoli pevně dané: každá prázdná odpověď vrací aktuální seznam zemí s počtem stanic pro každou zemi v objektu coverage, omezený na značku (grade), na kterou jste se ptali — vycházejte z toho, ne ze seznamu v tomto popisu. Pořadí se sestavuje pro jeden druh paliva v rámci jedné oblasti hledání a ceny nesou vlastní měnu dané stanice (PLN v Polsku, EUR jinde). Pokud žádná stanice neodpovídá, odpověď obsahuje objekt coverage místo tiše prázdného seznamu: station_countries a station_counts naměřené z aktuálního indexu (omezené na `grade`, pokud byl uveden fuel_type), sparse_coverage pro země s 25 nebo méně oceněnými stanicemi, measured_at a fuel_type_note, která rozlišuje dva důvody prázdné odpovědi — název značky, kterou se nepodařilo rozpoznat, oproti značce, kterou rozpoznáváme, ale v dané zemi ji neoceňujeme.
GET https://nakordoni.eu/api/v2/data/fuel-cheapest
— třída kvóty: cheap
| Parametr | Popis |
|---|---|
lat | Zeměpisná šířka |
lon | Zeměpisná délka |
city | Název města — alternativa k lat/lon, převede se na souřadnice |
country | Kód země ISO-2, upřesňuje město |
radius_km | Poloměr hledání v km (výchozí 25, max. 25; alias: radius) |
fuel_type | diesel (výchozí) | e5 | e10 | superplus | super100 | premdiesel | truckdiesel | hvo | lpg | cng | adblue | e85 | lng — cenové pořadí se sestavuje pro každý druh paliva zvlášť. Přijímáme i místní názvy z výdejních stojanů — ON, Olej napędowy, Pb95, Nafta, Dizel, Gázolaj, Motorină, Benzină 95, ДП, А-95, Motorin, Gasóleo, Sans plomb 95, Bleifrei … — rozlišují se podle `country` (u produktů se souřadnicemi podle země, do níž bod spadá), protože stejné označení neznamená všude stejný druh: „95“ je na dánském, finském, francouzském, britském, belgickém či nizozemském stojanu E10 a na polském nebo německém E5. Odpověď vrací `fuel_type` (kanonický), `fuel_type_requested` (v podobě, jakou jste zadali) a `fuel_type_local`. Název, který nedokážeme zařadit, nikdy nenahrazujeme výchozím druhem — odpověď přijde prázdná a uvede to. Úplná tabulka názvů podle zemí: /api/v2/data/fuel-grades. |
limit | Maximum stanic (výchozí 5, max. 20) |
lang | Jazyk popisků (výchozí en) |
Pole odpovědi — uvnitř objektu data v obálce odpovědi. [] označuje seznam, takže data.items[].name je pole name každého prvku. Pole bývá null, chybí nebo je prázdný seznam, když pro něj nemáme hodnotu — zástupný údaj nedoplňujeme.
| Pole | Popis |
|---|---|
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"
Aktualizováno