API φθηνότερου καυσίμου σε κοντινή απόσταση Online
Τα φθηνότερα πρατήρια καυσίμων γύρω από ένα σημείο ή μια πόλη, κατατεταγμένα κατά τιμή για τον επιλεγμένο τύπο καυσίμου (σε ισοπαλία νικά το πλησιέστερο). Η κάλυψη σε επίπεδο πρατηρίου εκτείνεται σε 39 ευρωπαϊκές χώρες και ΜΕΤΡΑΤΑΙ, δεν είναι σταθερή: κάθε κενή απάντηση επιστρέφει την τρέχουσα λίστα χωρών με τον αριθμό πρατηρίων ανά χώρα στο αντικείμενο coverage, περιορισμένη στην ποιότητα που ζητήσατε — γι' αυτό διαβάστε εκείνο, όχι μια λίστα σε αυτήν την περιγραφή. Η κατάταξη γίνεται ανά τύπο καυσίμου εντός μίας περιοχής αναζήτησης, και οι τιμές φέρουν το δικό της νόμισμα κάθε πρατηρίου (PLN στην Πολωνία, EUR αλλού). Όταν κανένα πρατήριο δεν ταιριάζει, η απάντηση περιλαμβάνει ένα αντικείμενο coverage αντί για μια σιωπηλή κενή λίστα: station_countries και station_counts, μετρημένα από τον ζωντανό δείκτη (περιορισμένα στο `grade` όταν έχετε ονομάσει ένα fuel_type), sparse_coverage για τις χώρες με 25 ή λιγότερα τιμολογημένα πρατήρια, measured_at, και ένα fuel_type_note που διαχωρίζει τους δύο λόγους για τους οποίους μια απάντηση μπορεί να είναι κενή — ένα όνομα ποιότητας που δεν μπορέσαμε να εντοπίσουμε, έναντι μιας ποιότητας που αναγνωρίζουμε αλλά δεν τιμολογούμε σε εκείνη τη χώρα.
GET https://nakordoni.eu/api/v2/data/fuel-cheapest
— κλάση ποσόστωσης: 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 — η κατάταξη κατά τιμή γίνεται ανά τύπο καυσίμου. Γίνονται δεκτές και οι τοπικές ονομασίες αντλίας — 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.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"
Ενημερώθηκε