API de gasolineras cercanas Online
Las gasolineras más cercanas a un punto o ciudad, con los precios actuales por tipo de combustible, ordenadas por distancia. 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 — los mismos datos que las páginas de combustible de nakordoni.eu; use el modo de país de la fuel API para promedios nacionales en otros casos. Los precios se devuelven en la moneda propia de cada estación (PLN para las estaciones polacas, EUR en el resto) — consulte el campo currency de cada estación, nunca compare los números en bruto. 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-stations
— 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 | Filtro opcional: diesel | e5 | e10 | superplus | super100 | premdiesel | truckdiesel | hvo | lpg | cng | adblue | e85 | lng (la disponibilidad varía según la estación y la región; las estaciones polacas notifican Pb95 como e5, Pb98 como superplus y ON como diesel). También se aceptan las denominaciones 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 contra `country` (o, en los productos por coordenadas, contra el país en el que cae el punto), porque la misma denominación no significa 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`. Una denominación que no podemos ubicar nunca se sustituye por un carburante predeterminado: la respuesta vuelve vacía y así lo indica. Tabla completa de denominaciones 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.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"
Actualizado