API за локални цени на горивата Online
Найдобрата налична цена на гориво за КОЯТО И ДА Е точка в Европа, определена чрез триетапна стълба на резервни варианти, така че координата никога не се връща празна, ако изобщо разполагаме с данни: цени на колонка от найблизките бензиностанции, когато точката попада в покритието на ниво бензиностанция (39 държави днес; точният списък с брой по държава се връща в обекта coverage на всеки празен отговор от fuel-stations, никога от списък, записан тук), иначе — регионалната средна стойност за административния регион, в който попада точката (само за Украйна днес — емисията по украински области, в UAH), иначе — националната средна стойност за държавата. Всеки отговор носи поле `resolution`, което назовава етапа, дал отговора — `station` (данните са списък от бензиностанции с distance_km, всяка в собствената си валута), `region` (един обект със средна стойност за областта, плюс `region` — код по ISO 3166-2, например UA-46, `region_name` и `region_center_dist_km`) или `country` (един обект с национална средна стойност). Етапите region и country връщат едни и същи ключове за цена: petrol/petrol95plus/petrol92/diesel/lpg + currency + дата на обновяване. Разклонявайте по `resolution`, никога по формата на данните. Украйна няма цени по отделни бензиностанции никъде, затова точка в UA получава отговор на ниво `region`, където областта е ценообразувана, а в противен случай — на ниво `country`. 404, когато точката е извън всяка покрита държава (насред океана, извън Европа). Етапите region и country носят и обект `grades`, който съпоставя всеки ключ за цена с неговата канонична марка и с името, което шофьор в тази държава би използвал на колонката (UA `diesel` → ДП, PL `petrol` → Pb95). За обикновена национална средна стойност без координати използвайте продукта `fuel`, за чисто търсене на бензиностанции — `fuel-stations`, за класиране по цена — `fuel-cheapest`.
GET https://nakordoni.eu/api/v2/data/fuel-local
— клас квота: cheap
| Параметър | Описание |
|---|---|
lat | Географска ширина |
lon | Географска дължина |
city | Име на град — алтернатива на lat/lon, преобразува се в координати |
country | ISO-2 код на държавата, уточнява града |
radius_km | Радиус на търсене на ниво бензиностанция в km (по подразбиране 25, максимум 25; псевдоним: radius). Ако в него няма бензиностанция, отговорът преминава на ниво държава — търсенето никога не се разширява само. |
fuel_type | Незадължителен филтър на ниво бензиностанция: diesel | e5 | e10 | superplus | super100 | premdiesel | truckdiesel | hvo | lpg | cng | adblue | e85 | lng. На ниво държава се игнорира — там винаги се връщат всички видове, които държавата отчита. Приемат се и местните имена от колонките — ON, Olej napędowy, Pb95, Nafta, Dizel, Gázolaj, Motorină, Benzină 95, ДП, А-95, Motorin, Gasóleo, Sans plomb 95, Bleifrei … — те се разпознават спрямо `country` (а за продуктите по координати — спрямо държавата, в която попада точката), защото едно и също наименование не означава навсякъде един и същ вид: „95“ е E10 на датска, финландска, френска, британска, белгийска или нидерландска колонка и E5 на полска или германска. Отговорът връща `fuel_type` (каноничен), `fuel_type_requested` (както сте го въвели) и `fuel_type_local`. Име, което не можем да разпознаем, никога не се подменя с вид по подразбиране — отговорът се връща празен и го посочва. Пълна таблица с имената по държави: /api/v2/data/fuel-grades. |
limit | Максимум бензиностанции на ниво станции (по подразбиране 5, максимум 20) |
lang | Език на етикетите и на името на държавата (по подразбиране en) |
Полета на отговора — вътре в обекта data в плика на отговора. [] означава списък, така че data.items[].name е полето name на всеки елемент. Поле може да е null, да липсва или да е празен списък, когато нямаме стойност — никога не подставяме заместител.
| Поле | Описание |
|---|---|
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"
Обновено