API de precios locales de combustible Online
El mejor precio de combustible disponible para CUALQUIER punto de Europa, resuelto a través de una escala de repliegue de tres niveles para que una coordenada nunca vuelva vacía si tenemos algún dato: precios de surtidor de las estaciones más cercanas cuando el punto está dentro de la cobertura a nivel de estación (39 países hoy; la lista exacta con los recuentos por país llega en el objeto coverage de cualquier respuesta vacía de fuel-stations, nunca de una lista fija aquí), si no, el promedio regional de la región administrativa en la que cae el punto (solo Ucrania por ahora — el feed de óblasts de UA, en UAH), y si no, el promedio nacional del país. Cada respuesta lleva un campo `resolution` que indica el nivel que respondió: `station` (los datos son una lista de estaciones con distance_km, cada una en su propia currency), `region` (un objeto de promedio de óblast más `region`, un código ISO 3166-2 como UA-46, `region_name` y `region_center_dist_km`) o `country` (un objeto de promedio nacional). Los niveles region y country devuelven las mismas claves de precio: petrol/petrol95plus/petrol92/diesel/lpg + currency + fecha de actualización. Decida según `resolution`, nunca según la forma de la respuesta. Ucrania no tiene precios por estación en ningún caso, así que un punto en UA responde en `region` cuando el óblast está cotizado, y recae en `country` en caso contrario. 404 cuando el punto está fuera de todos los países cubiertos (en medio del océano, fuera de Europa). Los niveles region y country también llevan un objeto `grades` que asocia cada clave de precio con su grado canónico y con el nombre que usaría un conductor de ese país en el surtidor (UA `diesel` → ДП, PL `petrol` → Pb95). Para un promedio nacional simple sin coordenadas use el producto `fuel`, para una búsqueda pura de estaciones `fuel-stations`, y para clasificación por precio `fuel-cheapest`.
GET https://nakordoni.eu/api/v2/data/fuel-local
— clase de cuota: cheap
| Parámetro | Descripción |
|---|---|
lat | Latitud |
lon | Longitud |
city | Nombre de la ciudad — alternativa a lat/lon, se convierte en coordenadas |
country | Código de país ISO-2, desambigua la ciudad |
radius_km | Radio de búsqueda a nivel de estación en km (predeterminado 25, máximo 25; alias: radius). Si no hay ninguna estación dentro, la respuesta pasa al nivel de país: la búsqueda nunca se amplía por sí sola. |
fuel_type | Filtro opcional a nivel de estación: diesel | e5 | e10 | superplus | super100 | premdiesel | truckdiesel | hvo | lpg | cng | adblue | e85 | lng. Se ignora a nivel de país, que siempre devuelve todos los carburantes que ese país declara. También se aceptan los nombres locales de surtidor — ON, Olej napędowy, Pb95, Nafta, Dizel, Gázolaj, Motorină, Benzină 95, ДП, А-95, Motorin, Gasóleo, Sans plomb 95, Bleifrei … — se resuelven en función de `country` (o, en los productos por coordenadas, del país en el que cae el punto), porque la misma denominación no designa el mismo carburante en todas partes: «95» es E10 en un surtidor danés, finlandés, francés, británico, belga u holandés, y E5 en uno polaco o alemán. La respuesta devuelve `fuel_type` (canónico), `fuel_type_requested` (tal como lo escribió) y `fuel_type_local`. Un nombre que no podemos situar nunca se sustituye por un carburante predeterminado: la respuesta vuelve vacía y lo indica. Tabla completa de nombres por país: /api/v2/data/fuel-grades. |
limit | Máximo de estaciones en el nivel de estaciones (por defecto 5, máximo 20) |
lang | Idioma de las etiquetas y del nombre del país (por defecto en) |
Campos de la respuesta — dentro del objeto data del sobre de respuesta. [] indica una lista, así que data.items[].name es el campo name de cada elemento. Un campo es null, no aparece o es una lista vacía cuando no tenemos valor: nunca un marcador de posición.
| Campo | Descripción |
|---|---|
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"
Actualizado