API i çmimeve lokale të karburantit Online
Çmimi më i mirë i disponueshëm i karburantit për ÇDO pikë në Evropë, i përcaktuar përmes një shkalle rezervë me tre nivele, në mënyrë që një koordinatë të mos kthehet kurrë bosh atje ku kemi të dhëna të çfarëdo lloji: çmime pompe nga stacionet më të afërta kur pika ndodhet brenda mbulimit në nivel stacioni (39 vende sot; lista e saktë me numrat për vend kthehet në objektin coverage të çdo përgjigjeje bosh të fuel-stations, kurrë nga një listë e shkruar këtu), përndryshe — mesatarja rajonale për rajonin administrativ ku bie pika (vetëm Ukraina sot — burimi i oblasteve UA, në UAH), përndryshe — mesatarja kombëtare për vendin. Çdo përgjigje mban një fushë `resolution` që emërton nivelin që u përgjigj — `station` (të dhënat janë një listë stacionesh me distance_km, secili në monedhën e vet), `region` (një objekt me mesataren e oblastit plus `region`, një kod ISO 3166-2 si UA-46, `region_name` dhe `region_center_dist_km`) ose `country` (një objekt me mesataren kombëtare). Nivelet region dhe country kthejnë të njëjtat çelësa çmimi: petrol/petrol95plus/petrol92/diesel/lpg + currency + data e përditësimit. Degëzohuni sipas `resolution`, kurrë sipas formës. Ukraina nuk ka çmime për stacione askund, kështu që një pikë UA përgjigjet në nivelin `region`, ku oblasti është i çmuar, dhe përndryshe bie te `country`. 404 kur pika është jashtë çdo vendi të mbuluar (në mes të oqeanit, jashtë Evropës). Nivelet region dhe country mbajnë gjithashtu një objekt `grades` që lidh çdo çelës çmimi me cilësinë e tij kanonike dhe me emrin që një shofer në atë vend do të përdorte në pompë (UA `diesel` → ДП, PL `petrol` → Pb95). Për një mesatare të thjeshtë kombëtare pa koordinata përdorni produktin `fuel`, për një kërkim të pastër stacionesh `fuel-stations`, për renditje sipas çmimit `fuel-cheapest`.
GET https://nakordoni.eu/api/v2/data/fuel-local
— 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ë nivel stacioni në km (parazgjedhje 25, maksimum 25; alias: radius). Nëse brenda saj nuk ka asnjë stacion, përgjigja kalon në nivelin e vendit — kërkimi nuk zgjerohet kurrë vetvetiu. |
fuel_type | Filtër opsional në nivel stacioni: diesel | e5 | e10 | superplus | super100 | premdiesel | truckdiesel | hvo | lpg | cng | adblue | e85 | lng. Shpërfillet në nivel vendi, ku kthehen gjithmonë të gjitha llojet që raporton vendi. 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 në nivelin e pikave (parazgjedhje 5, maks. 20) |
lang | Gjuha e etiketave dhe e emrit të shtetit (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.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"
Përditësuar