Beispielcode PHP list.php

• 01 Mai 2017
• Beispielcode PHP list.php

Aufruf aus PHP

$lat = $_GET["lat"];
$lng = $_GET["lng"];
$radius = $_GET["radius"];
$sort = $_GET["sort"];
$type = $_GET["type"];
$json = file_get_contents('https://creativecommons.tankerkoenig.de/json/list.php'
    ."?lat=$lat"     // geographische Breite
    ."&lng=$lng"     //               Länge
    ."&rad=$radius"  // Suchradius in km
    ."&sort=$sort"   // Sortierung: 'price' oder 'dist' - bei type=all diesen Parameter weglassen
    ."&type=$type"   // Spritsorte: 'e5', 'e10', 'diesel' oder 'all'
    ."&apikey=00000000-0000-0000-0000-000000000002");   // Demo-Key ersetzen!
$data = json_decode($json);
display($data);

Beispielcode Javascript list.php

• 01 Mai 2017
• Beispielcode JS list.php

Aufruf aus JS, mit jQuery

Ein Sprittyp

$.ajax({
    url: "https://creativecommons.tankerkoenig.de/json/list.php",
    data: {
        lat: position.coords.latitude,
        lng: position.coords.longitude,
        rad: 2,
        sort: "price",
        type: "diesel",
        apikey: "00000000-0000-0000-0000-000000000002"
    },
    success: function(response) {
        if (!response.ok) {
            // TODO: Fehlerbehandlung
            console.error(response.message);
        } else {
            // TODO: Anzeige der Informationen
            console.log(response);
        }
    },
    error: function(p){
        that.showError('AJAX-Problem', 'status: ' + p.status + ' statusText: ' + p.statusText);
    }
});

Alle Spritsorten

$.ajax({
    url: "https://creativecommons.tankerkoenig.de/json/list.php",
    data: {
        lat: position.coords.latitude,
        lng: position.coords.longitude,
        rad: 2,
        type: "all",
        apikey: "00000000-0000-0000-0000-000000000002"
    },
    success: function(response) {
        if (!response.ok) {
            // TODO: Fehlerbehandlung
            console.error(response.message);
        } else {
            // TODO: Anzeige der Informationen
            console.log(response);
        }
    },
    error: function(p){
        that.showError('AJAX-Problem', 'status: ' + p.status + ' statusText: ' + p.statusText);
    }
});

Beispielcode PHP prices.php

• 01 Mai 2017
• Beispielcode PHP prices.php

Aufruf aus PHP

Beispielcode Javascript prices.php

• 01 Mai 2017
• Beispielcode JS prices.php

Aufruf aus JS, mit jQuery

var station_ids = [];                               // Liste
$.each(stations, function(){
    station_ids.push(this.id); // nur die IDs       // Füllen der Liste mit IDs der Tankstellen aus list.php Aufruf
});

station_ids_string = station_ids.join(',');         // IDs ohne Hochkommas mit Kommas getrennt verbunden

$.ajax({                                            // jQuery für Server-Request - kann natürlich auch mit eigenem Code,
                                                    // oder anderen Libs gemacht werden.
    url: "https://creativecommons.tankerkoenig.de/json/prices.php",
    data: {
        ids: station_ids_string,                    // stringifiziertes Array mit Tankstellen-Ids
        apikey: '00000000-0000-0000-0000-000000000002'
    },
    success: function( response ) {                 // Antwort vom Server wird hier verarbeitet
        if (response.ok) {                          // Daten in Ordnung?
            successHandler(response.prices);        // TODO: eigene Funktion um Preise anzuzeigen und/oder zu speichern
        } else {
            errorHandler(response.message);         // TODO: Fehlermeldung anzeigen
        }
    },
    error: function(p){                             // Behandlung technischer Probleme
        errorHandler('AJAX-Problem, status: ' + p.status + ' statusText: ' + p.statusText);
    }
});

Beispielcode PHP detail.php

• 01 Mai 2017
• Beispielcode PHP detail.php

Aufruf aus PHP

Beispielcode Javascript detail.php

