Жақын жердегі ең арзан отын API Online
Нүкте немесе қала маңындағы ең арзан жанармай құю станциялары, таңдалған отын түрі бойынша бағасына қарай сұрыпталған (тең болған жағдайда жақыны жеңеді). Станция деңгейіндегі қамту Еуропаның 39 еліне таралады және ол ӨЛШЕНЕДІ, тіркелмеген: кез келген бос жауап coverage объектісінде елдердің ағымдағы тізімін, әр ел бойынша станциялар санымен қоса қайтарады, сұралған марка шеңберінде — сондықтан осы сипаттамада жазылған тізімнің орнына сол деректі оқыңыз. Сұрыптау бір іздеу аймағында әр отын түрі бойынша жеке жүргізіледі, ал бағалар әр станцияның өз валютасымен беріледі (Польшада PLN, қалғанында EUR). Ешбір станция сәйкес келмесе, жауапта үнсіз бос тізімнің орнына coverage объектісі болады: тікелей индекстен өлшенген station_countries және station_counts (fuel_type көрсетілген болса, `grade` шеңберінде), бағаланған станциялар саны 25-тен аспайтын елдер үшін sparse_coverage, measured_at, және жауаптың бос болуының екі себебін ажырататын fuel_type_note — біз анықтай алмаған марка атауы мен біз танитын, бірақ сол елде бағасын хабарламайтын марка арасындағы айырмашылық.
GET https://nakordoni.eu/api/v2/data/fuel-cheapest
— квота класы: 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.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"
Жаңартылды