OpenHAB
/
openhab-docs
mirror of https://github.com/openhab/openhab-docs.git
1
0
Fork 0
Code Issues Projects Releases Wiki Activity

Updated external content (Jenkins build 221)

pull/944/head
openhab-bot 2019-04-18 07:16:14 +00:00
parent 4d324af8fe
commit 076ef8fd63
1 changed files with 12 additions and 12 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

24
_addons_bindings/tankerkoenig/readme.md
View File

@ -3,7 +3,7 @@ id: tankerkoenig
label: Tankerkönig
title: Tankerkönig - Bindings
type: binding
description: "The binding uses the Tankerkönig API <https://www.tankerkoenig.de> for collecting gas price data of german gas stations."
description: "The binding uses the Tankerkönig API <https://www.tankerkoenig.de> for collecting gas price data of German gas stations."
since: 2x
logo: images/addons/tankerkoenig.png
install: auto
@ -15,8 +15,8 @@ install: auto
# Tankerkönig Binding
The binding uses the Tankerkönig API <https://www.tankerkoenig.de> for collecting gas price data of german gas stations.
Special thanks to the creators of Tankerkönig for providing an easy way to get data from the &lsqb;MTS-K&rsqb; (Markttransparenzstelle für Kraftstoffe).
The binding uses the Tankerkönig API <https://www.tankerkoenig.de> for collecting gas price data of German gas stations.
Special thanks to the creators of Tankerkönig for providing an easy way to get data from the &lsqb;MTS-K&rsqb; (Markttransparenzstelle für Kraftstoffe).
Tankerkönig is providing this service for free, however they request to prevent overloading of their server by reducing the number of web-requests.
This binding handles those requests (minimum Refresh Interval is 10 minutes, a webserver does handle a maximum of 10 stations).
@ -31,18 +31,19 @@ While using the mode Opening-Times the channel "station_open" will NOT show "clo
In order to use this binding one needs to prepare:
-minimal Java Varsion is 1.8.0_101-b13 (otherwise the https request will not produce a usable return)
- minimal Java Version is 1.8.0_101-b13 (otherwise the https request will not produce a usable return)
-a personal API-Key
- a personal API-Key
Request a free Tankerkönig API key from: <https://creativecommons.tankerkoenig.de/> Select the tab "API-Key".
Request a free Tankerkönig API key from: <https://creativecommons.tankerkoenig.de/> (Select the tab "API-Key").
-LocationIDs of the selected gas stations
- LocationIDs of the selected gas stations
Search for the gas station IDs here: <https://creativecommons.tankerkoenig.de/configurator/index.html>
Search for the gas station IDs via the [finder tool](https://creativecommons.tankerkoenig.de/TankstellenFinder/index.html) (Select tab "Tools" -> "Tankstellenfinder").
Drag the red marker on the map to the rough location of desired gas stations.
Select the gas stations and click "Tankstellen übernehmen" on the right.
This will download a file holding the location IDs. For example: a7cdd9cf-b467-4aac-8eab-d662f082511e
This will download a file holding the location IDs.
For example: `a7cdd9cf-b467-4aac-8eab-d662f082511e`
## Supported Things
@ -70,7 +71,7 @@ Each Station needs to be configured with a LocationID and the Webservice to whic
## Channels
The binding introduces the channel holiday for the Webservice and the channels e10, e5 ,diesel and station_open for the Stations:
The binding introduces the channel `holiday` for the Webservice and the channels `e10`, `e5`, `diesel` and `station_open` for the Stations:
| Channel ID | Channel Description | Supported item type | Advanced |
|--------------|---------------------------------------|---------------------|----------|
@ -175,10 +176,9 @@ The required password is "changeit".
Restart your server
-The Station(s) and Webservice go to OFFLINE after being ONLINE
Either the web-request to Tankerköng returned a failure or no valid response was received (this could be caused by a banned API-key).
Either the web-request to Tankerkönig returned a failure or no valid response was received (this could be caused by a banned API-key).
In both cases the Webservice and the Station(s) go OFFLINE.
If the Tankerkönig return indicates an error a descriptive message (in German) is added next to the OFFLINE which will be displayed on the Webservice and Station(s) pages on PaperUI.
On the next receipt of a valid message Webservice and Station(s) will go ONLINE again.