API τοπικών τιμών καυσίμων Online
Η καλύτερη διαθέσιμη τιμή καυσίμου για ΟΠΟΙΟΔΗΠΟΤΕ σημείο στην Ευρώπη, προσδιορισμένη μέσω μιας τριών επιπέδων κλίμακας εναλλακτικών λύσεων, ώστε μια συντεταγμένη να μην επιστρέφει ποτέ κενή εκεί όπου έχουμε έστω και κάποια δεδομένα: τιμές αντλίας από τα πλησιέστερα πρατήρια όταν το σημείο βρίσκεται εντός της κάλυψης σε επίπεδο πρατηρίου (39 χώρες σήμερα· η ακριβής λίστα με τους αριθμούς ανά χώρα επιστρέφεται στο αντικείμενο coverage κάθε κενής απάντησης fuel-stations, ποτέ από μια λίστα γραμμένη εδώ), αλλιώς — ο περιφερειακός μέσος όρος για τη διοικητική περιφέρεια στην οποία βρίσκεται το σημείο (μόνο η Ουκρανία σήμερα — η ροή δεδομένων ανά ουκρανική περιφέρεια (oblast), σε UAH), αλλιώς — ο εθνικός μέσος όρος για τη χώρα. Κάθε απάντηση φέρει ένα πεδίο `resolution` που ονομάζει το επίπεδο που απάντησε — `station` (τα δεδομένα είναι μια λίστα πρατηρίων με distance_km, το καθένα στο δικό του νόμισμα), `region` (ένα αντικείμενο μέσου όρου oblast συν `region`, έναν κωδικό ISO 3166-2 όπως UA-46, `region_name` και `region_center_dist_km`) ή `country` (ένα αντικείμενο εθνικού μέσου όρου). Τα επίπεδα region και country επιστρέφουν τα ίδια κλειδιά τιμής: petrol/petrol95plus/petrol92/diesel/lpg + currency + ημερομηνία ενημέρωσης. Διακλαδωθείτε βάσει του `resolution`, ποτέ βάσει της μορφής. Η Ουκρανία δεν έχει τιμές ανά πρατήριο πουθενά, οπότε ένα σημείο UA απαντά στο επίπεδο `region`, όπου η περιφέρεια τιμολογείται, και αλλιώς πέφτει σε `country`. 404 όταν το σημείο βρίσκεται εκτός κάθε καλυπτόμενης χώρας (στη μέση του ωκεανού, εκτός Ευρώπης). Τα επίπεδα region και country φέρουν επίσης ένα αντικείμενο `grades` που αντιστοιχίζει κάθε κλειδί τιμής με την κανονική του ποιότητα και με το όνομα που θα χρησιμοποιούσε ένας οδηγός σε εκείνη τη χώρα στην αντλία (UA `diesel` → ДП, PL `petrol` → Pb95). Για έναν απλό εθνικό μέσο όρο χωρίς συντεταγμένες χρησιμοποιήστε το προϊόν `fuel`, για καθαρή αναζήτηση πρατηρίων το `fuel-stations`, για κατάταξη κατά τιμή το `fuel-cheapest`.
GET https://nakordoni.eu/api/v2/data/fuel-local
— κλάση ποσόστωσης: cheap
| Παράμετρος | Περιγραφή |
|---|---|
lat | Γεωγραφικό πλάτος |
lon | Γεωγραφικό μήκος |
city | Όνομα πόλης — εναλλακτική του lat/lon, μετατρέπεται σε συντεταγμένες |
country | Κωδικός χώρας ISO-2, αποσαφηνίζει την πόλη |
radius_km | Ακτίνα αναζήτησης σε επίπεδο πρατηρίου σε km (προεπιλογή 25, μέγιστο 25· εναλλακτικό όνομα: 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.resolution | Which tier answered: station | region | country. Branch on this, never on the shape. |
data.anchor | The point the answer was resolved for: lat, lng, ppid, radius_km and the fuel_type fields. |
data.country | ISO-2 country the point fell in; region is its ISO 3166-2 code at the region tier. |
data.data | At station tier a list of stations (see fuel-stations). At region and country tier one averages object: petrol, petrol95plus, petrol92, petrol98, diesel, lpg, lpg_eur, currency, updated, trend_petrol, trend_diesel, country_name. |
data.data.region_name | Region tier only: the region's name, with region_center_dist_km — how far its centre sits from your point. |
data.grades | Region and country tier only: each price key mapped to its canonical grade and the local pump name. |
data.labels | Localised UI strings — for rendering, not data. |
curl "https://nakordoni.eu/api/v2/data/fuel-local?lat=50.45&lon=30.52&lang=uk" \ -H "Authorization: Bearer NKD-DEV-XXXX-XXXX-XXXX"
Ενημερώθηκε