https://github.com/flix-29/bessertanken

BesserTanken - The best way to find the cheapest gas prices.
https://github.com/flix-29/bessertanken

Last synced: about 2 months ago
JSON representation

BesserTanken - The best way to find the cheapest gas prices.

• Host: GitHub
• URL: https://github.com/flix-29/bessertanken
• Owner: Flix-29
• License: other
• Created: 2024-03-12T17:53:16.000Z (about 1 year ago)
• Default Branch: main
• Last Pushed: 2025-04-12T13:44:27.000Z (about 2 months ago)
• Last Synced: 2025-04-12T14:43:04.010Z (about 2 months ago)
• Language: Java
• Homepage:
• Size: 6.65 MB
• Stars: 2
• Watchers: 1
• Forks: 1
• Open Issues: 8
• Metadata Files:
  • Readme: README.md
  • License: LICENSE.md

Awesome Lists containing this project

README

        
# BesserTanken

## Get the cheapest gas prices in your area.

This app uses the data from the [Kraftstoffbilliger-Api](https://kraftstoffbilliger.de/mts-k_api) to get the cheapest 

gas prices. To convert the german postal code and places to coordinates the app uses the 

[OpenDataSoft-Api](https://public.opendatasoft.com/explore/dataset/georef-germany-postleitzahl/table/). The results can be viewed on a map using the [Mapbox-Map](https://www.mapbox.com).

![image](src/main/resources/images/preview.png)

## How to start the application locally:

### Precondition:

1. You need to be able to run java code on your device.

2. You need to have a working internet connection.

3. You need an active Api-Key from [Kraftstoffbilliger](https://kraftstoffbilliger.de/mts-k_api) and [Mapbox](https://www.mapbox.com).

### Steps:

1. Clone the repository.

2. Open the project in your favorite IDE.

3. In the `application.properties` file enter your Api-Keys:

   - Either replace the value `your-api-key` with your corresponding Api-Keys.

   - Or create a new file in the `resources` directory and name it `secret.properties`. In this file, 

   add the following lines: 

     - `secrets.kraftstoffBilliger.apikey=your-api-key`,

     - `secrets.map.apikey=your-api-key`.

4. Start the application using the `main method` in the `Main` class or by running ```mvn``` in the command line.

5. By default, a browser window will open. If not, open your browser and navigate to `localhost:8080`.