API des prix locaux des carburants Online
Le meilleur prix de carburant disponible pour N'IMPORTE QUEL point en Europe, résolu selon une échelle de repli à trois niveaux, de sorte qu'une coordonnée ne revienne jamais vide là où nous disposons d'au moins des données : prix à la pompe des stations les plus proches lorsque le point se situe dans la couverture au niveau des stations (39 pays aujourd'hui ; la liste exacte avec les comptes par pays revient dans l'objet coverage de toute réponse vide de fuel-stations, jamais depuis une liste écrite ici), sinon — la moyenne régionale pour la région administrative dans laquelle tombe le point (seulement l'Ukraine aujourd'hui — le flux des oblasts ukrainiens, en UAH), sinon — la moyenne nationale pour le pays. Chaque réponse porte un champ `resolution` qui nomme le niveau ayant répondu — `station` (les données sont une liste de stations avec distance_km, chacune dans sa propre devise), `region` (un objet de moyenne d'oblast plus `region`, un code ISO 3166-2 tel que UA-46, `region_name` et `region_center_dist_km`) ou `country` (un objet de moyenne nationale). Les niveaux region et country renvoient les mêmes clés de prix : petrol/petrol95plus/petrol92/diesel/lpg + currency + date de mise à jour. Aiguillez-vous sur `resolution`, jamais sur la forme. L'Ukraine n'a de prix par station nulle part, donc un point UA répond au niveau `region`, où l'oblast est coté, et retombe sinon sur `country`. 404 lorsque le point est en dehors de tout pays couvert (en pleine mer, hors d'Europe). Les niveaux region et country portent également un objet `grades` qui associe chaque clé de prix à sa qualité canonique et au nom qu'un automobiliste dans ce pays utiliserait à la pompe (UA `diesel` → ДП, PL `petrol` → Pb95). Pour une simple moyenne nationale sans coordonnées, utilisez le produit `fuel` ; pour une recherche pure de stations, `fuel-stations` ; pour un classement par prix, `fuel-cheapest`.
GET https://nakordoni.eu/api/v2/data/fuel-local
— 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 au niveau des stations, en km (par défaut 25, maximum 25 ; alias : radius). Si aucune station ne s'y trouve, la réponse bascule au niveau du pays : la recherche ne s'élargit jamais d'elle-même. |
fuel_type | Filtre facultatif au niveau des stations : diesel | e5 | e10 | superplus | super100 | premdiesel | truckdiesel | hvo | lpg | cng | adblue | e85 | lng. Ignoré au niveau du pays, qui renvoie toujours tous les carburants déclarés par le pays. 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 au niveau station (par défaut 5, max. 20) |
lang | Langue des libellés et du nom du pays (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.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"
Mis à jour