• 01 Mai 2017
• Beispielcode JS detail.php

Aufruf aus JS, mit jQuery

id = stationList[0].id;
$.ajax({
    url: "https://creativecommons.tankerkoenig.de/json/detail.php",
    data: {
        id: id,     // Tankstellen-Id
        apikey: '00000000-0000-0000-0000-000000000002'
    },
    success: function( response ) {
        if (!response.ok) {
            // TODO: Fehlerbehandlung
            console.error(response.message);
        } else {
            // TODO: Anzeige der Informationen
            console.log(response);
        }
    }
});

Beispielcode Javascript complaint.php

• 01 Mai 2017
• Beispielcode JS complaint.php

Aufruf aus JS, mit jQuery

function sendComplaint(stationId, complaintType, correction){
    var apikey = '00000000-0000-0000-0000-000000000002'; // Demo-Key nur zum Testen, diese Requests werden nicht weitergegeben

    var data = {
        apikey: apikey,
        id: stationId,
        type: complaintType
    };

    if (correction) {
        data.correction = correction;
    }

    $.ajax({
        url: "https://creativecommons.tankerkoenig.de/json/complaint.php",
        method: 'POST',
        data: data,
        success: function( response ) {
            if (!response.ok) {
                alert(response.message);
            } else {
                alert('Meldung erfolgreich übertragen');
            }
        }
    });
}


var stationId = 'd3f68a43-e249-4a1f-bd34-0023677cdcc9';

// Test 1
sendComplaint(stationId, 'wrongStatusClosed', null);    // keine Korrekturangabe erlaubt
// Test 2
sendComplaint(stationId, 'wrongPriceDiesel', 1.234);
// Test 3
sendComplaint(stationId, 'wrongPetrolStationLocation', '52.29162,10.06117');
// Test 4
sendComplaint(stationId, 'illegal token', '52.29162,10.06117');

Tankstellen-Info

• 01 Mai 2017
• Tankstellen-Info

JSON-Rückgabe des Tankstellen-Finders

{
  "005056ba-7cb6-1ed2-bceb-8a39e78c8d33": {             ID der ersten Tankstelle
    "label": "STAR | star Tankstelle",                  generierte Bezeichnung
    "coords": {                                         Geo-Koordinaten
      "lat": 53.10815,
      "lng": 8.77395
    },
    "address": [                                        Adresszeilen
      "Waller Heerstraße 294",
      "28219 Bremen"
    ],
    "openingTimes": {                                   Öffnungszeiten
      "Mo, Di, Mi, Do": [                               erste Öffnungszeit
        "06:00 - 23:00"
      ],
      "Fr, Sa": [                                       zweite Öffnungszeit
        "06:00 - 00:00"
      ],
      "So": [                                           dritte Öffnungszeit
        "07:00 - 23:00"
      ]
    },
    "overrides": [                                      geänderte Öffnungszeiten
      {
        "startp": "2016-10-17 06:00",                   von
        "endp": "2016-10-17 10:00",                     bis
        "is_close": false                               hat - anders als in den normalen ÖZ angegeben - zu
      },
      ... weitere Overrides
    ]
  },
  "e854dc9b-18b1-4f48-cb94-c3125f9ca47d": {             ID der zweiten Tankstelle
    "label": "Bremer Mineralölhandel GmbH | BMÖ Tankstelle Hötzer",
    "address": [
      "Plantage 17",
      ...
    }
  },
  ... weitere Tankstellen-Infos
}        

Mit den Informationen aus der erzeugten Datei ('stations.json') kann je nach eingesetzter Technik per PHP, Javascript oder anderen Sprachen ein Layout erzeugt werden, in das nur noch die aktuellen Preise eingefügt werden müssen, die mit prices.php von Tankerkönig bezogen werden.

Kommerzieller Service

• 21 Februar 2017
• Kommerzieller Service

Massenabfragen

