API del carburante più economico nelle vicinanze Online
Le stazioni di rifornimento più economiche attorno a un punto o a una città, classificate per prezzo in base al tipo di carburante scelto (a parità vince la più vicina). La copertura a livello di stazione si estende a 39 paesi europei ed è MISURATA, non fissa: ogni risposta vuota restituisce l'elenco attuale dei paesi con il numero di stazioni per paese nel proprio oggetto coverage, delimitato al grado richiesto — leggete quindi quello, non un elenco in questa descrizione. La classifica è per tipo di carburante all'interno di un'unica area di ricerca, e i prezzi portano la valuta propria di ciascuna stazione (PLN in Polonia, EUR altrove). Quando nessuna stazione corrisponde, la risposta include un oggetto coverage invece di un elenco vuoto silenzioso: station_countries e station_counts misurati dall'indice live (delimitati a `grade` quando avete indicato un fuel_type), sparse_coverage per i paesi con 25 stazioni con prezzo o meno, measured_at, e una fuel_type_note che separa i due motivi per cui una risposta può essere vuota — un nome di grado che non siamo riusciti a individuare, contro un grado che riconosciamo ma non quotiamo in quel paese.
GET https://nakordoni.eu/api/v2/data/fuel-cheapest
— classe di quota: cheap
| Parametro | Descrizione |
|---|---|
lat | Latitudine |
lon | Longitudine |
city | Nome della città — alternativa a lat/lon, convertito in coordinate |
country | Codice paese ISO-2, disambigua la città |
radius_km | Raggio di ricerca in km (predefinito 25, max 25; alias: radius) |
fuel_type | diesel (predefinito) | e5 | e10 | superplus | super100 | premdiesel | truckdiesel | hvo | lpg | cng | adblue | e85 | lng — la classifica per prezzo è calcolata per singolo tipo di carburante. Sono accettati anche i nomi locali delle pompe — ON, Olej napędowy, Pb95, Nafta, Dizel, Gázolaj, Motorină, Benzină 95, ДП, А-95, Motorin, Gasóleo, Sans plomb 95, Bleifrei … — vengono risolti in base a `country` (o, per i prodotti a coordinate, in base al paese in cui ricade il punto), perché la stessa dicitura non indica ovunque lo stesso tipo: «95» è E10 su una pompa danese, finlandese, francese, britannica, belga o olandese ed E5 su una polacca o tedesca. La risposta restituisce `fuel_type` (canonico), `fuel_type_requested` (così come lo avete scritto) e `fuel_type_local`. Un nome che non riusciamo a collocare non viene mai sostituito con un tipo predefinito: la risposta torna vuota e lo segnala. Tabella completa dei nomi per paese: /api/v2/data/fuel-grades. |
limit | Numero massimo di stazioni (predefinito 5, max 20) |
lang | Lingua delle etichette (predefinito en) |
Campi della risposta — all’interno dell’oggetto data della busta. [] indica una lista, quindi data.items[].name è il campo name di ogni elemento. Un campo è null, assente o una lista vuota quando non abbiamo un valore — mai un segnaposto.
| Campo | Descrizione |
|---|---|
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"