API für günstigsten Kraftstoff in der Nähe Online
Die günstigsten Tankstellen rund um einen Punkt oder eine Stadt, gereiht nach Preis für die gewählte Kraftstoffart (bei Gleichstand gewinnt die nächstgelegene). Die Abdeckung auf Stationsebene umfasst 39 europäische Länder und wird GEMESSEN, nicht fest vorgegeben: Jede leere Antwort liefert die aktuelle Länderliste mit Stationszahlen pro Land in ihrem coverage-Objekt, eingegrenzt auf die abgefragte grade — lesen Sie diese Angabe, nicht eine Liste in dieser Beschreibung. Die Rangfolge gilt je Kraftstoffart innerhalb eines Suchgebiets, und Preise tragen jeweils die eigene Währung der Station (PLN in Polen, EUR sonst). Wenn keine Station passt, enthält die Antwort ein coverage-Objekt statt einer stillschweigend leeren Liste: station_countries und station_counts, gemessen aus dem aktuellen Index (eingegrenzt auf `grade`, sofern ein fuel_type angegeben wurde), sparse_coverage für Länder mit 25 oder weniger bepreisten Stationen, measured_at sowie eine fuel_type_note, die zwischen den beiden Gründen für eine leere Antwort unterscheidet — ein Gradname, den wir nicht zuordnen konnten, gegenüber einem erkannten Grad, den wir in diesem Land aber nicht bepreisen.
GET https://nakordoni.eu/api/v2/data/fuel-cheapest
— 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 in km (Standard 25, max. 25; Alias: radius) |
fuel_type | diesel (Standard) | e5 | e10 | superplus | super100 | premdiesel | truckdiesel | hvo | lpg | cng | adblue | e85 | lng — das Preisranking erfolgt je Kraftstoffart. 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 (Standard 5, max. 20) |
lang | Sprache der Bezeichnungen (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.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"
Aktualisiert