API за локални цени на гориво Online
Најдобрата достапна цена на гориво за КОЈА БИЛО точка во Европа, определена низ тростепена скала на резервни варијанти, така што координатата никогаш не се враќа празна каде што воопшто имаме податоци: цени на пумпа од најблиските станици кога точката е внатре во покриеноста на ниво станица (39 земји денес; точниот список со број по земја се враќа во coverage објектот на секој празен fuel-stations одговор, никогаш од список запишан тука), инаку — регионалниот просек за административниот регион во кој паѓа точката (само Украина денес — украинскиот oblast извор, во UAH), инаку — националниот просек за земјата. Секој одговор носи поле `resolution` што го именува степенот што одговорил — `station` (податоците се список на станици со distance_km, секоја во сопствена валута), `region` (еден област-просечен објект плус `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"
Ажурирано