Жергілікті отын бағасының API Online
Еуропадағы КЕЗ КЕЛГЕН нүкте үшін қолжетімді ең жақсы отын бағасы, үш деңгейлі қосалқы баспалдақ арқылы анықталады, сондықтан деректеріміз болған жағдайда координата ешқашан бос жауап қайтармайды: нүкте станция деңгейіндегі қамту аймағында болса (бүгінде 39 ел; әр ел бойынша нақты сандары бар дәл тізім кез келген бос fuel-stations жауабының coverage объектісінде қайтарылады, ешқашан мұнда жазылған тізімде емес) — ең жақын станциялардың колонка бағалары, әйтпесе нүкте орналасқан әкімшілік аймақтың орташа өңірлік бағасы (бүгінде тек Украина — UAH-тегі UA облыстары feed-і), әйтпесе елдің ұлттық орташа бағасы. Әр жауапта жауап берген деңгейді атайтын `resolution` өрісі болады — `station` (деректер — distance_km бар, әрқайсысы өз валютасындағы станциялар тізімі), `region` (бір облыс-орташа объект, оған қоса `region` — UA-46 сияқты ISO 3166-2 коды, `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 | Бекет деңгейіндегі іздеу радиусы, км (әдепкі 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"
Жаңартылды