Unser CC-Server kann täglich viele hunderttausend Abfragen beantworten. Damit alle User und deren Klienten (App-, Websites-User) möglichst ohne Verzögerung und Serverausfälle an aktuelle Daten kommen, sind auf der Seite unseres Servers einige Maßnahmen umgesetzt, die sicherstellen, dass einzelne Datennehmer andere nicht beeinträchtigen. Das heißt, dass ein User, der eine zu hohe Last erzeugt, temporär oder dauerhaft vom Service ausgeschlossen werden kann.

Wenn klar ist, das der geplante Service nicht mit dieser Einschränkung umgesetzt werden kann, können wir gegen eine monatliche Gebühr einen dedizierten Server aufsetzen, auf dem diese Limitierungen nicht existieren.

API-Anpassungen

Auch Einschränkungen beim Radius der Umkreissuche und Begrenzung bei der Anzahl abgefragter Tankstellen beim Preisabruf, die ebenfalls der Lastbegrenzung des CC-Server dienen, können bei einem dedizierten Server entfernt werden.

Abfrage weiterer Informationen

Weitere API-Methoden können freigeschaltet werden, z.B.:

• Zeitpunkt der letzten Preisänderung
• Aggregierte Queries (bspw. Durchschnittspreise für PLZ-Bereich)
• Filterung mit PLZ, Name oder Marke
• Tankstelle ist offen bis Zeitpunkt / öffnet zum Zeitpunkt

Eigenes Hosting

Falls die verfügbaren Daten auf eigenen Servern gehostet werden sollen, stehen mehrere Alternativen zur Verfügung:

• Dedizierter Server, auf Wunsch mit Anpassungen der API, siehe oben
• Regelmäßige Übernahme aller Preisdaten in gewünschtem Format (JSON, XML, CSV)

Unterstützung bei Aufbereitung der historischen Daten

Die frei verfügbaren historischen Preisdaten liegen in Form von PostgreSQL Datenbank-Dumps vor.
Andere Formate wie JSON, MySQL, XML und CSV können gegen Gebühr erstellt werden.

Eigene Queries der historischen Preisdaten stehen demnächst interessierten Usern per Web-Interface zur Verfügung.

Wir übernehmen auch gerne individuelle Aufbereitungen der Daten.

Impressum

• 21 Februar 2017
• Impressum

Angaben gemäß § 5 TMG:

Martin Kurz
Mimosenweg 66
70374 Stuttgart

Kontakt:

Telefon: 0711 51882513
E-Mail: martinkurz@tankerkoenig.de

Quelle: https://www.e-recht24.de

Datenschutz

• 15 November 2016
• Datenschutz

Datenschutz

Die Betreiber dieser Seiten nehmen den Schutz Ihrer persönlichen Daten sehr ernst. Wir behandeln Ihre personenbezogenen Daten vertraulich und entsprechend der gesetzlichen Datenschutzvorschriften sowie dieser Datenschutzerklärung.

Die Nutzung unserer Webseite ist in der Regel ohne Angabe personenbezogener Daten möglich. Soweit auf unseren Seiten personenbezogene Daten (beispielsweise Name, Anschrift oder E-Mail-Adressen) erhoben werden, erfolgt dies, soweit möglich, stets auf freiwilliger Basis. Diese Daten werden ohne Ihre ausdrückliche Zustimmung nicht an Dritte weitergegeben.

Wir weisen darauf hin, dass die Datenübertragung im Internet (z.B. bei der Kommunikation per E-Mail) Sicherheitslücken aufweisen kann. Ein lückenloser Schutz der Daten vor dem Zugriff durch Dritte ist nicht möglich.

Cookies

Die Internetseiten verwenden teilweise so genannte Cookies. Cookies richten auf Ihrem Rechner keinen Schaden an und enthalten keine Viren. Cookies dienen dazu, unser Angebot nutzerfreundlicher, effektiver und sicherer zu machen. Cookies sind kleine Textdateien, die auf Ihrem Rechner abgelegt werden und die Ihr Browser speichert.

