Yakındaki Akaryakıt İstasyonları API Online
Bir noktaya veya şehre en yakın benzin istasyonları, her yakıt türü için güncel fiyatlarla birlikte, mesafeye göre sıralanır. İstasyon düzeyindeki kapsama 39 Avrupa ülkesini kapsar ve sabit değil, ÖLÇÜLMÜŞTÜR: her boş yanıt, coverage nesnesinde ülke başına istasyon sayılarıyla birlikte, istediğiniz sınıfla sınırlı güncel ülke listesini döndürür — bu nedenle bu açıklamadaki bir listeyi değil, onu okuyun — nakordoni.eu yakıt sayfalarıyla aynı veriler; başka yerlerde ulusal ortalamalar için fuel API'nin country modunu kullanın. Fiyatlar her istasyonun kendi para biriminde döndürülür (Polonya istasyonları için PLN, diğer yerlerde EUR) — istasyon başına currency alanını okuyun, ham sayıları asla karşılaştırmayın. Hiçbir istasyon eşleşmediğinde, yanıt sessiz bir boş liste yerine bir coverage nesnesi içerir: canlı dizinden ölçülen station_countries ve station_counts (bir fuel_type belirttiğinizde `grade` ile sınırlı), 25 veya daha az fiyatlandırılmış istasyona sahip ülkeler için sparse_coverage, measured_at ve bir yanıtın neden boş olabileceğine dair iki nedeni ayıran fuel_type_note — yerleştiremediğimiz bir sınıf adı ile tanıdığımız ama o ülkede fiyatlandırmadığımız bir sınıf arasındaki fark.
GET https://nakordoni.eu/api/v2/data/fuel-stations
— 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 | Arama yarıçapı (km) (varsayılan 25, en fazla 25; alias: radius) |
fuel_type | İsteğe bağlı filtre: diesel | e5 | e10 | superplus | super100 | premdiesel | truckdiesel | hvo | lpg | cng | adblue | e85 | lng (bulunabilirlik istasyona/bölgeye göre değişir; Polonya istasyonları Pb95'i e5, Pb98'i superplus ve ON'u diesel olarak bildirir). 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` değerine göre çözümlenir (koordinat tabanlı ürünlerde ise noktanın düştüğü ülkeye göre), çünkü aynı adlandırma her yerde aynı yakıt türü anlamına gelmez: “95”, Danimarka, Finlandiya, Fransa, Britanya, 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 haliyle) ve `fuel_type_local` alanlarını döndürür. Yerini belirleyemediğimiz bir ad asla varsayılan bir türle değiştirilmez — yanıt boş döner ve bunu bildirir. Ülkelere göre adların tam tablosu: /api/v2/data/fuel-grades. |
limit | En fazla istasyon (varsayılan 5, en fazla 20) |
lang | Etiketlerin 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.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"
Güncellendi