Essai sur le terrain : Accès aux données Mercedes-Benz avec l'API Auto

17 septembre 2019
Les entreprises commencent à utiliser notre Auto API pour une variété de services de mobilité, et les développeurs d'applications nous posent des questions sur le comportement des voitures de chaque constructeur. Qu'est-ce qui déclenche l'envoi de nouvelles données par les voitures ? à quelle vitesse les mises à jour apparaissent via l'API ? et les données sont mises à jour pendant la conduite de la voiture?

L'essai  avec un véhicule Mercedes-Benz

Pour répondre à ces questions, nous testons avec de vraies voitures de chacun des constructeurs que nous soutenons. Pour cet article, nous nous sommes rendus au siège de Mercedes-Benz à Stuttgart pour tester l'Auto API sur l'une de leurs dernières voitures, la Mercedes-Benz E 300 Diesel-Hybrid.

Plutôt que de fournir des points de données à la carte, Mercedes-Benz offre une variété de groupes de données, chacun d'entre eux contenant une sélection de points de données qui a été préétablie en fonction de cas d'utilisation spécifiques. Nous allons les explorer ci-dessous.

Cet article présente un bref historique des produits de données des véhicules Mercedes-Benz avant de révéler les résultats de notre journée d'essai avec des échantillons de données et des graphiques. Les détails sur la voiture et le processus d'authentification se trouvent à la fin de l'article.

Une note sur les véhicules et les régions compatibles

La grande majorité des véhicules de tourisme Mercedes-Benz construits après 2016 sont compatibles avec l'API Auto de High Mobility. Pour qu'une appli puisse récupérer les données d'une voiture, quelques conditions supplémentaires doivent être remplies. Le véhicule doit avoir un abonnement Mercedes me connect avec le service "Interface avec les tiers" activé, et le propriétaire du véhicule doit consentir l'accès des données au entreprises tiers.

Le processus s'adresse au propriétaire du véhicule : une voiture totalement stockée et non modifiée sort du concessionnaire et est déjà compatible avec nos API ; pas de matériel, pas d'installation et pas de configuration. Seul le consentement du propriétaire du véhicule est requis. C'est tout !

Les services de données sont comptibles dans les pays suivants :

Normalement, les API ont des limites de demande ; pour notre test, Mercedes-Benz a gentiment supprimé ces limites pour permettre de tester différents cas d'utilisation dans une période courte 

Le test

Au cours de nos premières minutes avec la voiture, nous nous sommes rendus de Daimler à Stuttgart au musée Mercedes-Benz tout proche. Tout en conduisant, nous avons surveillé chaque API pour confirmer qu'elle était active et répondait comme prévu. Par exemple, nous ouvrions le toit ouvrant ou les fenêtres et nous nous assurions que l'API concernée reflétait le changement d'état. Nous avons réalisé des expériences similaires avec toutes les API de production. Les API des "points de contact" avec lesquels nous avons interagi - portes, fenêtres, toit ouvrant et serrures - ont été mises à jour en quelques secondes. Les données API pour d'autres attributs du véhicule, comme le carburant et le niveau de la batterie, ont été mises à jour de manière plus sporadique, avec un délai maximal d'environ quinze minutes.

Le but de ce test était de voir :

Ce qui a déclenché la voiture pour envoyer des mises à jour de données.
La rapidité avec laquelle les nouvelles données ont été disponibles via l'API.
Comment les tiers pourraient en faire usage.

Une fois que nous avons confirmé que tout fonctionnait bien, nous sommes partis pour un trajet plus long. L'idée était de rouler suffisamment longtemps pour voir les niveaux de la batterie et du carburant diminuer, afin d'obtenir un ensemble de données qui puisse mieux montrer l'évolution des points de données au fil du temps.

Depuis le musée Mercedes-Benz, nous avons parcouru quelques kilomètres en ville, puis nous avons continué sur une route involontairement détournée vers le nord, avant de revenir à Daimler.

Le voyage a commencé à 11 h 52 et s'est terminé à 12 h 45.

Les données

Lecture des données du véhicule en direct via l'API. L'ordinateur portable appelle l'API à l'aide d'une connexion cellulaire à Internet, et la voiture envoie les données aux serveurs de Mercedes-Benz par LTE.

