Praxistest: Zugriff auf Mercedes-Benz Daten über die Auto-API

17. September 2019
In dem Maße, in dem Unternehmen unsere Auto-API für eine Vielzahl von Mobilitätsdiensten nutzen, erhalten wir von Anwendungsentwicklern Fragen zum Verhalten der Fahrzeuge der einzelnen Hersteller. Was löst aus, dass Autos neue Daten senden, wie schnell erscheinen Aktualisierungen über die API und ob die Daten während der Fahrt aktualisiert werden.

Der Feldversuch mit einem Mercedes-Benz

Um endgültige Antworten auf diese Fragen zu geben, testen wir echte Autos von jedem der von uns unterstützten Hersteller. Für diesen Artikel haben wir uns zum Hauptsitz von Mercedes-Benz in Stuttgart begeben, um die Auto-API mit einem ihrer neuesten Fahrzeuge, dem Mercedes-Benz E 300 de Diesel-Hybrid, zu testen.

Anstatt Datenpunkte à la carte zu liefern, bietet Mercedes-Benz eine Vielzahl von Datenbereichen an, von denen jeder eine Auswahl von Datenpunkten enthält, die auf bestimmte Anwendungsfälle zugeschnitten sind. Im Folgenden werden wir jedes dieser Buckets näher betrachten.

Dieser Artikel gibt einen kurzen Überblick über die Fahrzeugdatenprodukte von Mercedes-Benz, bevor wir die Ergebnisse unseres Testtages mit Beispieldaten und Diagrammen vorstellen. Einzelheiten zum Fahrzeug und zum Authentifizierungsverfahren finden Sie am Ende des Artikels.

Ein Hinweis auf kompatible Fahrzeuge und Regionen

Die überwiegende Mehrheit der Mercedes-Benz Pkw, die nach 2016 gebaut wurden, ist mit der Auto API von High Mobility kompatibel. Damit eine App Daten aus einem Auto abrufen kann, müssen einige zusätzliche Bedingungen erfüllt sein. Das Fahrzeug muss über ein Mercedes me connect-Abonnement verfügen, in dem der Dienst "Schnittstelle zu Drittanbietern" aktiviert ist, und der Fahrzeughalter muss dem Datenzugriff durch den Drittanbieter zustimmen.

Das Verfahren richtet sich an den Fahrzeugbesitzer: Ein völlig serienmäßiges, unverändertes Auto kommt vom Hof des Händlers und ist bereits mit unseren APIs kompatibel; keine Hardware, keine Installation und keine Konfiguration. Lediglich die Zustimmung des Fahrzeugbesitzers ist erforderlich. Das war's!

Die Datendienste erstrecken sich auf die folgenden Länder:

Normalerweise haben die APIs Anfragelimits; für unseren Test hat Mercedes-Benz diese Limits freundlicherweise aufgehoben, um das Testen verschiedener Anwendungsfälle in einer kurzen Zeitspanne zu ermöglichen.

Der Test

In unseren ersten Minuten mit dem Auto fuhren wir von Daimler in Stuttgart zum nahe gelegenen Mercedes-Benz Museum. Während der Fahrt überwachten wir jede API, um sicherzustellen, dass sie aktiv war und wie erwartet reagierte. Wir öffneten zum Beispiel das Schiebedach oder die Fenster und vergewisserten uns, dass die entsprechende API die Zustandsänderung wiedergab. Wir führten ähnliche Experimente mit allen Produktions-APIs durch. Die APIs für die "Berührungspunkte", mit denen wir interagierten - Türen, Fenster, Schiebedach und Schlösser - wurden innerhalb von Sekunden aktualisiert. Die API-Daten für andere Fahrzeugattribute, wie Kraftstoff- und Batteriestand, wurden eher sporadisch aktualisiert, mit einer maximalen Verzögerung von etwa fünfzehn Minuten.

Der Zweck dieses Tests war es, zu sehen:

Was hat das Fahrzeug veranlasst, Datenaktualisierungen zu senden?
Wie schnell waren die neuen Daten über die API verfügbar?
Wie können Dritte sie sinnvoll nutzen?

Nachdem wir uns vergewissert hatten, dass alles reibungslos funktionierte, begaben wir uns auf eine längere Fahrt. Die Idee war, lange genug zu fahren, um zu sehen, wie der Ladezustand der Batterie und des Kraftstoffs abnimmt, damit wir einen Datensatz erhalten, der die Veränderung der Datenpunkte im Laufe der Zeit besser zeigen kann.

Vom Mercedes-Benz Museum aus fuhren wir ein paar Kilometer in der Stadt, dann auf einem ungewollten Umweg nach Norden und dann zurück zu Daimler.

Die Fahrt begann um 11:52 Uhr und endete um 12:45 Uhr.

Die Daten

Lesen von Live-Fahrzeugdaten über API. Der Laptop ruft die API über eine Mobilfunkverbindung zum Internet auf und das Fahrzeug sendet die Daten über LTE an die Mercedes-Benz Server.

