Yaxınlıqdakı ən ucuz yanacaq API Online
Nöqtə və ya şəhər ətrafındakı ən ucuz yanacaqdoldurma məntəqələri, seçilmiş yanacaq növü üzrə qiymətə görə sıralanmış (bərabərlik olduqda ən yaxın olan qalib gəlir). 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. Sıralama bir axtarış ərazisi daxilində hər yanacaq növü üzrə ayrıca aparılır, qiymətlər isə hər məntəqənin öz valyutasını daşıyır (Polşada PLN, digərlərində EUR). 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-cheapest
— 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 | diesel (standart) | e5 | e10 | superplus | super100 | premdiesel | truckdiesel | hvo | lpg | cng | adblue | e85 | lng — qiymət üzrə sıralama hər yanacaq növü üçün ayrıca aparılır. Yerli kolonka adları da qəbul edilir — ON, Olej napędowy, Pb95, Nafta, Dizel, Gázolaj, Motorină, Benzină 95, ДП, А-95, Motorin, Gasóleo, Sans plomb 95, Bleifrei … — onlar `country` kontekstində müəyyən edilir (koordinat əsaslı məhsullarda isə nöqtənin düşdüyü ölkəyə görə), çünki eyni ifadə 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 susmaya görə 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.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"
Yeniləndi