Wie kann man prüfen, ob ein Fahrzeug mit unserer Auto API kompatibel ist? OpenDevTalk#6

4. Januar 2023
Die Nutzung von Daten aus dem vernetzten Fahrzeug ermöglicht es Flottenbetreibern und Fahrern, Live-Daten ohne zusätzliche Hardware zu empfangen. Obwohl unsere internen Studien sehr hohe Kompatibilitätsraten für Fahrzeuge zeigen, die in den letzten drei Jahren gebaut wurden, kann es Ausnahmen für einige spezifische Modelle und auch für ältere Fahrzeuge im Allgemeinen geben. Daher ist es wichtig zu verstehen, dass die Eignung eines Fahrzeugs nicht nur vom Modell, sondern auch von seiner Ausstattung abhängt. Vor allem einige Billigmarken können Konnektivitätsfunktionen als Sonderausstattung anbieten, die beim Kauf des Fahrzeugs nicht immer ausgewählt wurde. Folglich kann die Kompatibilität des Fahrzeugs durch fahrzeugspezifische Prüfungen mit Hilfe der von High Mobility kostenlos zur Verfügung gestellten Vehicle Eligibility API überprüft werden.

Eignungsprüfung für vernetzte Autos

Am besten lässt sich die Fahrzeugzulassungsprüfung nutzen, indem das Prüfverfahren in den Onboarding-Prozess eingebettet wird: Jedes Mal, wenn ein neues Fahrzeug zu einem Dienst oder Produkt hinzugefügt wird, kann seine Kompatibilität validiert werden, bevor der Fluss der Zustimmungserfassung oder die Flottenfreigabe eingeleitet wird. Da die Hersteller regelmäßig neue Fahrzeuge und Modelle auf den Markt bringen, sollte das Prüfverfahren so dynamisch wie möglich sein. Daher sollten statische Tabellen, die kompatible Modelle auflisten, nur in Ausnahmefällen verwendet werden.

High Mobility stellt einen API-Endpunkt zur Verfügung, um die genauen Fahrzeugfähigkeiten und zusätzliche Kompatibilitätslisten auf Marken- und Modellbasis als Teil der öffentlichen Dokumentation auszuwerten.

Um die Arbeit mit der Vehicle Eligibility API zu beginnen, empfehlen wir, die folgenden Schritte zu durchlaufen. Jeder zugrundeliegende Aspekt wird sowohl im Video unseres 6. Open Dev Talks als auch in diesem Blogbeitrag näher erläutert.

  •  Unterstützte Marken für den API-Endpunkt prüfen
  •  Vorbereitung auf die Verwendung der Berechtigungsnachweis-API
  •  Durchführung des Antrags und Analyse der Ergebnisse
  •  Modelllisten für nicht unterstützte Marken berücksichtigen


Unterstützte Hersteller und Marken

Die Automobilhersteller bieten Suchdienste an, um die Kompatibilität der einzelnen Fahrzeuge zu prüfen. Jeder Dienst hat jedoch ein eigenes Format und eine eigene Struktur. High Mobility hat die Kompatibilitätsprüfungsdienste in einem einzigen API-Endpunkt für alle kooperierenden Marken und OEMs harmonisiert und vereinheitlicht.

Da die meisten, aber nicht alle OEMs entsprechende Suchdienste anbieten, ist der erste empfohlene Schritt zu prüfen, welche Marken derzeit abgedeckt sind. Während die meisten Marken die Eignungsprüfung unabhängig von legitimen B2C- oder B2B-Zwecken anbieten, können für bestimmte OEMs einige rechtliche und technische Einschränkungen gelten. Um die Details zu überprüfen, können Sie unter docs.high-mobility.com das Tutorial zur Fahrzeugzulassung aufrufen, in dem Marken und Einschränkungen regelmäßig aktualisiert werden.

Voraussetzungen für die Kompatibilität der API für vernetzte Fahrzeuge

