API prezzi carburante locali Online
Il miglior prezzo del carburante disponibile per QUALSIASI punto in Europa, risolto lungo una scala di ripiego a tre livelli, in modo che una coordinata non torni mai vuota dove abbiamo comunque dei dati: prezzi alla pompa dalle stazioni più vicine quando il punto rientra nella copertura a livello di stazione (39 paesi oggi; l'elenco esatto con i conteggi per paese torna nell'oggetto coverage di qualsiasi risposta vuota di fuel-stations, mai da un elenco scritto qui), altrimenti — la media regionale per la regione amministrativa in cui ricade il punto (solo l'Ucraina oggi — il feed degli oblast ucraini, in UAH), altrimenti — la media nazionale per il paese. Ogni risposta porta un campo `resolution` che indica il livello che ha risposto — `station` (i dati sono un elenco di stazioni con distance_km, ciascuna nella propria valuta), `region` (un oggetto di media dell'oblast più `region`, un codice ISO 3166-2 come UA-46, `region_name` e `region_center_dist_km`) o `country` (un oggetto di media nazionale). I livelli region e country restituiscono le stesse chiavi di prezzo: petrol/petrol95plus/petrol92/diesel/lpg + currency + data di aggiornamento. Ramificate in base a `resolution`, mai in base alla forma. L'Ucraina non ha prezzi per stazione da nessuna parte, quindi un punto UA risponde a livello `region`, dove l'oblast è quotato, e altrimenti ripiega su `country`. 404 quando il punto è al di fuori di ogni paese coperto (in mezzo all'oceano, fuori dall'Europa). I livelli region e country portano anche un oggetto `grades` che mappa ogni chiave di prezzo al proprio grado canonico e al nome che un automobilista in quel paese userebbe alla pompa (UA `diesel` → ДП, PL `petrol` → Pb95). Per una semplice media nazionale senza coordinate usate il prodotto `fuel`, per una ricerca pura di stazioni `fuel-stations`, per la classifica per prezzo `fuel-cheapest`.
GET https://nakordoni.eu/api/v2/data/fuel-local
— 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 a livello di stazione in km (predefinito 25, massimo 25; alias: radius). Se al suo interno non c'è alcuna stazione, la risposta ricade al livello di paese: la ricerca non si allarga mai da sola. |
fuel_type | Filtro facoltativo a livello di stazione: diesel | e5 | e10 | superplus | super100 | premdiesel | truckdiesel | hvo | lpg | cng | adblue | e85 | lng. Ignorato a livello di paese, che restituisce sempre tutti i tipi segnalati dal paese. 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 a livello stazione (predefinito 5, max 20) |
lang | Lingua delle etichette e del nome del paese (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.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"
Aggiornato