Skip to main content
Donate to the Python Software Foundation or Purchase a PyCharm License to Benefit the PSF! Donate Now

Library for Tankerkoenig.de JSON API

Project description

pytankerkoenig

Python package for fuel data from tankerkoenig.de

Prerequisites

You need to request an API-Key here: https://creativecommons.tankerkoenig.de.

For station details, find the station id via this tool: https://creativecommons.tankerkoenig.de/TankstellenFinder/index.html

Installation

$ pip install pytankerkoenig

Use

getStationData(API_KEY, STATION_ID)

>>> import pytankerkoenig
>>> data = pytankerkoenig.getStationData('00000000-0000-0000-0000-000000000002','24a381e3-0d72-416d-bfd8-b2f65f6e5802')
>>> print(data)
{
    'ok': True,
    'license': 'CC BY 4.0 -  https://creativecommons.tankerkoenig.de',
    'data': 'MTS-K',
    'status': 'ok',
    'station': {
        'id': '24a381e3-0d72-416d-bfd8-b2f65f6e5802',
        'name': 'Esso Tankstelle',
        'brand': 'ESSO',
        'street': 'HAUPTSTR. 7',
        'houseNumber': ' ',
        'postCode': 84152,
        'place': 'MENGKOFEN',
        'openingTimes': [{'text': 'Mo-Fr', 'start': '06:00:00',
                         'end': '22:00:00'}, {'text': 'Samstag',
                         'start': '07:00:00', 'end': '22:00:00'},
                         {'text': 'Sonntag, Feiertag',
                         'start': '08:00:00', 'end': '22:00:00'}],
        'overrides': [],
        'wholeDay': False,
        'isOpen': True,
        'e5': 1.009,
        'e10': 1.009,
        'diesel': 1.009,
        'lat': 48.72210601,
        'lng': 12.44438439,
        'state': None,
        },
    }

getPriceList(API_KEY, STATION_IDS[])

>>> import pytankerkoenig
>>> data = pytankerkoenig.getStationData('00000000-0000-0000-0000-000000000002',['5bd71e9d-7001-4908-a29d-36c28d6eb615','005056ba-7cb6-1ed2-bceb-92a737c6ad35'])
>>> print(data)
{
    'ok': True,
    'license': 'CC BY 4.0 -  https://creativecommons.tankerkoenig.de',
    'data': 'MTS-K',
    'prices': {'005056ba-7cb6-1ed2-bceb-92a737c6ad35': {
        'status': 'open',
        'e5': 1.234,
        'e10': 1.234,
        'diesel': 1.234,
        }, '5bd71e9d-7001-4908-a29d-36c28d6eb615': {
        'status': 'open',
        'e5': 1.234,
        'e10': 1.234,
        'diesel': 1.234,
        }},
    }

getNearbyStations(API_KEY, LATITUDE, LONGITUDE, RADIUS, TYPE, SORT)

>>> import pytankerkoenig
>>> data = pytankerkoenig.getNearbyStations('00000000-0000-0000-0000-000000000002','50.75','7.25','3','all','dist')
>>> print(data)
{
  'ok': True,
  'license': 'CC BY 4.0 -  https://creativecommons.tankerkoenig.de',
  'data': 'MTS-K',
  'status': 'ok',
  'stations': [{
    'id': '1bb14157-1242-41fc-a74a-4f916dea4634',
    'name': 'Sankt Augustin Birlinghoven',
    'brand': 'Mundorf Tank',
    'street': 'Pleistalstraße',
    'place': 'Sankt Augustin-Birlinghoven',
    'lat': 50.748416,
    'lng': 7.225838,
    'dist': 1.7,
    'diesel': 1.009,
    'e5': 1.009,
    'e10': 1.009,
    'isOpen': False,
    'houseNumber': '231',
    'postCode': 53757
  }, {
    'id': 'd4a4644c-cd86-42a5-9cfa-ec6c58204312',
    'name': 'Hennef-Geistingen',
    'brand': 'Mundorf Tank',
    'street': 'Stoßdorfer Straße',
    'place': 'Hennef-Geistingen',
    'lat': 50.773616,
    'lng': 7.265088,
    'dist': 2.8,
    'diesel': 1.009,
    'e5': 1.009,
    'e10': 1.009,
    'isOpen': True,
    'houseNumber': '8a',
    'postCode': 53773
  }]
}

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
pytankerkoenig-0.0.6.tar.gz (3.1 kB) Copy SHA256 hash SHA256 Source None

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page