Anschließend haben wir alle Daten gesichtet, die wir während des Tests gesammelt hatten. Im Folgenden werfen wir einen Blick auf jeden Datenbereich und den damit verbundenen Anwendungsfall. Beachten Sie, dass Mercedes-Benz keine historischen Daten über seine APIs bereitstellt. Jede Abfrage gibt den aktuellen Wert des Datenpunkts und einen Zeitstempel zurück; die folgenden Diagramme wurden durch kontinuierliche Abfragen ermöglicht. Um zu verdeutlichen, wie häufig die Daten aktualisiert werden, zeigen die diskreten Punkte in den Diagrammen unten an, wann wir neue Daten erhalten haben. Die APIs können jederzeit aufgerufen werden und geben immer die neuesten Daten auf dem Server zurück - im Fall dieser Diagramme wäre das der nächste Datenpunkt, der links von der Uhrzeit des API-Aufrufs erscheint.

Schauen wir uns die einzelnen Datentöpfe an.

Datentopf: Pay As You Drive

Enthaltene APIs: Kilometerstand, Zeitstempel

Der "Pay As You Drive "-Versicherungsdaten-Topf ist die Antwort von Mercedes-Benzauf diesen beliebten nutzungsbasierten Versicherungsanwendungsfall. Da Pay As You Drive nur einen Kilometerstand erfordert, hat dieser Datenbereich nur einen Datenpunkt: Kilometerstand. Eine Anwendung kann die Kilometerstand-API bis zu zweimal pro Tag abfragen und dem Autobesitzer dann die gefahrenen Kilometer in Rechnung stellen. Das nachstehende Diagramm zeigt die Daten zum Kilometerstand, die die Auto-API während unserer Fahrt geliefert hat. Obwohl die Daten nicht jedes Mal aktualisiert wurden, wenn der Kilometerzähler um einen weiteren Kilometer zunahm, waren die verfügbaren Daten nie älter als zehn Minuten. Da eine Pay-As-You-Drive-Anwendung möglicherweise tägliche, wöchentliche oder monatliche Aktualisierungen des Kilometerstandes benötigt, sind Aktualisierungen zur Mitte der Fahrt mehr als ausreichend.

Datentopf: Kraftstoffstatus

Enthaltene APIs: Kraftstoffstand, geschätzte Reichweite, Zeitstempel

Beachten Sie, dass die geschätzte Reichweite von 1081 km um 12:24 Uhr mit den entsprechenden API-Daten in der nachstehenden Tabelle "Geschätzte Reichweite" übereinstimmt.

Die Datenpunkte " Kraftstoffstand" und " Geschätzte Reichweite" sind nützlich für Tank- und Loyalitätsanwendungen. Die Auto-API liefert den aktuellen Kraftstoffstand in Prozent der Gesamtkapazität und die geschätzte Reichweite liefert eine Schätzung der kombinierten elektrischen und Benzin-Reichweite.

Während unserer Fahrt zeigten die APIs einen Rückgang sowohl des Kraftstoffstands als auch des geschätzten Batteriestands an. Nach der Fahrt tankten wir das Auto um 10:42 Uhr auf und erhielten einige Minuten später aktualisierte Daten von der API. Im Produktionsmodus liegt die Obergrenze für diese APIs bei einem Aufruf pro Stunde, was ausreicht, um hochzurechnen, wann ein Auto möglicherweise aufgetankt werden muss.

Kurz nach dem Tanken zeigte die API an, dass der Tank zu 100 % gefüllt war und die geschätzte Reichweite stieg auf mehr als 1200 km an.

Eimer: Fahrzeugstatus & Schlossstatus

Fahrzeugstatus-APIs: Fenster, Türen, Kofferraum, Dach und Lichter: Positionen und Zeitstempel

Schloss-Status-APIs: Türschlösser, Kofferraumschloss, Gasklappensperre, Fahrzeugrichtung, Zeitstempel

Die Datenbereiche Fahrzeugstatus und Verriegelungsstatus können zur Schadensverhütung und zur Diebstahlprävention verwendet werden; ein Autobesitzer kann von überall aus bestätigen, dass sein Auto verriegelt ist und dass die Fenster und Türen geschlossen sind. Wir haben eine Infografik erstellt, um zu zeigen, welche Daten die APIs lieferten, als wir uns darauf vorbereiteten, das Auto am Ende unserer Fahrt zu verlassen. Um die Grafik zu vereinfachen, konzentrieren wir uns nur auf die rechte Seite des Autos und den Kofferraum:

Hier ist die Geschichte hinter der Grafik. Wir hatten neben einer Ladestation geparkt und waren aus dem Auto ausgestiegen. Nachdem wir den Stecker eingesteckt und uns ein wenig unterhalten hatten, beschlossen wir, unseren Test zu beenden. An dieser Stelle beginnt die Infografik - mit geschlossenen Türen und Fenstern und unverschlossenen Türen des Autos. Dann öffneten wir den Kofferraum, um einen Rucksack herauszunehmen, öffneten die Beifahrertür, um sicherzugehen, dass wir nichts zurückgelassen hatten, schlossen sie und verriegelten das Auto.

