API pentru prețuri locale la carburanți Online
Cel mai bun preț disponibil al carburantului pentru ORICE punct din Europa, determinat printr-o scară de rezervă în trei niveluri, astfel încât o coordonată să nu se întoarcă niciodată goală acolo unde avem cât de cât date: prețuri de la pompă de la cele mai apropiate stații, atunci când punctul se află în acoperirea la nivel de stație (astăzi 39 de țări; lista exactă cu numărul de stații pentru fiecare țară revine în obiectul coverage al oricărui răspuns gol fuel-stations, niciodată dintr-o listă scrisă aici), altfel media regională pentru regiunea administrativă în care se află punctul (astăzi doar Ucraina — fluxul de oblasturi UA, în UAH), altfel media națională pentru țară. Fiecare răspuns poartă un câmp `resolution` care denumește nivelul care a răspuns — `station` (datele sunt o listă de stații cu distance_km, fiecare în moneda proprie), `region` (un obiect de medie pe oblast plus `region`, un cod ISO 3166-2 precum UA-46, `region_name` și `region_center_dist_km`) sau `country` (un obiect de medie națională). Nivelurile region și country returnează aceleași chei de preț: petrol/petrol95plus/petrol92/diesel/lpg + currency + data actualizării. Ramificați logica după `resolution`, niciodată după formă. Ucraina nu are prețuri la nivel de stație nicăieri, așa că un punct din UA primește răspuns la nivelul `region` acolo unde oblastul are preț cotat și revine la `country` altfel. 404 atunci când punctul se află în afara oricărei țări acoperite (în larg, în afara Europei). Nivelurile region și country poartă și un obiect `grades` care asociază fiecare cheie de preț sortimentului său canonic și numelui pe care un șofer din acea țară l-ar folosi la pompă (UA `diesel` → ДП, PL `petrol` → Pb95). Pentru o simplă medie națională fără coordonate folosiți produsul `fuel`, pentru o căutare pură de stații `fuel-stations`, pentru clasarea după preț `fuel-cheapest`.
GET https://nakordoni.eu/api/v2/data/fuel-local
— 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 la nivel de stație, în km (implicit 25, maximum 25; alias: radius). Dacă nu există nicio stație în interiorul ei, răspunsul trece la nivelul de țară — căutarea nu se extinde niciodată de la sine. |
fuel_type | Filtru opțional la nivel de stație: diesel | e5 | e10 | superplus | super100 | premdiesel | truckdiesel | hvo | lpg | cng | adblue | e85 | lng. Este ignorat la nivel de țară, care returnează întotdeauna toate sortimentele raportate de țara respectivă. 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, țara în care cade punctul), pentru că aceeași formulare nu înseamnă același sortiment peste tot: „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. Tabelul complet al denumirilor pe țări: /api/v2/data/fuel-grades. |
limit | Număr maxim de stații la nivelul stațiilor (implicit 5, maxim 20) |
lang | Limba etichetelor și a numelui țării (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.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"
Actualizat