API stații de combustibil din apropiere Online
Cele mai apropiate benzinării de un punct sau un oraș, cu prețuri curente pentru fiecare tip de carburant, sortate după distanță. Acoperirea la nivel de stație cuprinde 39 de țări europene și este MĂSURATĂ, nu fixă: orice răspuns gol returnează lista actuală de țări cu numărul de stații pentru fiecare țară în obiectul coverage, limitată la sortimentul solicitat — citiți această valoare, nu o listă din această descriere — aceleași date ca paginile de carburant de pe nakordoni.eu; pentru medii naționale în alte cazuri, folosiți modul country al fuel API. Prețurile sunt returnate în moneda proprie a fiecărei stații (PLN pentru stațiile poloneze, EUR în rest) — citiți câmpul currency pentru fiecare stație, nu comparați niciodată cifrele brute. Când nicio stație nu corespunde, răspunsul include un obiect coverage în loc de o listă goală tăcută: station_countries și station_counts măsurate din indexul live (limitate la `grade` atunci când ați indicat un fuel_type), sparse_coverage pentru țările cu 25 sau mai puține stații cu preț, measured_at și un fuel_type_note care separă cele două motive pentru care un răspuns poate fi gol — un nume de sortiment pe care nu l-am putut identifica, față de un sortiment pe care îl recunoaștem, dar nu îl prețuim în acea țară.
GET https://nakordoni.eu/api/v2/data/fuel-stations
— clasă de cotă: cheap
| Parametru | Descriere |
|---|---|
lat | Latitudine |
lon | Longitudine |
city | Numele orașului — alternativă la lat/lon, convertit în coordonate |
country | Cod de țară ISO-2, dezambiguizează orașul |
radius_km | Raza de căutare în km (implicit 25, maxim 25; alias: radius) |
fuel_type | Filtru opțional: diesel | e5 | e10 | superplus | super100 | premdiesel | truckdiesel | hvo | lpg | cng | adblue | e85 | lng (disponibilitatea variază în funcție de stație/regiune; stațiile poloneze raportează Pb95 ca e5, Pb98 ca superplus și ON ca diesel). Sunt acceptate și denumirile locale de la pompă — ON, Olej napędowy, Pb95, Nafta, Dizel, Gázolaj, Motorină, Benzină 95, ДП, А-95, Motorin, Gasóleo, Sans plomb 95, Bleifrei … — rezolvate în raport cu `country` (sau, pentru produsele pe coordonate, cu țara în care cade punctul), deoarece aceeași formulare nu înseamnă peste tot același sortiment: „95” este E10 la o pompă daneză, finlandeză, franceză, britanică, belgiană sau olandeză și E5 la una poloneză sau germană. Răspunsul returnează `fuel_type` (canonic), `fuel_type_requested` (așa cum l-ați scris) și `fuel_type_local`. O denumire pe care nu o putem identifica nu este niciodată înlocuită cu un sortiment implicit — răspunsul vine gol și o spune explicit. Tabelul complet al denumirilor pe țări: /api/v2/data/fuel-grades. |
limit | Număr maxim de stații (implicit 5, maxim 20) |
lang | Limba etichetelor (implicit en) |
Câmpurile răspunsului — în interiorul obiectului data din plicul răspunsului. [] marchează o listă, deci data.items[].name este câmpul name al fiecărui element. Un câmp este null, lipsește sau este o listă goală atunci când nu avem o valoare — niciodată un substitut.
| Câmp | Descriere |
|---|---|
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"
Actualizat