Die meisten der von uns verwendeten Cookies sind so genannte „Session-Cookies“. Sie werden nach Ende Ihres Besuchs automatisch gelöscht. Andere Cookies bleiben auf Ihrem Endgerät gespeichert, bis Sie diese löschen. Diese Cookies ermöglichen es uns, Ihren Browser beim nächsten Besuch wiederzuerkennen.

Sie können Ihren Browser so einstellen, dass Sie über das Setzen von Cookies informiert werden und Cookies nur im Einzelfall erlauben, die Annahme von Cookies für bestimmte Fälle oder generell ausschließen sowie das automatische Löschen der Cookies beim Schließen des Browser aktivieren. Bei der Deaktivierung von Cookies kann die Funktionalität dieser Website eingeschränkt sein.

Server-Log-Files

Der Provider der Seiten erhebt und speichert automatisch Informationen in so genannten Server-Log Files, die Ihr Browser automatisch an uns übermittelt. Dies sind:

• Browsertyp/ Browserversion
• verwendetes Betriebssystem
• Referrer URL
• Hostname des zugreifenden Rechners
• Uhrzeit der Serveranfrage

Diese Daten sind nicht bestimmten Personen zuordenbar. Eine Zusammenführung dieser Daten mit anderen Datenquellen wird nicht vorgenommen. Wir behalten uns vor, diese Daten nachträglich zu prüfen, wenn uns konkrete Anhaltspunkte für eine rechtswidrige Nutzung bekannt werden.

Kontaktformular

Wenn Sie uns per Kontaktformular Anfragen zukommen lassen, werden Ihre Angaben aus dem Anfrageformular inklusive der von Ihnen dort angegebenen Kontaktdaten zwecks Bearbeitung der Anfrage und für den Fall von Anschlussfragen bei uns gespeichert. Diese Daten geben wir nicht ohne Ihre Einwilligung weiter.

Auskunft, Löschung, Sperrung

Sie haben jederzeit das Recht auf unentgeltliche Auskunft über Ihre gespeicherten personenbezogenen Daten, deren Herkunft und Empfänger und den Zweck der Datenverarbeitung sowie ein Recht auf Berichtigung, Sperrung oder Löschung dieser Daten. Hierzu sowie zu weiteren Fragen zum Thema personenbezogene Daten können Sie sich jederzeit unter der im Impressum angegebenen Adresse an uns wenden.

Widerspruch Werbe-Mails

Der Nutzung von im Rahmen der Impressumspflicht veröffentlichten Kontaktdaten zur übersendung von nicht ausdrücklich angeforderter Werbung und Informationsmaterialien wird hiermit widersprochen. Die Betreiber der Seiten behalten sich ausdrücklich rechtliche Schritte im Falle der unverlangten Zusendung von Werbeinformationen, etwa durch Spam-E-Mails, vor.

Quelle: https://www.e-recht24.de

Einbindung von Diensten und Inhalten Dritter

Es kann vorkommen, dass innerhalb dieses Onlineangebotes Inhalte Dritter, wie zum Beispiel Videos von YouTube, Kartenmaterial von Google-Maps, RSS-Feeds oder Grafiken von anderen Webseiten eingebunden werden. Dies setzt immer voraus, dass die Anbieter dieser Inhalte (nachfolgend bezeichnet als "Dritt-Anbieter") die IP-Adresse der Nutzer wahr nehmen. Denn ohne die IP-Adresse, könnten sie die Inhalte nicht an den Browser des jeweiligen Nutzers senden. Die IP-Adresse ist damit für die Darstellung dieser Inhalte erforderlich. Wir bemühen uns nur solche Inhalte zu verwenden, deren jeweilige Anbieter die IP-Adresse lediglich zur Auslieferung der Inhalte verwenden. Jedoch haben wir keinen Einfluss darauf, falls die Dritt-Anbieter die IP-Adresse z.B. für statistische Zwecke speichern. Soweit dies uns bekannt ist, klären wir die Nutzer darüber auf.

Quelle: Datenschutz-Muster von Rechtsanwalt Thomas Schwenke - I LAW it

Format-Info

• 21 Februar 2017
• Format-Info

Datenbank-Tabellen

Tabelle gas_station

 Column                    | Type                        | Modifiers
