API κοντινών πρατηρίων καυσίμων Online
Τα πλησιέστερα πρατήρια καυσίμων σε ένα σημείο ή μια πόλη, με τρέχουσες τιμές ανά τύπο καυσίμου, ταξινομημένα κατά απόσταση. Η κάλυψη σε επίπεδο πρατηρίου εκτείνεται σε 39 ευρωπαϊκές χώρες και ΜΕΤΡΑΤΑΙ, δεν είναι σταθερή: κάθε κενή απάντηση επιστρέφει την τρέχουσα λίστα χωρών με τον αριθμό πρατηρίων ανά χώρα στο αντικείμενο coverage, περιορισμένη στην ποιότητα που ζητήσατε — γι' αυτό διαβάστε εκείνο, όχι μια λίστα σε αυτήν την περιγραφή — τα ίδια δεδομένα με τις σελίδες καυσίμων του nakordoni.eu· χρησιμοποιήστε τη λειτουργία country του fuel API για εθνικούς μέσους όρους αλλού. Οι τιμές επιστρέφονται στο δικό της νόμισμα κάθε πρατηρίου (PLN για πολωνικά πρατήρια, EUR αλλού) — διαβάστε το πεδίο currency κάθε πρατηρίου, μη συγκρίνετε ποτέ τους ακατέργαστους αριθμούς. Όταν κανένα πρατήριο δεν ταιριάζει, η απάντηση περιλαμβάνει ένα αντικείμενο coverage αντί για μια σιωπηλή κενή λίστα: station_countries και station_counts, μετρημένα από τον ζωντανό δείκτη (περιορισμένα στο `grade` όταν έχετε ονομάσει ένα fuel_type), sparse_coverage για τις χώρες με 25 ή λιγότερα τιμολογημένα πρατήρια, measured_at, και ένα fuel_type_note που διαχωρίζει τους δύο λόγους για τους οποίους μια απάντηση μπορεί να είναι κενή — ένα όνομα ποιότητας που δεν μπορέσαμε να εντοπίσουμε, έναντι μιας ποιότητας που αναγνωρίζουμε αλλά δεν τιμολογούμε σε εκείνη τη χώρα.
GET https://nakordoni.eu/api/v2/data/fuel-stations
— κλάση ποσόστωσης: cheap
| Παράμετρος | Περιγραφή |
|---|---|
lat | Γεωγραφικό πλάτος |
lon | Γεωγραφικό μήκος |
city | Όνομα πόλης — εναλλακτική του lat/lon, μετατρέπεται σε συντεταγμένες |
country | Κωδικός χώρας ISO-2, αποσαφηνίζει την πόλη |
radius_km | Ακτίνα αναζήτησης σε χλμ (προεπιλογή 25, μέγιστο 25· alias: radius) |
fuel_type | Προαιρετικό φίλτρο: diesel | e5 | e10 | superplus | super100 | premdiesel | truckdiesel | hvo | lpg | cng | adblue | e85 | lng (η διαθεσιμότητα διαφέρει ανά πρατήριο/περιοχή· τα πολωνικά πρατήρια αναφέρουν το Pb95 ως e5, το Pb98 ως superplus και το ON ως diesel). Γίνονται δεκτές και οι τοπικές ονομασίες αντλίας — ON, Olej napędowy, Pb95, Nafta, Dizel, Gázolaj, Motorină, Benzină 95, ДП, А-95, Motorin, Gasóleo, Sans plomb 95, Bleifrei … — και αντιστοιχίζονται με βάση το `country` (ή, για τα προϊόντα συντεταγμένων, τη χώρα στην οποία εμπίπτει το σημείο), επειδή η ίδια διατύπωση δεν σημαίνει παντού τον ίδιο τύπο: το «95» είναι E10 σε δανική, φινλανδική, γαλλική, βρετανική, βελγική ή ολλανδική αντλία και E5 σε πολωνική ή γερμανική. Η απόκριση επιστρέφει τα `fuel_type` (κανονικό), `fuel_type_requested` (όπως το πληκτρολογήσατε) και `fuel_type_local`. Μια ονομασία που δεν μπορούμε να εντοπίσουμε δεν αντικαθίσταται ποτέ από προεπιλεγμένο τύπο· η απόκριση επιστρέφει κενή και το δηλώνει. Πλήρης πίνακας ονομασιών ανά χώρα: /api/v2/data/fuel-grades. |
limit | Μέγιστος αριθμός πρατηρίων (προεπιλογή 5, μέγιστο 20) |
lang | Γλώσσα των ετικετών (προεπιλογή en) |
Πεδία της απάντησης — μέσα στο αντικείμενο data του φακέλου απάντησης. Το [] δηλώνει λίστα, άρα το data.items[].name είναι το πεδίο name κάθε στοιχείου. Ένα πεδίο είναι null, απουσιάζει ή είναι κενή λίστα όταν δεν έχουμε τιμή — ποτέ κάτι εικονικό.
| Πεδίο | Περιγραφή |
|---|---|
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"
Ενημερώθηκε