API für lokale Kraftstoffpreise Online
Der beste verfügbare Kraftstoffpreis für JEDEN Punkt in Europa, ermittelt über eine dreistufige Fallback-Kette, sodass eine Koordinate niemals leer zurückkommt, wo überhaupt Daten vorliegen: Zapfsäulenpreise der nächstgelegenen Stationen, wenn der Punkt innerhalb der Abdeckung auf Stationsebene liegt (heute 39 Länder; die genaue Liste mit Stationszahlen pro Land kommt im coverage-Objekt jeder leeren fuel-stations-Antwort zurück, niemals aus einer hier festgeschriebenen Liste), andernfalls der regionale Durchschnitt für die Verwaltungsregion, in die der Punkt fällt (heute nur Ukraine — der UA-Oblast-Feed, in UAH), andernfalls der nationale Durchschnitt für das Land. Jede Antwort trägt ein `resolution`-Feld, das die antwortende Stufe benennt — `station` (Daten sind eine Liste von Stationen mit distance_km, jede in eigener Währung), `region` (ein Oblast-Durchschnittsobjekt plus `region`, ein ISO-3166-2-Code wie UA-46, `region_name` und `region_center_dist_km`) oder `country` (ein nationales Durchschnittsobjekt). Die Stufen region und country liefern dieselben Preisschlüssel: petrol/petrol95plus/petrol92/diesel/lpg + currency + Aktualisierungsdatum. Verzweigen Sie anhand von `resolution`, niemals anhand der Form. Die Ukraine hat nirgends Preise auf Stationsebene, daher wird ein UA-Punkt auf Ebene `region` beantwortet, wenn der Oblast bepreist ist, und fällt sonst auf `country` zurück. 404, wenn der Punkt außerhalb jedes abgedeckten Landes liegt (Hochsee, außerhalb Europas). Die Stufen region und country tragen zudem ein `grades`-Objekt, das jeden Preisschlüssel seinem kanonischen Grad zuordnet sowie dem Namen, den ein Fahrer in diesem Land an der Zapfsäule verwenden würde (UA `diesel` → ДП, PL `petrol` → Pb95). Für einen einfachen nationalen Durchschnitt ohne Koordinaten nutzen Sie das Produkt `fuel`, für eine reine Stationssuche `fuel-stations`, für eine Preisrangfolge `fuel-cheapest`.
GET https://nakordoni.eu/api/v2/data/fuel-local
— Kontingentklasse: cheap
| Parameter | Beschreibung |
|---|---|
lat | Breitengrad |
lon | Längengrad |
city | Städtename — Alternative zu lat/lon, wird in Koordinaten aufgelöst |
country | ISO-2-Ländercode, macht die Stadt eindeutig |
radius_km | Suchradius auf Tankstellenebene in km (Standard 25, Maximum 25; Alias: radius). Liegt darin keine Tankstelle, fällt die Antwort auf die Länderebene zurück — die Suche wird nie von selbst erweitert. |
fuel_type | Optionaler Filter auf Tankstellenebene: diesel | e5 | e10 | superplus | super100 | premdiesel | truckdiesel | hvo | lpg | cng | adblue | e85 | lng. Auf Länderebene wird er ignoriert; dort werden immer alle vom Land gemeldeten Sorten zurückgegeben. Lokale Zapfsäulenbezeichnungen werden ebenfalls akzeptiert — ON, Olej napędowy, Pb95, Nafta, Dizel, Gázolaj, Motorină, Benzină 95, ДП, А-95, Motorin, Gasóleo, Sans plomb 95, Bleifrei … — sie werden im Kontext von `country` aufgelöst (bzw. bei Koordinatenprodukten anhand des Landes, in das der Punkt fällt), denn dieselbe Bezeichnung steht nicht überall für dieselbe Sorte: „95“ ist an einer dänischen, finnischen, französischen, britischen, belgischen oder niederländischen Zapfsäule E10 und an einer polnischen oder deutschen E5. Die Antwort gibt `fuel_type` (kanonisch), `fuel_type_requested` (wie eingegeben) und `fuel_type_local` zurück. Eine Bezeichnung, die wir nicht zuordnen können, wird nie durch eine Standardsorte ersetzt — die Antwort kommt leer zurück und weist darauf hin. Vollständige Namenstabelle je Land: /api/v2/data/fuel-grades. |
limit | Max. Tankstellen auf Stationsebene (Standard 5, max. 20) |
lang | Sprache der Bezeichnungen und des Ländernamens (Standard en) |
Antwortfelder — innerhalb des data-Objekts im Antwortumschlag. [] steht für eine Liste, data.items[].name ist also das Feld name jedes Elements. Ein Feld ist null, fehlt oder ist eine leere Liste, wenn wir keinen Wert dafür haben — nie ein Platzhalter.
| Feld | Beschreibung |
|---|---|
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"
Aktualisiert