Yerli yanacaq qiymətləri API Online
Avropada İSTƏNİLƏN nöqtə üçün mövcud olan ən yaxşı yanacaq qiyməti, üç səviyyəli ehtiyat pilləkəni ilə müəyyən edilir ki, məlumatımız olduğu yerdə koordinat heç vaxt boş cavab qaytarmasın: nöqtə məntəqə səviyyəsində əhatə daxilində olduqda (bu gün 39 ölkə; hər ölkə üzrə dəqiq say ilə tam siyahı hər hansı boş fuel-stations cavabının coverage obyektində qayıdır, heç vaxt burada yazılmış siyahıdan deyil) — ən yaxın məntəqələrdən sütun qiymətləri, əks halda nöqtənin düşdüyü inzibati bölgə üçün regional orta qiymət (bu gün yalnız Ukrayna — UAH-da UA vilayət feed-i), əks halda ölkə üçün milli orta qiymət. Hər cavab cavab verən səviyyəni adlandıran `resolution` sahəsi daşıyır — `station` (məlumat distance_km olan məntəqələr siyahısıdır, hər biri öz valyutasında), `region` (bir vilayət-orta obyekti, əlavə olaraq `region` — UA-46 kimi ISO 3166-2 kodu, `region_name` və `region_center_dist_km`) və ya `country` (bir milli-orta obyekt). region və country səviyyələri eyni qiymət açarlarını qaytarır: petrol/petrol95plus/petrol92/diesel/lpg + currency + yenilənmə tarixi. Formaya deyil, `resolution`-a görə budaqlanın. Ukraynada heç bir yerdə məntəqə üzrə qiymətlər yoxdur, ona görə UA nöqtəsi vilayət qiyməti mövcud olduqda `region` səviyyəsində cavab verir, əks halda `country`-yə düşür. Nöqtə əhatə olunan bütün ölkələrdən kənarda olduqda (okeanın ortasında, Avropadan kənarda) — 404. region və country səviyyələri həmçinin hər qiymət açarını onun kanonik markasına və həmin ölkənin sürücüsünün sütunda istifadə edəcəyi ada bağlayan `grades` obyekti daşıyır (UA `diesel` → ДП, PL `petrol` → Pb95). Koordinatsız sadə milli orta üçün `fuel` məhsulundan, sırf məntəqə axtarışı üçün `fuel-stations`-dan, qiymətə görə sıralama üçün `fuel-cheapest`-dən istifadə edin.
GET https://nakordoni.eu/api/v2/data/fuel-local
— 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 | Stansiya səviyyəsində axtarış radiusu, km (susmaya görə 25, maksimum 25; alias: radius). Onun daxilində heç bir stansiya yoxdursa, cavab ölkə səviyyəsinə keçir — axtarış heç vaxt öz-özünə genişlənmir. |
fuel_type | Stansiya səviyyəsində könüllü filtr: diesel | e5 | e10 | superplus | super100 | premdiesel | truckdiesel | hvo | lpg | cng | adblue | e85 | lng. Ölkə səviyyəsində nəzərə alınmır — orada həmişə ölkənin bildirdiyi bütün növlər qaytarı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 | Məntəqə səviyyəsində maksimum məntəqə (defolt 5, maksimum 20) |
lang | Etiketlərin və ölkə adının 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.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"
Yeniləndi