API del combustible más barato cercano Online
Las gasolineras más baratas alrededor de un punto o ciudad, clasificadas por precio para el tipo de combustible elegido (en caso de empate, gana la más cercana). La cobertura a nivel de estación abarca 39 países europeos y está MEDIDA, no fijada de antemano: cada respuesta vacía devuelve la lista actual de países con el número de estaciones por país en su objeto coverage, limitado al grado solicitado, así que consulte eso en lugar de una lista fija en esta descripción. La clasificación es por tipo de combustible dentro de una misma área de búsqueda, y los precios llevan la moneda propia de cada estación (PLN en Polonia, EUR en el resto). Cuando ninguna estación coincide, la respuesta incluye un objeto coverage en lugar de una lista vacía silenciosa: station_countries y station_counts medidos a partir del índice en vivo (limitados a `grade` cuando indicó un fuel_type), sparse_coverage para los países con 25 estaciones con precio o menos, measured_at, y un fuel_type_note que distingue los dos motivos por los que una respuesta puede quedar vacía: un nombre de grado que no pudimos identificar, frente a un grado que reconocemos pero no cotizamos en ese país.
GET https://nakordoni.eu/api/v2/data/fuel-cheapest
— 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 en km (por defecto 25, máximo 25; alias: radius) |
fuel_type | diesel (predeterminado) | e5 | e10 | superplus | super100 | premdiesel | truckdiesel | hvo | lpg | cng | adblue | e85 | lng — la clasificación por precio se calcula por tipo de carburante. 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 (por defecto 5, máximo 20) |
lang | Idioma de las etiquetas (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.stations[] | The same station objects as fuel-stations (grades nested under prices, one entry per physical station), ranked cheapest first for the chosen grade — closest wins a tie, and a station without a quote for that grade ranks last. |
data.anchor | The point searched and the resolved grade: lat, lng, radius_km, fuel_type, fuel_type_requested, fuel_type_local, fuel_type_country. |
data.count | Stations returned; data.total_found is how many matched inside the radius before limit was applied. |
data.coverage | Only when nothing matched — grade, station_countries + station_counts measured from the live index (scoped to that grade), sparse_coverage, measured_at, and fuel_type_note for both an unplaceable grade name and a recognised grade we do not price in this country. |
curl "https://nakordoni.eu/api/v2/data/fuel-cheapest?city=Munich&country=DE&radius_km=25" \ -H "Authorization: Bearer NKD-DEV-XXXX-XXXX-XXXX"
Actualizado