Skip to content

mariush444/fuelfr

Repository files navigation

image
Fuel🇫🇷GPX · Fuel🇪🇸GPX

Fuel prices exported as color-coded icons

GPX for OsmAnd • KMZ for Organic/Comaps

Platform License osmand KMZ GitHub Tag

Fuel🇫🇷GPX and Fuel🇪🇸GPX are open-source Android applications. They download official public fuel price datasets and generate a GPX layer compatible with OsmAnd and KMZ layer compatible with Organic Maps / Comaps. Fuel prices are visualized using color-coded icons, dynamically calculated between the minimum and maximum price of the selected fuel type.

Both applications are entirely open-source and respect user privacy.
All processing is performed locally on the device.
No analytics, tracking, or advertisements are included.

Designed for drivers and travelers who want a simple and transparent way to visualize fuel prices directly in OsmAnd or OM/CM.


Color Logic

For the selected fuel type, prices are divided dynamically between:

min price → max price

Colors are assigned as follows:

  • – cheapest (min → min + 5%)
  • – 5% → 10%
  • – 10% → 20%
  • – 20% → 30%
  • – 30% → 70%
  • – 70% → 80%
  • – 80% → 90%
  • – most expensive (90% → max)

If a station does not sell the selected fuel type:

  • = fuel not available

Functionality

1. Black Icons (Fuel Not Sold - option available for Osmand only)

  • Displayed in OsmAnd as a separate category: "Absence"
  • Can be disabled in OsmAnd view
  • Can be excluded from the generated GPX file
    (option: "Include stations without this fuel")

This reduces file size if disabled.


2. Supported Fuel Types

The application supports the following fuel types (as defined in official data):

🇫🇷 France Gazole · SP95 · SP98 · E85 · E10 · GPLc
🇪🇸 Spain Conventional
Gasoleo A · Gasoleo B · Gasoleo Premium · Gasolina 95 E5 · Gasolina 95 E10 · Gasolina 95 E25 · Gasolina 95 E5 Premium · Gasolina 95 E85 · Gasolina 98 E5 · Gasolina 98 E10

Renewable
Biodiesel · Bioetanol · Diésel Renovable · Gasolina Renovable

Gas & Alternative
Gas Natural Comprimido · Gas Natural Licuado · Biogas Natural Comprimido · Biogas Natural Licuado · Gases licuados del petróleo · Hidrogeno · Adblue

The user selects which fuel type should determine the color ordering.


3. Waypoint Name Contains

Each gas station waypoint includes:

🇫🇷 France Fuel price (selected type) • Date of price update • Selected services (represented using UTF icons)
🇪🇸 Spain Name of selected type of fuel • Fuel price

4. Waypoint Description Contains

  • All available fuel prices
  • Dates of each price update (France only)
  • Only fuels sold at that station

Output

The generated GPX file can be directly imported into:

OsmAnd

and used as a visual fuel price layer.


Privacy

Both apps: Fuel🇫🇷GPX and Fuel🇪🇸GPX respects user privacy.

  • The app does not collect personal data.
  • The app does not require user accounts.
  • The app does not use analytics.
  • The app does not contain advertisements.
  • The app does not track user location.

The application only:

All processing is done locally on the device. No data is sent to any third-party servers.

Internet permission is used only to download official open data.


Build Instructions

Requirements

  • Linux (recommended)
  • Java 17
  • Android SDK
  • Gradle Wrapper (included)

Clone the repository

git clone https://github.com/mariush444/fuelfr.git
cd fuelfr

Build Debug APK

./gradlew assembleESDebug
./gradlew assembleFRDebug

APK will be located at:

app/build/outputs/apk/es/debug/
app/build/outputs/apk/fr/debug/

Build Release APK

./gradlew assembleESRelease
./gradlew assembleFRRelease

APK will be located at:

app/build/outputs/apk/es/release/
app/build/outputs/apk/fr/release/

Notes

  • Make sure JAVA_HOME is correctly set.
  • Make sure Android SDK is installed and local.properties contains:
sdk.dir=/path/to/your/android/sdk

Screenshots