---------------------------+-----------------------------+-----------
 id                        | uuid                        | not null
 version                   | character varying(10)       | not null
 version_time              | timestamp without time zone | not null
 name                      | text                        | not null
 brand                     | text                        |
 street                    | text                        |
 house_number              | text                        |
 post_code                 | text                        |
 place                     | text                        |
 public_holiday_identifier | text                        |
 lat                       | double precision            | not null
 lng                       | double precision            | not null
 ot_json                   | text                        | not null

Das sind im wesentlichen die Daten, die die MTS-K liefert.

Feld ot_json

Eine Tankstelle kann beliebig viele einzelne Öffnungszeiten haben. Ist keine angegeben ist die Tankstelle immer geöffnet. In diesem Fall steht in dem Feld '{}' - ein leeres Objekt.

Im Folgenden ein Beispiel

{
  "openingTimes": [
    {
      "applicable_days": 31,
      "periods": [
        {
          "startp": "05:00",
          "endp": "22:00"
        }
      ]
    },
    {
      "applicable_days": 96,
      "periods": [
        {
          "startp": "07:00",
          "endp": "22:00"
        }
      ]
    }
  ]
}

Diese Tanke hat 2 einzelne Öffnungszeiten. Gültig jeweils an den in applicable_days angegebenen Tagen.
Die Angabe in diesem Feld ist ein Bitfeld, einzelne Bits stehen für einzelne Tage:

Im Beispiel ist die erste Öffnungszeit also Montag bis Freitag gültig. (1+2+4+8+16 = 31) Die zweite Öffnungszeit gilt Samstag und Sonntag (32+64 = 96).
Da für die Tankstelle keine spezielle Feiertagsregelung angegeben ist, gilt dort ebenfalls die Öffnungszeit des Sonntags. Falls eine Öffnungszeit für Feiertag angegeben ist, ist auschließlich diese an Feiertagen gültig.

Neben den 'openingTimes' können auch 'overrides' gesetzt sein - Angaben zu geänderten Öffnungszeiten.

  "overrides": [
    {
      "startp": "2017-06-05 05:00",
      "endp": "2017-06-05 23:00",
      "is_close": false
    },
    {
      "startp": "2017-08-01 00:00",
      "endp": "2017-09-01 00:00",
      "is_close": true
    }
  ]

Hier: am 5. Juni 2017 hat diese Tanke entgegen den Angaben in den regulären ÖZ zwischen 05:00 und 23:00 geöffnet. Im August hat die Tankstelle geschlossen. Angaben der regulären ÖZ werden innerhalb der Zeiträume der overrides ignoriert.

Öffnungszeiten können sich ändern. Im Moment ist eine History der Öffnungszeiten allerding im Rahmen der CC-Daten nicht verfügbar.

Tabelle gas_station_information_history

 Column  |            Type             | Modifiers
---------+-----------------------------+-----------
 id      | integer                     | not null
 stid    | uuid                        | not null
 e5      | smallint                    |
 e10     | smallint                    |
 diesel  | smallint                    |
 date    | timestamp(0) with time zone | not null
 changed | smallint                    |

Hinweise

• In der History-Tabelle sind aus Platzgründen nur Preisänderungen gespeichert. Der Preis zu einem bestimmten Zeitpunkt muss also aus der letzten Änderung errechnet werden.
• Wurde ein ungültiger Preis übertragen, steht -1 in der jeweiligen Preis-Spalte.
• Die changed-Spalte enthält (ebenfalls aus Platzgründen) für jede Spritsorte (Diesel, E5, E10) Flags, die folgende Bedeutung haben und zusammenaddiert werden:

Bitmaske für die Änderung

Wenn z.B. Diesel- und E10-Preis geändert wurden, steht in changed 17 (1+16).

Ein Preis ist neu, wenn a) der Sprittyp bisher nicht von der Tankstelle geführt wurde, b) die Tankstelle neu ist, oder c) nachdem die MTS-K wegen Wartungsarbeiten eine Zeitlang keine Preise geliefert hat.