Blog

Acceda a datos telemáticos en bruto a través de API

Los datos de IoT de los vehiculos se perciben cada vez más como una mina de oro para las empresas, ofreciendo beneficios de un rango que abarca desde una mayor conciencia y automatización de procesos hasta una toma de decisiones mejorada. Sin embargo, los desafíos prácticos de recuperar y consolidar estos datos de dispositivos GPS, sensores de vehículos y buses CAN en un formato manejable, especialmente cuando se necesitan conocimientos tanto en tiempo real como históricos, son importantes. El API de Navixy proporciona una solución a estos problemas, ofreciendo un fácil acceso a estos datos cruciales, lo que agiliza las operaciones y facilita una toma de decisiones más inteligente para los desarrolladores de soluciones telemáticas.

El API Data Wharehouse de Navixy

El API Data Wharehouse de Navixy está diseñado para desarrolladores que necesitan gestionar y analizar de manera eficiente los datos de IoT vehicular. Facilita el acceso a datos en bruto interpretados de dispositivos GPS, sensores y buses CAN, resolviendo el desafío de agregar e interpretar vastas cantidades de información telemática. Al proporcionar llamadas de API sencillas, los desarrolladores pueden recuperar datos históricos y en tiempo real, esenciales para construir aplicaciones que requieren conocimientos detallados del vehículo para la automatización, la optimización de procesos y la toma de decisiones informada.

Diseñado con el rendimiento en mente, el Data Wharehouse de Navixy recopila y almacena datos completos de dispositivos GPS y cámaras de tablero. Agrega la gama completa de datos, desde conexiones de sensores hasta lecturas de buses CAN, en su forma bruta, proporcionando almacenamiento a largo plazo y acceso rápido a los datos en un formato unificado. Esto lo convierte en la opción correcta para los desarrolladores que buscan construir aplicaciones telemáticas escalables.

Primeros pasos con el API Data Wharehouse

El API del Almacén de Datos ofrece dos métodos clave para acceder a los datos telemáticos: get_inputs y read. El método get_inputs se utiliza para identificar los campos de datos disponibles de un dispositivo, como entradas de medición y campos de estado, esenciales para entender qué datos se pueden recuperar. El método read permite la recuperación real de estos datos para un período de tiempo específico, en formato bruto analizado.

Como ejemplo, tomemos un rastreador OBDII y recuperemos datos que incluyan ubicaciones GPS, estados de E/S e información del bus CAN. El siguiente código en Python demuestra cómo acceder a estos datos a través del API:

import requests

# Replace with your actual API server URL and API key
API_URL = "https://api.navixy.com/v2/data-warehouse/tracker"
API_KEY = "your_api_key_here"

# Tracker ID for the OBDII device
TRACKER_ID = 12345

def get_inputs(tracker_id):
    """
    Get available data fields for the tracker.
    """
    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):
    """
    Retrieve parsed raw data from the tracker within the specified time range.
    Data includes GPS location, I/O signals, and CAN bus data.
    """
    payload = {
        "hash": API_KEY,
        "tracker_id": tracker_id,
        "from": from_date,
        "to": to_date,
        "format": "json"  # Can be changed to "csv" if preferred
    }
    response = requests.post(f"{API_URL}/read", json=payload)
    if response.status_code == 200:
        return response.json()
    else:
        return None

# Example usage
if __name__ == "__main__":
    # Date range
    from_date = "2024-01-01T00:00:00Z"
    to_date = "2024-01-02T00:00:00Z"

    inputs = get_inputs(TRACKER_ID)
    print("Available data fields:", inputs)

    data = read_data(TRACKER_ID, from_date, to_date)
    print("Retrieved data:", data)

Para un rastreador OBDII, la respuesta de get_inputs devuelve JSON con datos que indican las capacidades del rastreador, como una variedad de entradas como voltaje de la batería, voltaje de la placa y sensores Bluetooth externos:

{
    "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 respuesta del método read, en formato CSV, incluye registros detallados para columnas específicas como latitud, longitud, velocidad y campos de datos OBDII específicos como nivel de combustible o RPM del motor. Cada fila en el CSV representaría un punto de datos, proporcionando valores decodificados con marca de tiempo del rastreador para el período solicitado:

{
 "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"
}

Recuerde gestionar las respuestas del API de manera apropiada en su aplicación real, verificando errores y analizando los datos de acuerdo a sus necesidades.

En Navixy, nos consideramos su socio confiable en el desarrollo de telemática, ofreciendo un soporte sólido  a través de nuestras APIs. Nuestro objetivo es agilizar su trabajo con datos vehiculares, mejorando la eficiencia y facilidad de uso (por cierto, puede descargar datos telemáticos a un archivo CSV fácilmente). Si necesita más ayuda o tiene alguna pregunta sobre sus proyectos, nuestros equipos de soporte técnico y asesoría de soluciones están a su disposición. Asociarse con Navixy lo conecta con una comunidad dedicada enfocada en convertir sus visiones telemáticas en realidad.

← Artículo anteriorArtículo siguiente →
¿Está listo para el software más innovador?
REGISTRARSE
Publicaciones recientes