Մոտակա ամենաէժան վառելիքի API Online
Կետի կամ քաղաքի շրջակայքի ամենաէժան բենզալցակայանները՝ դասակարգված ըստ ընտրված վառելիքի տեսակի գնի (հավասարության դեպքում հաղթում է ամենամոտը)։ Կայանի մակարդակի ընդգրկումը ներառում է Եվրոպայի 39 երկիր և ՉԱՓՎՈՒՄ Է, այլ ոչ թե ամրագրված է․ ցանկացած դատարկ պատասխան coverage օբյեկտում վերադարձնում է երկրների ընթացիկ ցանկը՝ ըստ երկրի կայանների քանակով, սահմանափակված հարցված տեսակով, ուստի հենց դա կարդացեք, այլ ոչ թե այս նկարագրության մեջ գրված ցանկը։ Դասակարգումը կատարվում է մեկ որոնման տարածքի ներսում՝ ըստ վառելիքի յուրաքանչյուր տեսակի, իսկ գները կրում են յուրաքանչյուր կայանի սեփական արժույթը (PLN՝ Լեհաստանում, EUR՝ մնացած դեպքերում)։ Երբ ոչ մի կայան չի համընկնում, պատասխանը լուռ դատարկ ցանկի փոխարեն ներառում է coverage օբյեկտ․ ակտիվ ինդեքսից չափված station_countries և station_counts (fuel_type նշված լինելու դեպքում՝ սահմանափակված `grade`-ով), sparse_coverage՝ 25 կամ ավելի քիչ գնով կայաններ ունեցող երկրների համար, 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; alias: 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"
Թարմացվել է