Tankerkoenig
The tankerkoenig integration allows you to monitor the fuel prices with tankerkoenig.de
Prerequisites
To use this integration, you need an API key from tankerkoenig.
- Go to tankerkoenig API
and in the top right, select API-KEY. - Fill out the form and request a free API key.
The Terms & Conditions of tankerkoenig.de specify that the API is not meant for massive data fetching, but it does not explicitly mention a limit. Having a maximum of 10 monitored fuel stations is recommended, and a warning will be issued otherwise. If you consider to define a custom polling interval, then please keep in mind that requests should be limited to less than once every 5 minutes.
Configuration
To add the Tankerkoenig integration to your Home Assistant instance, use this My button:
If the above My button doesn’t work, you can also perform the following steps manually:
-
Browse to your Home Assistant instance.
-
In the bottom right corner, select the
Add Integration button. -
From the list, select Tankerkoenig.
-
Follow the instructions on screen to complete the setup.
The tankerkoenig API-KEY to be used (see Prerequisites).
Pick the location where to search for gas stations (defaults to the location of your Home which was et during onboarding)
The radius in kilometers to search for gas stations around the selected location (default: 2km)
Options
Options for Tankerkoenig can be set via the user interface, by taking the following steps:
- Browse to your Home Assistant instance.
- Go to Settings > Devices & Services.
- If multiple instances of Tankerkoenig are configured, choose the instance you want to configure.
- Select the integration, then select Configure.
Data updates
This integration fetches the data every 30 minutes from the tankerkoenig API
Provides entities
This integrations provides a set of Binary sensorA binary sensor returns information about things that only have two states - such as on or off. [Learn more] and SensorSensors return information about a thing, for instance the level of water in a tank. [Learn more] entities for each selected gas station.
| Sensors | Description |
|---|---|
| Status | Indicates if the gas station is opened or closed at the moment. |
| Diesel | The current price of Diesel fuel. |
| Super | The current price of Super fuel. |
| Super E10 | The current price of Super E10 fuel. |
As the data of tankerkoenig.deDiesel, Super, and Super E10 are available.
Usage examples
Show current fuel price only when station is opened
The example below uses the common sensor card in the frontendThe frontend is a necessary component for the UI, it is also where you can define your themes. [Learn more] and adds a visibility condition.
graph: line
type: sensor
entity: sensor.my_favorite_gas_station_super
detail: 1
name: Favorite Gas Station
visibility:
- condition: state
entity: binary_sensor.my_favorite_gas_station_status
state: "on"
Troubleshooting
Before reporting an issue, enable debug logging and restart the integration. As soon as the issue re-occurs, stop the debug logging again (download of debug log file will start automatically). Further, if still possible, download the diagnosticsThe diagnostics integration provides a way to download diagnostic data from a device or integration for sharing in issue reports. Sharing diagnostics data when reporting an issue allows developers to diagnose and fix your reported problem quicker. [Learn more] data. If you have collected the debug log and the diagnostics data, include them in the issue report.
Remove the integration
To remove an integration instance from Home Assistant
- Go to Settings > Devices & services and select the integration card.
- From the list of devices, select the integration instance you want to remove.
- Next to the entry, select the three-dot
menu. Then, select Delete.