Yerel Yakıt Fiyatı API Online
Avrupa'da HERHANGİ bir nokta için mevcut en iyi yakıt fiyatı, bir koordinatın verimizin olduğu her yerde asla boş dönmemesi için üç katmanlı bir yedek merdiveni üzerinden çözülür: nokta istasyon düzeyi kapsama alanının içindeyse en yakın istasyonlardan pompa fiyatları (bugün 39 ülke; ülke başına sayılarla birlikte tam liste, herhangi bir boş fuel-stations yanıtının coverage nesnesinde döner, asla burada yazılı bir listeden değil), aksi halde — noktanın içine düştüğü idari bölge için bölgesel ortalama (bugün yalnızca Ukrayna — UA oblast beslemesi, UAH cinsinden), aksi halde — ülke için ulusal ortalama. Her yanıt, yanıtı veren katmanı adlandıran bir `resolution` alanı taşır — `station` (veriler distance_km ile birlikte, her biri kendi para biriminde bir istasyon listesidir), `region` (bir oblast ortalaması nesnesi artı `region` — UA-46 gibi bir ISO 3166-2 kodu —, `region_name` ve `region_center_dist_km`) veya `country` (bir ulusal ortalama nesnesi). Region ve country katmanları aynı fiyat anahtarlarını döndürür: petrol/petrol95plus/petrol92/diesel/lpg + currency + güncelleme tarihi. Şekle göre değil, her zaman `resolution`'a göre dallanın. Ukrayna'nın hiçbir yerde istasyon başına fiyatı yoktur, bu yüzden bir UA noktası, oblastın fiyatlandırıldığı `region` katmanında yanıt verir ve aksi halde `country`'ye geri düşer. Nokta kapsanan her ülkenin dışındaysa (okyanus ortasında, Avrupa dışında) 404 döner. Region ve country katmanları ayrıca her fiyat anahtarını kanonik sınıfına ve o ülkedeki bir sürücünün pompada kullanacağı ada eşleyen bir `grades` nesnesi taşır (UA `diesel` → ДП, PL `petrol` → Pb95). Koordinatsız düz bir ulusal ortalama için `fuel` ürününü, saf bir istasyon araması için `fuel-stations`'ı, fiyata göre sıralama için `fuel-cheapest`'i kullanın.
GET https://nakordoni.eu/api/v2/data/fuel-local
— kota sınıfı: cheap
| Parametre | Açıklama |
|---|---|
lat | Enlem |
lon | Boylam |
city | Şehir adı — lat/lon yerine kullanılır, koordinatlara çevrilir |
country | ISO-2 ülke kodu, şehri netleştirir |
radius_km | İstasyon düzeyinde arama yarıçapı, km (varsayılan 25, en fazla 25; takma ad: radius). İçinde hiç istasyon yoksa yanıt ülke düzeyine düşer; arama kendiliğinden asla genişletilmez. |
fuel_type | İstasyon düzeyinde isteğe bağlı filtre: diesel | e5 | e10 | superplus | super100 | premdiesel | truckdiesel | hvo | lpg | cng | adblue | e85 | lng. Ülke düzeyinde yok sayılır; orada ülkenin bildirdiği tüm yakıt türleri her zaman döndürülür. Yerel pompa adları da kabul edilir — ON, Olej napędowy, Pb95, Nafta, Dizel, Gázolaj, Motorină, Benzină 95, ДП, А-95, Motorin, Gasóleo, Sans plomb 95, Bleifrei … — bunlar `country` bağlamında çözümlenir (koordinat tabanlı ürünlerde ise noktanın düştüğü ülkeye göre), çünkü aynı ifade her yerde aynı yakıt türü anlamına gelmez: “95” Danimarka, Finlandiya, Fransa, İngiltere, Belçika veya Hollanda pompasında E10, Polonya veya Almanya pompasında ise E5’tir. Yanıt `fuel_type` (kanonik), `fuel_type_requested` (yazdığınız hâliyle) ve `fuel_type_local` alanlarını döndürür. Yerini belirleyemediğimiz bir ad asla varsayılan bir yakıt türüyle değiştirilmez; yanıt boş döner ve bunu belirtir. Ülkelere göre adların tam tablosu: /api/v2/data/fuel-grades. |
limit | İstasyon düzeyinde en fazla istasyon (varsayılan 5, en fazla 20) |
lang | Etiketlerin ve ülke adının dili (varsayılan en) |
Yanıt alanları — yanıt zarfındaki data nesnesinin içinde. [] bir listeyi gösterir; yani data.items[].name her öğenin name alanıdır. Değerimiz olmayan bir alan null olur, hiç bulunmaz ya da boş liste döner — asla yer tutucu koymayız.
| Alan | Açıklama |
|---|---|
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"
Güncellendi