API lokálních cen paliv Online
Nejlepší dostupná cena paliva pro JAKÝKOLI bod v Evropě, určená po třístupňovém záložním žebříčku tak, aby se souřadnice nikdy nevrátila prázdná tam, kde máme vůbec nějaká data: ceny u výdejních stojanů z nejbližších stanic, pokud bod leží v pokrytí na úrovni stanic (dnes 39 zemí; přesný seznam s počtem stanic pro každou zemi se vrací v objektu coverage jakékoli prázdné odpovědi fuel-stations, nikdy ze seznamu zapsaného zde), jinak regionální průměr pro správní region, do kterého bod spadá (dnes pouze Ukrajina — feed oblastí UA, v UAH), jinak národní průměr pro danou zemi. Každá odpověď nese pole `resolution`, které pojmenovává úroveň, jež odpověděla — `station` (data jsou seznam stanic s distance_km, každá ve vlastní měně), `region` (jeden objekt oblastního průměru plus `region`, kód ISO 3166-2 jako UA-46, `region_name` a `region_center_dist_km`) nebo `country` (jeden objekt národního průměru). Úrovně region a country vracejí stejné cenové klíče: petrol/petrol95plus/petrol92/diesel/lpg + currency + datum aktualizace. Větvěte logiku podle `resolution`, nikdy podle tvaru dat. Ukrajina nemá nikde ceny na úrovni stanic, takže bod v UA dostane odpověď na úrovni `region`, pokud je daná oblast oceněná, jinak spadne na `country`. 404, pokud bod leží mimo všechny pokryté země (otevřený oceán, mimo Evropu). Úrovně region a country nesou také objekt `grades`, který mapuje každý cenový klíč na jeho kanonickou značku a na název, který by řidič v dané zemi použil u stojanu (UA `diesel` → ДП, PL `petrol` → Pb95). Pro obyčejný národní průměr bez souřadnic použijte produkt `fuel`, pro čisté vyhledávání stanic `fuel-stations`, pro řazení podle ceny `fuel-cheapest`.
GET https://nakordoni.eu/api/v2/data/fuel-local
— 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í na úrovni stanic v km (výchozí 25, maximum 25; alias: radius). Není-li v něm žádná stanice, odpověď propadne na úroveň země — hledání se nikdy nerozšíří samo. |
fuel_type | Volitelný filtr na úrovni čerpacích stanic: diesel | e5 | e10 | superplus | super100 | premdiesel | truckdiesel | hvo | lpg | cng | adblue | e85 | lng. Na úrovni země se ignoruje, tam se vždy vracejí všechny druhy, které daná země hlásí. 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 na úrovni stanic (výchozí 5, max. 20) |
lang | Jazyk popisků a názvu země (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.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"
Aktualizováno