Die Fahrzeugzulassungs-API kann verwendet werden, sobald Sie Ihren App-Container eingereicht haben. Kompatibilitätsprüfungen können dann für alle Marken durchgeführt werden, die erfolgreich für diesen spezifischen Datencontainer auf unserer Plattform aktiviert wurden. Wenn Sie noch nicht mit dem Datencontainer-Ansatz und dem App-Einreichungsprozess vertraut sind, empfehlen wir Ihnen dringend, unseren ersten Open Dev Talk zu lesen, um zusätzliche Hinweise zu erhalten.

Um eine gültige Anfrage durchzuführen, müssen Sie ein Auth Token generieren, indem Sie JWT, die Fahrzeugidentifikationsnummer (VIN) und den entsprechenden Markennamen (z.B. "Peugeot") des zu prüfenden Fahrzeugs verwenden.

Im Open Dev Talk #5 haben wir gezeigt, wie Sie unseren Beispielcode wiederverwenden können, um ein kurzlebiges Token zu generieren und die erweiterten Optionen unserer Service Account API schnell zu nutzen.

Aufrufen der API zur Prüfung der Fahrzeugzulassung

Sobald Sie die Vorbereitungen abgeschlossen haben, können Sie die Fahrgestellnummer des gewünschten Fahrzeugs, den Markennamen und das Autorisierungs-Token über den Endpunkt für die Zulassungsprüfung "https://api.high-mobility.com/v1/eligibility" eingeben. Das Ergebnis zeigt an, ob das Fahrzeug mit der Auto API von High Mobility kompatibel ist, indem es "eligible = true" oder "eligible = false" sagt. Darüber hinaus gibt das Ergebnis an, ob mit dem Fahrzeug generell Daten gepusht werden können oder ob Pull-basierte Ansätze (z. B. REST API) verwendet werden müssen. Einige Marken stellen sogar noch weitergehende Informationen zur Verfügung, z. B. ob dem Fahrzeug ein Hauptfahrer zugewiesen wurde und ob das Abonnement für die Konnektivitätsdienste des Connected Car gebucht wurde.

Unsere Customer Success Managerin Anissa Semahi hat im entsprechenden Open Dev Talk 6 Video die VIN eines Testwagens mit dem entsprechenden Markennamen "peugeot" verwendet. In diesem Beispiel ist das Auto zugelassen und Daten können gepusht und gezogen werden. Um besser zu verstehen, welche genauen Datenpunkte über MQTT abonniert werden können und welche Datenelemente möglicherweise nur über Pull-basierte Aufrufe verfügbar sind, können Sie jederzeit unseren Datenkatalog einsehen, der über diesen Airtable-Link bereitgestellt wird.

Liste der kompatiblen Fahrzeuge für den Abruf von Connected-Car-Daten

Unsere öffentliche Online-Dokumentation listet die in Frage kommenden Fahrzeuge nach Marke, Modellname und Baujahr auf, um einen allgemeinen Überblick über die zu erwartende Fahrzeugkompatibilität zu erhalten und auch Marken abzudecken, die noch nicht von unserer Eignungsprüfungs-API unterstützt werden. Bitte beachten Sie, dass bestimmte Marken und Modelle in verschiedenen Ländern unterschiedliche Bezeichnungen haben können und dass es Fahrzeuge geben kann, die trotz gleicher Modellbezeichnung nicht mit der erforderlichen Sonderausstattung ausgestattet sind.

Für große Flottenbetreiber bieten wir eine kostenlose Analyse der Flottenkompatibilität auf der Grundlage Ihrer individuellen Liste von Fahrzeugidentifikationsnummern an.

-------------------------------
Hochmobilität Offene Entwicklungsgespräche

Bei High Mobility sind wir leidenschaftlich an neuen Technologien interessiert. Wir bieten kostenlose Open-Source-Tools und eine entwicklerfreundliche Dokumentation, damit alle Projekte reibungslos integriert werden können. Mehr als 800 Entwickler und Produktmanager haben sich bereits für unsere moderierte Community-Plattform angemeldet und wir veranstalten Wettbewerbe für Ihre innovativen Ideen für vernetzte Fahrzeuge. 

In unserem kostenlosen monatlichen, 30-minütigen Open Dev Talk erklären wir in 15 Minuten spannende Themen rund um Connected Cars und widmen die restliche Zeit Ihren Fragen und Ideen.

Treten Sie unserer Gemeinschaft auf Slack bei