Nous avons ensuite passé à filtrer toutes les données que nous avions recueillies pendant le test. Ci-dessous, nous allons jeter un coup d'œil à chaque ensemble de données et au cas d'utilisation qui lui est associé. N'oubliez pas que Mercedes-Benz ne fournit pas de données historiques via ses API. Chaque requête renvoie le dernier point de données et un horodatage ; les graphiques ci-dessous ont été réalisés grâce à une interrogation continue. Afin d'indiquer clairement la fréquence de mise à jour des données, les points discrets sur les graphiques ci-dessous indiquent quand nous avons reçu de nouvelles données. Il est possible d'appeler les API à tout moment, et elles renverront toujours les dernières données présentes sur le serveur - dans le cas de ces graphiques, il s'agit du point de données le plus proche apparaissant à gauche de l'heure à laquelle l'API est appelée.

Explorons chaque type de données.

L'ensemble : Pay As You Drive

APIs incluses : Kilométrage, horodatage

Le groupe de données d'assurance Pay As You Drive est la réponse de Mercedes-Benzà ce cas d'utilisation populaire de l'assurance basée sur l'utilisation. Étant donné que l'option Pay As You Drive ne nécessite qu'un relevé du kilométrage, ce groupe de données ne comporte qu'un seul point de données : Kilométrage. Une application peut interroger l'API Mileage jusqu'à deux fois par jour, puis facturer le propriétaire du véhicule en fonction du kilométrage qu'il a parcouru. Le graphique ci-dessous montre les données de kilométrage que l'API Auto a fournies pendant notre trajet. Bien que les données ne soient pas mises à jour à chaque fois que l'odomètre augmente d'un kilomètre, les données disponibles ne datent jamais de plus de dix minutes. Étant donné qu'une application de paiement au volant à besoin des mises à jour du compteur kilométrique sur une base quotidienne, hebdomadaire ou mensuelle, les mises à jour en cours de route sont plus que suffisantes.

Ensemble : Statut de carburant

APIs incluses : Niveau de carburant, autonomie estimée, horodatage

Notez que la portée estimée de 1081 km à 12h24 s'aligne sur les données API correspondantes dans le graphique de la portée estimée ci-dessous.

Les points de données " Niveau de carburant" et "Autonomie estimée" sont utiles pour les applications de ravitaillement et de fidélisation. L'API Auto fournit le niveau de carburant actuel en pourcentage de la capacité totale, et l'autonomie estimée fournit une estimation de l'autonomie combinée en électricité et en essence.

Pendant notre voyage, les API ont indiqué des diminutions du niveau de carburant et du niveau de batterie estimé. Après le voyage, nous avons fait le plein de la voiture à 10 h 42 et avons reçu des données actualisées de l'API quelques minutes plus tard. En production, la limite de débit pour ces API est d'un appel par heure, ce qui est suffisant pour extrapoler le moment où une voiture pourrait avoir besoin de faire le plein.

Peu après le ravitaillement de la voiture, l'API a indiqué que le réservoir était plein à 100 %, et l'autonomie estimée a montré que l'autonomie était passée à plus de 1200 km.

Ensemble : État du véhicule et état de la serrure

API d'état des véhicules : Fenêtres, Portes, Coffre, Toit et Feux: Positions et horodatage

API d'état de verrouillage : Serrures de porte, serrure de coffre, serrure de volet d'essence, cap du véhicule, horodatage.

Les groupes de données État du véhicule et État de la serrure peuvent être utilisés pour la prévention des dommages et la prévention des vols ; un propriétaire de voiture peut confirmer de n'importe où que sa voiture est verrouillée et que ses fenêtres et portes sont fermées. Nous avons créé une infographie pour montrer les données fournies par les API alors que nous nous préparions à quitter la voiture à la fin de notre voyage. Afin de simplifier le graphique, nous nous concentrerons uniquement sur le côté droit de la voiture et le coffre :

Voici l'histoire derrière ce graphique. Nous nous sommes garés à côté d'une station de recharge et sommes sortis de la voiture. Après l'avoir branchée et avoir discuté un peu, nous avons décidé de terminer notre test. C'est là que l'infographie commence - avec les portes et les fenêtres de la voiture fermées, et avec les portes déverrouillées. Nous avons ensuite ouvert le coffre pour en retirer un sac à dos, ouvert la porte du passager avant pour nous assurer que nous n'avions rien oublié, puis nous avons fermé et verrouillé la voiture.

