API i karburantit më të lirë në afërsi Online
Stacionet e karburantit më të lira rreth një pike ose qyteti, të renditura sipas çmimit për llojin e zgjedhur të karburantit (në rast barazie fiton më i afërti). Mbulimi në nivel stacioni përfshin 39 vende evropiane dhe ËSHTË I MATUR, jo fiks: çdo përgjigje bosh kthen listën aktuale të vendeve me numrin e stacioneve për çdo vend në objektin e tij coverage, i kufizuar te cilësia që keni kërkuar — prandaj lexojeni atë, jo një listë në këtë përshkrim. Renditja bëhet për çdo lloj karburanti brenda një zone kërkimi, dhe çmimet mbajnë monedhën e vet secilit stacion (PLN në Poloni, EUR diku tjetër). Kur asnjë stacion nuk përputhet, përgjigja përfshin një objekt coverage në vend të një liste boshe të heshtur: station_countries dhe station_counts, të matura nga indeksi live (të kufizuara te `grade` kur keni emërtuar një fuel_type), sparse_coverage për vendet me 25 ose më pak stacione me çmim, measured_at, dhe një fuel_type_note që ndan dy arsyet pse një përgjigje mund të jetë bosh — një emër cilësie që nuk kemi mundur ta identifikojmë, kundrejt një cilësie që e njohim por nuk e çmojmë në atë vend.
GET https://nakordoni.eu/api/v2/data/fuel-cheapest
— klasa e kuotës: cheap
| Parametri | Përshkrimi |
|---|---|
lat | Gjerësia gjeografike |
lon | Gjatësia gjeografike |
city | Emri i qytetit — alternativë ndaj lat/lon, kthehet në koordinata |
country | Kodi ISO-2 i shtetit, saktëson qytetin |
radius_km | Rrezja e kërkimit në km (parazgjedhje 25, maks. 25; alias: radius) |
fuel_type | diesel (i parazgjedhur) | e5 | e10 | superplus | super100 | premdiesel | truckdiesel | hvo | lpg | cng | adblue | e85 | lng — renditja sipas çmimit bëhet për secilin lloj karburanti veç e veç. Pranohen edhe emrat vendorë të pompave — ON, Olej napędowy, Pb95, Nafta, Dizel, Gázolaj, Motorină, Benzină 95, ДП, А-95, Motorin, Gasóleo, Sans plomb 95, Bleifrei … — ata zgjidhen në varësi të `country` (ose, për produktet me koordinata, të vendit ku bie pika), sepse i njëjti formulim nuk nënkupton kudo të njëjtin lloj: „95“ është E10 në një pompë daneze, finlandeze, franceze, britanike, belge ose holandeze dhe E5 në një pompë polake ose gjermane. Përgjigja kthen `fuel_type` (kanonik), `fuel_type_requested` (ashtu siç e shkruat) dhe `fuel_type_local`. Një emër që nuk arrijmë ta identifikojmë nuk zëvendësohet kurrë me një lloj të parazgjedhur — përgjigja kthehet bosh dhe e thotë këtë. Tabela e plotë e emrave sipas vendeve: /api/v2/data/fuel-grades. |
limit | Maksimumi i pikave të karburantit (parazgjedhje 5, maks. 20) |
lang | Gjuha e etiketave (parazgjedhje en) |
Fushat e përgjigjes — brenda objektit data të zarfit të përgjigjes. [] shënon një listë, pra data.items[].name është fusha name e çdo elementi. Një fushë është null, mungon ose është listë bosh kur nuk kemi vlerë — kurrë një vendmbajtëse.
| Fusha | Përshkrimi |
|---|---|
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"
Përditësuar