Մոտակա վառելիքի կայանների API Online
Կետին կամ քաղաքին ամենամոտ բենզալցակայանները՝ վառելիքի յուրաքանչյուր տեսակի ընթացիկ գներով, դասավորված ըստ հեռավորության։ Կայանի մակարդակի ընդգրկումը ներառում է Եվրոպայի 39 երկիր և ՉԱՓՎՈՒՄ Է, այլ ոչ թե ամրագրված է․ ցանկացած դատարկ պատասխան coverage օբյեկտում վերադարձնում է երկրների ընթացիկ ցանկը՝ ըստ երկրի կայանների քանակով, սահմանափակված հարցված տեսակով, ուստի հենց դա կարդացեք, այլ ոչ թե այս նկարագրության մեջ գրված ցանկը — նույն տվյալներն են, ինչ nakordoni.eu-ի վառելիքի էջերում; այլ դեպքերում ազգային միջին ցուցանիշների համար օգտագործեք fuel API-ի country ռեժիմը։ Գները վերադարձվում են յուրաքանչյուր կայանի սեփական արժույթով (PLN՝ լեհական կայանների համար, EUR՝ մնացած դեպքերում) — կարդացեք յուրաքանչյուր կայանի currency դաշտը, երբեք մի՛ համեմատեք հում թվերը։ Երբ ոչ մի կայան չի համընկնում, պատասխանը լուռ դատարկ ցանկի փոխարեն ներառում է coverage օբյեկտ․ ակտիվ ինդեքսից չափված station_countries և station_counts (fuel_type նշված լինելու դեպքում՝ սահմանափակված `grade`-ով), sparse_coverage՝ 25 կամ ավելի քիչ գնով կայաններ ունեցող երկրների համար, measured_at, և fuel_type_note, որը տարանջատում է դատարկ պատասխանի երկու հնարավոր պատճառը՝ տեսակի անուն, որը մենք չկարողացանք ճանաչել, ընդդեմ տեսակի, որը մենք ճանաչում ենք, բայց տվյալ երկրում գին չենք հայտարարում։
GET https://nakordoni.eu/api/v2/data/fuel-stations
— քվոտայի դաս: 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 (հասանելիությունը տարբերվում է ըստ լցակայանի/տարածաշրջանի. լեհական լցակայանները Pb95-ը հաղորդում են որպես e5, Pb98-ը՝ որպես superplus, իսկ ON-ը՝ որպես diesel)։ Ընդունվում են նաև վառելիքի տեղական անվանումները — 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.anchor.lat | The point actually searched (after city geocoding), with lng, ppid and radius_km. |
data.anchor.fuel_type | The canonical grade the list was filtered to; fuel_type_requested is what you sent, fuel_type_local the local pump name and fuel_type_country the country the name was read in. |
data.stations[].name | Station, with brand and address. Each physical station appears ONCE: its grades are nested under prices, not spread over repeated rows. `brand` is the chain when we know it and null when we do not — never a placeholder token, so treat null as "independent or unknown" and fall back to `name`. Address detail varies by national feed: some report a full street address, others only the town. |
data.stations[].station_ref | Stable key for the station (name + position). Key your records on it whenever id is null — id is set only for rows that come from our station directory. |
data.stations[].prices | Object keyed by grade (diesel, e5, e10, lpg …): price, currency and currency_symbol, local_name (the pump name used in that country), label, updated_at, confirmed_at, age_hours and stale. Each station carries its own currency, so never compare the raw numbers. A station with no quote at all carries an empty object here. TWO CLOCKS, and they answer different questions — do not derive one from the other: `updated_at` is when this price last MOVED, so a forecourt that has held the same price for ten days keeps a ten-day-old stamp and that is correct, not stale data; `confirmed_at` is when we last CONFIRMED the quote against its feed, and it is the clock `age_hours` and `stale` are measured on (age_hours = now − confirmed_at). Read `confirmed_at`/`stale` for freshness and `updated_at` for price history. Both are floored to the hour, so `now − confirmed_at` can sit up to an hour above `age_hours`, which is measured before the floor; `confirmed_at` is never earlier than `updated_at`, because a price change is itself a confirmation. |
data.stations[].grades | The grade keys present in prices, alongside freshest_age_hours and a station-level stale flag (true only when NO quote of that station is current). |
data.stations[].distance_km | Distance from the anchor, with lat and lng of the station itself. |
data.count | Stations returned; data.total_found is how many matched inside the radius before limit was applied. |
data.notices | Present whenever we adjusted a parameter you sent: each entry names the param, the requested and the applied value, and the reason. |
data.coverage | Only when nothing matched. grade (the fuel_type your wording resolved to, or null), station_countries and station_counts measured from the live station index and scoped to that grade, sparse_coverage for countries with 25 priced stations or fewer, measured_at, a note explaining all of it, and fuel_type_note when the grade name could not be placed OR when we recognise the grade but price it nowhere in this country. |
curl "https://nakordoni.eu/api/v2/data/fuel-stations?city=Munich&country=DE&radius_km=20&fuel_type=diesel" \ -H "Authorization: Bearer NKD-DEV-XXXX-XXXX-XXXX"
Թարմացվել է