API für Tankstellen in der Nähe Online
Die nächstgelegenen Tankstellen zu einem Punkt oder einer Stadt mit aktuellen Preisen je Kraftstoffart, sortiert nach Entfernung. 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 — dieselben Daten wie die Kraftstoffseiten von nakordoni.eu; für nationale Durchschnittswerte anderswo nutzen Sie den country-Modus der fuel API. Preise werden in der jeweils eigenen Währung der Station zurückgegeben (PLN für polnische Stationen, EUR sonst) — lesen Sie das currency-Feld je Station, vergleichen Sie niemals die reinen Zahlen. 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-stations
— 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 | Optionaler Filter: diesel | e5 | e10 | superplus | super100 | premdiesel | truckdiesel | hvo | lpg | cng | adblue | e85 | lng (Verfügbarkeit variiert je Station/Region; polnische Stationen melden Pb95 als e5, Pb98 als superplus und ON als diesel). Lokale Zapfsäulen-Bezeichnungen 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 gegen `country` aufgelöst (bzw. bei Koordinatenprodukten gegen das Land, in das der Punkt fällt), denn dieselbe Bezeichnung meint nicht überall 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` (so, wie Sie es eingegeben haben) und `fuel_type_local` zurück. Ein Name, den wir nicht zuordnen können, wird niemals durch eine Standardsorte ersetzt — die Antwort kommt leer zurück und sagt das auch. 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.anchor.lat | The point actually searched (after city geocoding), with lng, ppid and radius_km. |
data.anchor.fuel_type | The canonical grade the list was filtered to; fuel_type_requested is what you sent, fuel_type_local the local pump name and fuel_type_country the country the name was read in. |
data.stations[].name | Station, with brand and address. Each physical station appears ONCE: its grades are nested under prices, not spread over repeated rows. `brand` is the chain when we know it and null when we do not — never a placeholder token, so treat null as "independent or unknown" and fall back to `name`. Address detail varies by national feed: some report a full street address, others only the town. |
data.stations[].station_ref | Stable key for the station (name + position). Key your records on it whenever id is null — id is set only for rows that come from our station directory. |
data.stations[].prices | Object keyed by grade (diesel, e5, e10, lpg …): price, currency and currency_symbol, local_name (the pump name used in that country), label, updated_at, confirmed_at, age_hours and stale. Each station carries its own currency, so never compare the raw numbers. A station with no quote at all carries an empty object here. TWO CLOCKS, and they answer different questions — do not derive one from the other: `updated_at` is when this price last MOVED, so a forecourt that has held the same price for ten days keeps a ten-day-old stamp and that is correct, not stale data; `confirmed_at` is when we last CONFIRMED the quote against its feed, and it is the clock `age_hours` and `stale` are measured on (age_hours = now − confirmed_at). Read `confirmed_at`/`stale` for freshness and `updated_at` for price history. Both are floored to the hour, so `now − confirmed_at` can sit up to an hour above `age_hours`, which is measured before the floor; `confirmed_at` is never earlier than `updated_at`, because a price change is itself a confirmation. |
data.stations[].grades | The grade keys present in prices, alongside freshest_age_hours and a station-level stale flag (true only when NO quote of that station is current). |
data.stations[].distance_km | Distance from the anchor, with lat and lng of the station itself. |
data.count | Stations returned; data.total_found is how many matched inside the radius before limit was applied. |
data.notices | Present whenever we adjusted a parameter you sent: each entry names the param, the requested and the applied value, and the reason. |
data.coverage | Only when nothing matched. grade (the fuel_type your wording resolved to, or null), station_countries and station_counts measured from the live station index and scoped to that grade, sparse_coverage for countries with 25 priced stations or fewer, measured_at, a note explaining all of it, and fuel_type_note when the grade name could not be placed OR when we recognise the grade but price it nowhere in this country. |
curl "https://nakordoni.eu/api/v2/data/fuel-stations?city=Munich&country=DE&radius_km=20&fuel_type=diesel" \ -H "Authorization: Bearer NKD-DEV-XXXX-XXXX-XXXX"
Aktualisiert