Remarque : Chacun de ces groupes de données peut être interrogé 50 fois par jour.

ensemble : Véhicule électrique

APIs incluses : Niveau de la batterie, autonomie estimée, horodatage

L'ensemble de données Véhicule électrique contient les points de données Autonomie estimée et Niveau de la batterie. Notez que l'API Niveau de la batterie a fourni des informations actualisées à la minute près pendant toute la durée de la charge de la voiture (le graphique est plus large d'une heure que les autres afin de montrer la totalité de la durée de la charge après notre test).

L'ensemble de données sur les véhicules électriques peut être utilisé pour aider les propriétaires de véhicules électriques à lutter contre l'angoisse de l'autonomie. Lorsque l'API indique qu'une voiture approche de la fin de son autonomie, une application pourrait diriger le propriétaire de la voiture vers une station de recharge proche de son itinéraire.

Le tableau de bord de la voiture à mi-charge. La batterie avait atteint 54 % à 12 h 53, ce qui correspond aux données de l'API dans le tableau du niveau de la batterie précédant cette photo.

La voiture : Mercedes-Benz E 300 de Diesel-Hybrid (MY2020)

Pour notre test, Mercedes-Benz a mis à notre disposition l'un des véhicules les plus récents de sa flotte de véhicules, une hybride diesel-électrique rechargeable sophistiqué qui peut parcourir jusqu'à 50 km en utilisant uniquement l'énergie électrique. Il s'agissait du véhicule idéal pour tester nos API ; grâce à la sa transmission, nous avons pu utiliser toutes nos API liées à la combustion interne et à la batterie. Veuillez noter que la voiture était totalement standard et qu'elle n'a été en aucune façon modifiée ou préparée spécialement pour ce test. Consultez le site officiel ici.

Connexion à la voiture

Nous nous sommes connectés à la voiture en utilisant le flux de travail standard qui est déjà en production. Au cours du flux de consentement, le propriétaire de la voiture est invité à saisir ses informations d'identification sur le portail Mercedes me dans une page de consentement gérée par Daimler. À Stuttgart, un représentant de Mercedes-Benz a saisi les informations d'identification pertinentes sur la page, puis a consenti au partage des données du véhicule pour ce test. Après avoir reçu le jeton d'accès, nous avons utilisé un script pour interroger tous les points de données disponibles sur la E 300 de, et avons enregistré les réponses et les horodatages dans une feuille de calcul.

Conclusion

Nous avons été heureux de constater que notre voiture d'essai a fourni des informations aux API qui correspondaient systématiquement à ce que nous avons observé depuis le véhicule pendant notre test. Les données sur les points d'interaction avec l'homme ont été mises à jour presque immédiatement. Les mises à jour des données "internes" de la voiture, en constante évolution, comme le kilométrage, le niveau de la batterie et l'autonomie, étaient envoyées sporadiquement. Tous les points de données étaient mis à jour pendant la conduite, avec un délai maximal d'environ dix minutes.

Nous sommes convaincus que ces résultats intéresseront toute entreprise tiers qui cherche à intégrer les données relatives aux voitures Mercedes-Benz dans son application ou son service.

Ce test sur le terrain est le deuxième d'une série. Dans le premier test, nous avons interrogé une BMW i3 en la conduisant dans la capitale de l'Estonie. Bien que l'API Auto fonctionne de la même manière, qu'il s'agisse d'interroger les données d'une BMW ou d'une Mercedes-Benz, les voitures de différents constructeurs peuvent offrir différents points de données et envoyer des informations à des intervalles différents.

Pour plus d'informations sur le processus de consentement des propriétaires de véhicules lorsqu'ils partagent les données de leur véhicule avec une application, lisez notre article sur le consentement des clients. Restez à l'écoute pour d'autres tests d'API de véhicules. Si vous avez des questions sur les API, le flux de consentement ou le développement sur notre plateforme, écrivez-nous dans les commentaires et n'oubliez pas d'essayer vous-même les produits de données, les émulateurs et les conseils sur la plateforme High Mobility.