Aller au contenu principal

Premier Import de Données

Apprenez à importer vos premières données de session dans Guido.

Types de Données Supportées​

Guido accepte plusieurs formats de données :

🎥 Vidéo​

  • Formats : MP4, AVI, MOV
  • Résolution recommandée : 1080p ou supérieure
  • Informations extraites : trajectoire visuelle, points de freinage

📍 GPS​

  • Formats : GPX, NMEA, CSV
  • Fréquence recommandée : 10Hz minimum
  • Informations : position, vitesse, accélération

🚗 OBD (On-Board Diagnostics)​

  • Formats : CSV, JSON
  • Données : RPM, throttle, brake pressure, température
  • Compatible avec la plupart des dongles OBD-II

🎮 Simulation​

  • iRacing (.ibt)
  • Assetto Corsa (.json)
  • rFactor 2 (.ld)

Import Simple​

Via le SDK​

import { GuidoClient } from '@guido/racing-sdk';

const client = new GuidoClient({
  apiKey: process.env.GUIDO_API_KEY,
  apiSecret: process.env.GUIDO_API_SECRET,
});

// Import d'un fichier GPS
const session = await client.sessions.import({
  type: 'gps',
  file: './data/session-spa-2024.gpx',
  metadata: {
    circuit: 'Spa-Francorchamps',
    vehicle: 'BMW M4',
    date: '2024-08-15',
    conditions: 'dry',
  },
});

console.log('Session importée:', session.id);

Import Multiple​

// Import combiné GPS + Vidéo + OBD
const session = await client.sessions.importMultiple({
  gps: './data/session.gpx',
  video: './data/session.mp4',
  obd: './data/session-obd.csv',
  metadata: {
    circuit: 'Spa-Francorchamps',
    vehicle: 'BMW M4',
    date: '2024-08-15',
  },
});

Vérification de l'Import​

// Récupérer les détails de la session
const details = await client.sessions.get(session.id);

console.log('Statut:', details.status);
console.log('Nombre de tours:', details.laps.length);
console.log('Meilleur temps:', details.bestLap.time);

Métadonnées Recommandées​

Pour une analyse optimale, incluez ces métadonnées :

{
  circuit: 'Nom du circuit',
  vehicle: 'Modèle de voiture',
  date: 'YYYY-MM-DD',
  conditions: 'dry' | 'wet' | 'mixed',
  temperature: 25, // en Celsius
  trackTemp: 35,
  setup: {
    tirePressure: { fl: 2.4, fr: 2.4, rl: 2.2, rr: 2.2 },
    suspension: 'sport',
  }
}

Exemple Complet​

async function importSession() {
  const client = new GuidoClient({
    apiKey: process.env.GUIDO_API_KEY,
    apiSecret: process.env.GUIDO_API_SECRET,
  });

  try {
    const session = await client.sessions.importMultiple({
      gps: './data/spa-session.gpx',
      video: './data/spa-session.mp4',
      obd: './data/spa-obd.csv',
      metadata: {
        circuit: 'Spa-Francorchamps',
        vehicle: 'BMW M4 Competition',
        date: '2024-08-15',
        conditions: 'dry',
        temperature: 22,
        trackTemp: 32,
        driver: 'Thomas',
      },
    });

    console.log('✅ Session importée avec succès!');
    console.log('ID:', session.id);
    console.log('Tours détectés:', session.laps.length);
    
  } catch (error) {
    console.error('❌ Erreur lors de l\'import:', error);
  }
}

importSession();

Prochaines Étapes​