Retour

Accès aux données télématiques brutes via l'API

Telematics data warehouse API: Enhancing Data Accessibility in Telematics Applications

Les données IoT des véhicules sont de plus en plus considérées comme une mine d'or pour les entreprises, offrant des avantages allant de l'amélioration de la sensibilisation et de l'automatisation des processus à l'amélioration de la prise de décision. Cependant, les défis pratiques liés à la récupération et à la consolidation de ces données provenant de dispositifs GPS, de capteurs de véhicules et de bus CAN dans un format gérable, en particulier lorsque vous avez besoin d'aperçus en temps réel et historiques, sont importants. L'API de Navixy apporte une solution à ces problèmes, en offrant un accès facile à ces données cruciales, rationalisant ainsi les opérations et facilitant une prise de décision plus intelligente pour les développeurs de solutions télématiques.

API de données IoT brutes de Navixy

L'API Navixy Raw IoT Data est conçue pour les développeurs qui ont besoin de gérer et d'analyser efficacement les données IoT des véhicules. Elle facilite l'accès aux données brutes analysées provenant des dispositifs GPS, des capteurs et des bus CAN, résolvant ainsi le défi de l'agrégation et de l'interprétation de vastes quantités d'informations télématiques. En fournissant des appels API simples, les développeurs peuvent récupérer des données historiques et en temps réel, essentielles pour construire des applications qui nécessitent des informations détaillées sur les véhicules pour l'automatisation, l'optimisation des processus et la prise de décision éclairée.

Conçues dans un souci de performance, les données IoT brutes de Navixy collectent et stockent des données complètes provenant de dispositifs GPS et de caméras de tableau de bord. Il agrège l'ensemble des données, des connexions de capteurs aux relevés de bus CAN, sous leur forme brute, offrant un stockage à long terme et un accès rapide aux données dans un format unifié. C'est donc le bon choix pour les développeurs qui cherchent à créer des applications télématiques évolutives.

Démarrer avec l'API de données IoT brutes

L'API Données IoT brutes propose deux méthodes clés pour accéder aux données télématiques : get_inputs et read. La méthode get_inputs est utilisée pour identifier les champs de données disponibles d'un appareil, tels que les entrées de comptage et les champs d'état, essentiels pour comprendre quelles données peuvent être récupérées. La méthode read permet de récupérer ces données pour une période donnée, dans un format brut analysé.

Prenons l'exemple d'un tracker OBDII et récupérons des données telles que les positions GPS, les états des E/S et les informations du bus CAN. Le code Python suivant montre comment accéder à ces données via l'API :

import requests # Remplacez par l'URL de votre serveur API et votre clé API API_URL = "https://api.navixy.com/dwh/v1/tracker/raw_data/read" API_KEY = "your_api_key_here" # ID du traqueur pour le dispositif OBDII TRACKER_ID = 12345 def get_inputs(tracker_id) : """ Obtenir les champs de données disponibles pour le traqueur. """ payload = { "hash" : API_KEY, "tracker_id" : tracker_id, } response = requests.post(f"{API_URL}/get_inputs", json=payload) if response.status_code == 200 : return response.json() else : return None def read_data(tracker_id, from_date, to_date) : """ Récupérer les données brutes analysées du traceur dans l'intervalle de temps spécifié. Les données comprennent la position GPS, les signaux d'E/S et les données du bus CAN. """ payload = { "hash" : API_KEY, "tracker_id" : tracker_id, "from" : from_date, "to" : to_date, "format" : "json" # Peut être remplacé par "csv" si vous le souhaitez } response = requests.post(f"{API_URL}/read", json=payload) if response.status_code == 200 : return response.json() else : return None # Exemple d'utilisation if __name__ == "__main__" : # Plage de dates from_date = "2024-01-01T00:00:00Z" to_date = "2024-01-02T00:00:00Z" inputs = get_inputs(TRACKER_ID) print("Champs de données disponibles :", inputs) data = read_data(TRACKER_ID, from_date, to_date) print("Données récupérées :", data)

Pour un tracker OBDII, la sortie de get_inputs renvoie JSON avec des données indiquant les capacités du tracker, telles qu'une variété d'entrées comme la tension de la batterie, la tension de la carte et les capteurs Bluetooth externes :

{"discrete_inputs" : 2, "discrete_outputs" : 1, "inputs" : ["analog_1", "battery_voltage", "board_voltage", "ext_temp_sensor_4", "freq_1", "hw_mileage", "impulse_counter_1", "lls_level_4", "lls_temperature_4" ], "states" : ["hardware_key" ], "success" : true }

La sortie de la méthode read, au format CSV, comprend des enregistrements détaillés pour des colonnes spécifiques telles que la latitude, la longitude et la vitesse, ainsi que des champs de données OBDII spécifiques tels que le niveau de carburant ou les tours/minute du moteur. Chaque ligne du fichier CSV représente un point de données, fournissant des valeurs décodées et horodatées du traceur pour la période demandée :

{"csv" : "\"msg_time\",\"lat\",\"lng\",\"speed\",\"inputs.ble_lls_level_1\",\"inputs.hw_mileage\",\"discrete_inputs.1\",\"discrete_inputs.2\"\n\"2023-11-30T13:13:14+0600\",54.22809,69.5264283,28,2871,24296.444,0,1\n\"2023-11-30T13:13:25+0600\",54.228095,69.5278333,32,2871,24296.536,0,1"
}

N'oubliez pas de traiter les réponses de l'API de manière appropriée dans votre application réelle, en vérifiant les erreurs et en analysant les données en fonction de vos besoins.

Chez Navixy, nous nous considérons comme votre partenaire fiable en matière de développement télématique, en vous offrant un soutien solide par le biais de nos API. Notre objectif est de rationaliser votre travail avec les données des véhicules, en améliorant l'efficacité et la facilité d'utilisation (entre autres, vous pouvez facilement télécharger des données télématiques dans un fichier CSV). Si vous avez besoin d'une assistance supplémentaire ou si vous avez des questions concernant vos projets, nos équipes de support technique et de consultants en solutions sont à votre disposition. En vous associant à Navixy, vous vous associez à une communauté dévouée qui s'efforce de faire de vos projets télématiques une réalité.