[APP][Pro] Fuel Prices (France)

Fuel Prices France

Fill up at the best price, without thinking about it.

Everyone knows the station on the ring road that is three cents cheaper. Fewer people do the sum. With a 50-litre tank, three cents a litre is €1.50. A 10 km detour, there and back, at 6.5 L/100 km, burns 1.3 litres, and that costs more than €1.50 as soon as fuel is above €1.16 a litre. It has been a while.

This app does the sum for you. It follows the cheapest station within a radius you choose, or one station you care about, and it ranks stations on what you actually save once the detour is paid for.

Where the prices come from

French filling stations declare their own prices, and the Ministry of the Economy publishes them as open data on data.economie.gouv.fr, under the Licence Ouverte. The feed is refreshed several times a day. No account, no API key.

Requirements

  • Homey Pro running firmware 12.2.0 or newer.
  • Not available on Homey Cloud: the app runs locally.
  • Your Homey’s location, unless you give a device a custom one.
  • France only. The dataset stops at the border, and so does the app.

Two devices

Cheapest fuel station searches a radius around your Homey for one fuel and keeps the best station. Tracked station follows one station you pick at pairing; the list starts with the stations closest to you.

Capability What it tells you
Cheapest price The price per litre at the station kept
Price change The difference with the previous reading
Net saving per tank What a full tank there saves against the local average, detour deducted (cheapest station only)
Cost of a full tank Price times your tank size
Good time to refuel Alarm: today’s price is among the cheapest of the last 30 days
Price level over 30 days Where today’s price sits in its own month, in per cent
Cheapest station, Address, Distance Which station, where, how far
Average price in radius Cheapest station only
Stations found Cheapest station only
Stations out of stock Share of stations that have run out of that fuel (cheapest station only)
Price updated When the station last declared its price

Fuels: Diesel, SP95-E10, SP95, SP98, E85 and LPG.

The widget

  • Cheapest fuel shows the fuel, the station and its price in large type, then the address, the distance and the time of the price. Pick a device from the list (type to search), or leave it empty and choose a fuel: the tile then shows the lowest price your devices have found for it.

Five backgrounds: Deep blue, Slate, Plum, Forest and Sand.

Flow cards

Triggers:

  • [device]: it became a good time to refuel
  • A new cheapest station was found
  • [device]: The cheapest price went below [threshold] €/L
  • [device]: The cheapest price changed
  • [device]: The cheapest price dropped by at least [threshold] €/L
  • [device]: The cheapest price rose by at least [threshold] €/L
  • More than [threshold] % of stations are out of stock

Conditions:

  • The cheapest station is within [distance] km
  • [device]: it is a good time to refuel
  • [device]: The cheapest price is below [threshold] €/L
  • The cheapest price is at least [margin] €/L below the local average
  • The saving on a tank is above [amount] €
  • [station] is the cheapest station

Actions:

  • Find the cheapest [fuel] within [radius] km, which works without any device and hands back the station, its price and a map link
  • [device]: Refresh prices
  • Set the search radius to [radius] km

The out-of-stock trigger fires when the share crosses your threshold, not on every update while it stays above it.

Why “good time to refuel” is not a price

A threshold in euros has to be moved every time the market moves. A threshold of “among the cheapest 20 % of the last 30 days” does not. The app keeps its own price history on your Homey, one reading every three hours at most, and ranks today’s price against it.

It needs about a day and a half of history, twelve readings, before it says anything. Until then the price level is empty rather than wrong.

Settings

Per device:

Setting Default
Fuel Diesel
Search radius 30 km (1 to 200)
Refresh interval 60 minutes (15 to 1440)
Station to keep Best net value (detour deducted), or Lowest price per litre
Exclude motorway stations Off
Only stations open now Off
Only stations with a 24/7 card terminal Off
Required service No requirement, or car wash, food shop, air pump, cash machine and a few others
Use a custom location Off: Homey’s own location
Good price threshold 20 %
Stations kept in memory 10

In the app settings, Vehicle: tank capacity and average consumption. Left empty, the app assumes 50 L and 6.5 L/100 km, and says so in the capability titles, so a “Cost of a full tank” never pretends to be more precise than it is.

What it does not do

  • Distances are as the crow flies, not by road. The detour is priced on twice that distance, which flatters stations behind a river or a motorway with no exit.
  • Opening hours are only as good as what stations declare. About half of them declare nothing. Those are kept when you ask for stations open now, rather than silently dropped.
  • Prices are what the station declared, when it declared it. The Price updated capability is there so you can see how fresh that is.

Languages

English, French, German, Spanish, Italian, Dutch, Danish, Norwegian, Swedish.

Reporting a problem

Post here with your Homey firmware version and the app version. Then open the app’s settings page, press Generate the report and paste it: it lists your Homey context, the state of every device and the recent log, and contains no credentials. If a station looks wrong, give its name and town, and the fuel.

More about the app, every widget and Flow card included: Fuel Prices France for Homey — Rapinology

Feedback and testers welcome.

Have fun :wink: