API du carburant le moins cher à proximité Online
Les stations-service les moins chères autour d'un point ou d'une ville, classées par prix pour le type de carburant choisi (en cas d'égalité, la plus proche l'emporte). La couverture au niveau des stations s'étend sur 39 pays européens et est MESURÉE, non figée : chaque réponse vide renvoie la liste actuelle des pays avec le nombre de stations par pays dans son objet coverage, limité à la qualité demandée — lisez donc celui-ci plutôt qu'une liste dans cette description. Le classement se fait par type de carburant au sein d'une seule zone de recherche, et les prix portent la devise propre à chaque station (PLN en Pologne, EUR ailleurs). Lorsqu'aucune station ne correspond, la réponse inclut un objet coverage au lieu d'une liste vide silencieuse : station_countries et station_counts mesurés depuis l'index en direct (limités à `grade` lorsque vous avez indiqué un fuel_type), sparse_coverage pour les pays comptant 25 stations avec prix ou moins, measured_at, et une fuel_type_note qui distingue les deux raisons pour lesquelles une réponse peut être vide — un nom de qualité que nous n'avons pas pu identifier, par opposition à une qualité que nous reconnaissons mais que nous ne cotons pas dans ce pays.
GET https://nakordoni.eu/api/v2/data/fuel-cheapest
— classe de quota: cheap
| Paramètre | Description |
|---|---|
lat | Latitude |
lon | Longitude |
city | Nom de la ville — alternative à lat/lon, converti en coordonnées |
country | Code pays ISO-2, lève l'ambiguïté sur la ville |
radius_km | Rayon de recherche en km (par défaut 25, max. 25 ; alias : radius) |
fuel_type | diesel (par défaut) | e5 | e10 | superplus | super100 | premdiesel | truckdiesel | hvo | lpg | cng | adblue | e85 | lng — le classement par prix est établi par type de carburant. Les noms locaux à la pompe sont également acceptés — ON, Olej napędowy, Pb95, Nafta, Dizel, Gázolaj, Motorină, Benzină 95, ДП, А-95, Motorin, Gasóleo, Sans plomb 95, Bleifrei … — ils sont résolus en fonction de `country` (ou, pour les produits par coordonnées, du pays dans lequel tombe le point), car la même appellation ne désigne pas partout le même carburant : « 95 » correspond à E10 sur une pompe danoise, finlandaise, française, britannique, belge ou néerlandaise, et à E5 sur une pompe polonaise ou allemande. La réponse renvoie `fuel_type` (canonique), `fuel_type_requested` (tel que vous l'avez saisi) et `fuel_type_local`. Un nom que nous ne parvenons pas à situer n'est jamais remplacé par un carburant par défaut : la réponse revient vide et le signale. Tableau complet des noms par pays : /api/v2/data/fuel-grades. |
limit | Nombre max. de stations (par défaut 5, max. 20) |
lang | Langue des libellés (par défaut en) |
Champs de la réponse — à l’intérieur de l’objet data de l’enveloppe. [] indique une liste : data.items[].name est donc le champ name de chaque élément. Un champ vaut null, est absent ou est une liste vide quand nous n’avons pas de valeur — jamais un espace réservé.
| Champ | Description |
|---|---|
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"
Mis à jour