Hinweis: Jeder dieser Datentopf kann 50 Mal pro Tag abgefragt werden.

Datentopf: Elektrofahrzeug

Enthaltene APIs: Batteriestand, geschätzte Reichweite, Zeitstempel

Der Datenbereich Elektrofahrzeug enthält die Datenpunkte Geschätzte Reichweite und Batteriestand. Beachten Sie, dass die Batteriestand-API während der gesamten Ladezeit des Fahrzeugs minutengenaue Informationen lieferte (das Diagramm ist eine Stunde breiter als die anderen, um die gesamte Ladezeit nach unserem Test zu zeigen).

Der Datentopf für Elektrofahrzeuge kann verwendet werden, um Besitzern von Elektrofahrzeugen bei der Reichweitenangst zu helfen. Wenn die API anzeigt, dass sich ein Auto dem Ende seiner Reichweite nähert, könnte eine Anwendung den Autobesitzer zu einer Ladestation in der Nähe seiner Route führen.

Das Armaturenbrett des Fahrzeugs während des Ladevorgangs. Die Batterie hatte um 12:53 Uhr 54 % erreicht, was mit den API-Daten in der Batteriestandsübersicht vor diesem Foto übereinstimmt.

Das Auto: Mercedes-Benz E 300 de Diesel-Hybrid (MY2020)

Für unseren Test stellte Mercedes-Benz eines der neuesten Fahrzeuge seiner Flotte zur Verfügung, einen hochentwickelten dieselelektrischen Plug-in-Hybrid, der bis zu 50 km allein mit elektrischer Energie fahren kann. Es war das perfekte Fahrzeug, um unsere APIs zu testen; der Antriebsstrang bedeutete, dass wir alle unsere verbrennungsmotor- und batteriebezogenen APIs verwenden konnten. Bitte beachten Sie, dass es sich um ein ganz normales Auto handelte, das in keiner Weise verändert oder speziell für diesen Test vorbereitet wurde. Besuchen Sie die offizielle Website hier.

Verbinden mit dem Auto

Wir haben uns mit dem Auto verbunden und dabei den Standard-Workflow verwendet, der bereits in Produktion ist. Während des Zustimmungsflusses wird der Autobesitzer aufgefordert, seine Anmeldedaten für das Mercedes me Portal auf einer von Daimler verwalteten Zustimmungsseite einzugeben. In Stuttgart gab ein Vertreter von Mercedes-Benz die entsprechenden Anmeldedaten auf der Seite ein und stimmte dann der gemeinsamen Nutzung der Fahrzeugdaten für diesen Test zu. Nachdem wir das Zugangstoken erhalten hatten, fragten wir mit einem Skript alle verfügbaren Datenpunkte des E 300 de ab und zeichneten die Antworten und Zeitstempel in einem Tabellenblatt auf.

Schlussfolgerung

Wir waren erfreut, zu sehen, dass unser Testfahrzeug Informationen an die APIs lieferte, die durchweg mit dem übereinstimmten, was wir während unseres Tests im Fahrzeug beobachteten. Die Daten zu den Interaktionspunkten mit dem Menschen wurden fast sofort aktualisiert. Aktualisierungen der sich ständig ändernden "internen" Fahrzeugdaten, wie Kilometerstand, Batteriestand und Reichweite, wurden sporadisch gesendet. Alle Datenpunkte wurden während der Fahrt und mit einer maximalen Verzögerung von etwa zehn Minuten aktualisiert.

Wir sind sicher, dass diese Ergebnisse für jeden Dritten interessant sind, der Mercedes-Benz Fahrzeugdaten in seine Anwendung oder seinen Dienst integrieren möchte.

Dieser Feldtest ist der zweite in einer Reihe. Im ersten Feldtest haben wir einen BMW i3 abgefragt, während wir mit ihm durch die Hauptstadt von Estland gefahren sind. Obwohl die Auto-API bei der Abfrage von Daten von einem BMW oder Mercedes-Benz auf die gleiche Weise funktioniert, können Fahrzeuge verschiedener Hersteller unterschiedliche Datenpunkte anbieten und Informationen in unterschiedlichen Intervallen senden.

Weitere Informationen über den Einwilligungsprozess, den Autobesitzer durchlaufen, wenn sie ihre Fahrzeugdaten mit einer Anwendung teilen, finden Sie in unserem Beitrag über die Einwilligung der Kunden. Bleiben Sie dran für weitere Fahrzeug-API-Tests. Wenn Sie Fragen zu den APIs, dem Einwilligungsprozess oder der Entwicklung auf unserer Plattform haben, schreiben Sie uns bitte eine Nachricht in den Kommentaren und vergessen Sie nicht, die Datenprodukte, Emulatoren und Tutorials auf der High Mobility-Plattform selbst auszuprobieren.