Տեղական վառելիքի գների API Online
Եվրոպայի ՑԱՆԿԱՑԱԾ կետի համար հասանելի լավագույն վառելիքի գինը, որոշվում է եռաստիճան պահուստային սանդուղքով, որպեսզի կոորդինատը երբեք դատարկ պատասխան չվերադարձնի, եթե առհասարակ տվյալ ունենք․ մատակարարման գներ ամենամոտ կայաններից, երբ կետը գտնվում է կայանի մակարդակի ընդգրկման ներսում (այսօր՝ 39 երկիր; ճշգրիտ ցանկը՝ ըստ երկրի քանակներով, վերադառնում է ցանկացած դատարկ fuel-stations պատասխանի coverage օբյեկտում, երբեք ոչ այստեղ գրված ցանկից), հակառակ դեպքում՝ այն վարչական տարածաշրջանի միջին գինը, որտեղ ընկնում է կետը (այսօր միայն Ուկրաինա՝ UA մարզային feed-ը, 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 | Որոնման շառավիղը կայանի մակարդակում՝ կմ (լռելյայն՝ 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"
Թարմացվել է