DasMoorhuhn / python-gas-station-api

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

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

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


Languages

Language:Python 100.0%