Skip to content

Ein Python API Wrapper für die API von tankerkönig. Gibt Informationen als Objekt zurück

Notifications You must be signed in to change notification settings

DasMoorhuhn/python-gas-station-api

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

14 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Python Tankstellen Api Wrapper

Dies ist ein API Wrapper für Tankstellen in Deutschland. Als Quelle wird TankerKönig verwendet. Ziel ist es, einfache Objekte zu bekommen mit allen Daten einer Tankstelle. Jaaaa ich weiß, es gibt die PyTankerKoening Lib, die haut aber das JSON einfach so raus.

Getting started

  1. API Key:
    1. API Key anlegen -> API-KEY
    2. Neue Datei mit dem Namen secret.txt im Ordner der lib erstellen
    3. Den API Key in die Datei kopieren.

  2. SercretHandler:
    1. Das Objekt secret vom secretHandler erstellen
    2. Die Methode loadFromSecret ausführen. Damit wird die Datei secret.txt ausgelesen.
    3. Rückgabewerte:
      • 0: Secret wurde geladen
      • 1: Fehler beim Lesen von secret.txt

  3. ApiHandler:
    1. api Objekt erstellen. Mit übergeben wird die Postleitzahl und das secret Objekt
    2. Methoden:
      • getGasStations(raduisInKM:float, spritType:str, onlyInThisPostCode:bool, sortedBy:str):

        • raduisInKM:
          • max: 25
          • Radius in Kilometer um die Postleitzahl herum
        • spritType:
          • e5
          • e10
          • diesel
          • all
        • onlyInThisPostCode:
          • True: Gibt nur die Tankstellen zurück, die mit der Postleitzahl vom api Objekt (classes.city) übereinstimmen
          • False: Gibt alle Tankstellen im diffinierten Radius zurück
        • sortedBy [TODO]:
          • price: Sortiert die Liste nach Preis (Von Günstig nacg Teuer)
          • postCode: Sortiert die Liste nach Postleitzahl (Aufsteigend)
          • distance: Sortiert die Liste nach Distanz zur Postleitzahl (Aufsteigend, KM)
          • none: gibt die Liste ohne überarbeitung weiter
        • return value:
          • Liste der Tankstellen
      • getGasStationDetails(stationID:str):

        • stationID: die Tankstellen ID
        • return value:
          • gasStationDetail Objekt (classes.gasStationDetail)
          • 1 bei einem Fehler

Libs

pgeocode: Für die Längen- und Breitengrade von einer Postleitzahl
requests: Zum aufrufen der TankerKönig API

About

Ein Python API Wrapper für die API von tankerkönig. Gibt Informationen als Objekt zurück

Topics

Resources

Stars

Watchers

Forks

Packages

No packages published

Languages