Yaxınlıqdakı yanacaqdoldurma stansiyaları API Online
Nöqtəyə və ya şəhərə ən yaxın yanacaqdoldurma məntəqələri, hər yanacaq növü üzrə cari qiymətlərlə, məsafəyə görə sıralanmış. Məntəqə səviyyəsində əhatə Avropanın 39 ölkəsini əhatə edir və ƏVVƏLCƏDƏN TƏYİN OLUNMUŞ deyil, ÖLÇÜLÜR: hər boş cavab coverage obyektində, hər ölkə üzrə məntəqə sayı ilə birlikdə cari ölkələr siyahısını, tələb olunan marka çərçivəsində qaytarır — ona görə bu təsvirdə yazılmış siyahı əvəzinə elə onu oxuyun — bu, nakordoni.eu-nun yanacaq səhifələrindəki eyni məlumatdır; başqa hallarda milli orta göstəricilər üçün fuel API-nin country rejimindən istifadə edin. Qiymətlər hər məntəqənin öz valyutasında qaytarılır (Polşa məntəqələri üçün PLN, digərlərində EUR) — hər məntəqənin currency sahəsini oxuyun, xam rəqəmləri heç vaxt müqayisə etməyin. Heç bir məntəqə uyğun gəlmədikdə, cavab səssiz boş siyahı əvəzinə coverage obyekti daxil edir: canlı indeksdən ölçülmüş station_countries və station_counts (fuel_type göstərildikdə `grade` çərçivəsində), qiyməti bildirilən məntəqə sayı 25 və ya az olan ölkələr üçün sparse_coverage, measured_at və cavabın boş olmasının iki səbəbini ayıran fuel_type_note — müəyyən edə bilmədiyimiz marka adı ilə tanıdığımız, lakin həmin ölkədə qiymətini bildirmədiyimiz marka arasındakı fərq.
GET https://nakordoni.eu/api/v2/data/fuel-stations
— kvota sinfi: cheap
| Parametr | Təsvir |
|---|---|
lat | Enlik |
lon | Uzunluq |
city | Şəhərin adı — lat/lon alternativi, koordinatlara çevrilir |
country | ISO-2 ölkə kodu, şəhəri dəqiqləşdirir |
radius_km | Axtarış radiusu, km (defolt 25, maksimum 25; alias: radius) |
fuel_type | İxtiyari filtr: diesel | e5 | e10 | superplus | super100 | premdiesel | truckdiesel | hvo | lpg | cng | adblue | e85 | lng (mövcudluq məntəqəyə/regiona görə dəyişir; Polşa məntəqələri Pb95-i e5, Pb98-i superplus və ON-u diesel kimi bildirir). Yerli kolonka adları da qəbul olunur — ON, Olej napędowy, Pb95, Nafta, Dizel, Gázolaj, Motorină, Benzină 95, ДП, А-95, Motorin, Gasóleo, Sans plomb 95, Bleifrei … — onlar `country` əsasında müəyyən edilir (koordinat məhsullarında isə nöqtənin düşdüyü ölkə əsasında), çünki eyni ad hər yerdə eyni növ demək deyil: “95” Danimarka, Finlandiya, Fransa, Britaniya, Belçika və ya Hollandiya kolonkasında E10, Polşa və ya Almaniya kolonkasında isə E5-dir. Cavab `fuel_type` (kanonik), `fuel_type_requested` (yazdığınız şəkildə) və `fuel_type_local` sahələrini qaytarır. Müəyyən edə bilmədiyimiz ad heç vaxt standart növlə əvəz olunmur — cavab boş qayıdır və bunu bildirir. Ölkələr üzrə adların tam cədvəli: /api/v2/data/fuel-grades. |
limit | Maksimum məntəqə (defolt 5, maksimum 20) |
lang | Etiketlərin dili (defolt en) |
Cavab sahələri — cavab zərfindəki data obyektinin içində. [] siyahını bildirir, yəni data.items[].name hər elementin name sahəsidir. Dəyəri olmayan sahə null olur, ümumiyyətlə görünmür və ya boş siyahı qaytarır — heç vaxt doldurucu qoymuruq.
| Sahə | Təsvir |
|---|---|
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"
Yeniləndi