formula1_data 2.0.0

A Dart package for retrieving Formula1™ data, such as races, drivers, results, and standings.

example/example.dart

import 'package:formula1_data/formula1_data.dart';

Future<void> main() async {
  final formula1 = Formula1Data(userAgent: 'formula1_data-example/1.0.0');

  // Get all seasons
  final seasons = await formula1.getSeasons();
  print('Seasons: ${seasons.items.map((s) => s.year).join(', ')}');

  // Get all circuits
  final circuits = await formula1.getCircuits();
  print('Circuits: ${circuits.items.map((c) => c.circuitName).join(', ')}');

  // Get races for a specific season
  final races = await formula1.getRaces(season: 2023);
  print('Races in 2023: ${races.items.map((r) => r.raceName).join(', ')}');

  // Get race results for a specific race
  final results = await formula1.getResults(season: 2023, round: 1);
  print(
    'Race results: ${results.items.map((r) => '${r.driver.givenName} ${r.driver.familyName}: ${r.position}').join(', ')}',
  );

  // Get driver standings
  final driverStandings = await formula1.getDriverStandings(year: 2023);
  print(
    'Driver standings: ${driverStandings.items.map((s) => '${s.driver.givenName} ${s.driver.familyName}: ${s.points}').join(', ')}',
  );

  // Get constructor standings
  final constructorStandings = await formula1.getConstructorStandings(
    year: 2023,
  );
  print(
    'Constructor standings: ${constructorStandings.items.map((s) => '${s.constructor.name}: ${s.points}').join(', ')}',
  );

  // Get qualifying results
  final qualifying = await formula1.getQualifying(year: 2023, round: 1);
  print(
    'Qualifying results: ${qualifying.items.map((q) => '${q.driver.givenName} ${q.driver.familyName}: ${q.position}').join(', ')}',
  );

  // Get sprint results
  final sprint = await formula1.getSprint(year: 2023, round: 1);
  print(
    'Sprint results: ${sprint.items.map((s) => '${s.driver.givenName} ${s.driver.familyName}: ${s.position}').join(', ')}',
  );

  // Get pit stops
  final pitStops = await formula1.getPitStops(year: 2023, round: 1);
  print(
    'Pit stops: ${pitStops.items.map((p) => '${p.driver.driverId}: ${p.duration}').join(', ')}',
  );

  // Get lap times
  final laps = await formula1.getLaps(year: 2023, round: 1);
  print(
    'Lap times: ${laps.items.map((l) => '${l.driverId}: ${l.time}').join(', ')}',
  );

  // Get race status
  final status = await formula1.getStatus(year: 2023);
  print(
    'Race status: ${status.items.map((s) => '${s.status}: ${s.count}').join(', ')}',
  );

  // Every method returns a PaginatedResult, exposing the total item count
  // reported by the API alongside the page of items actually returned.
  print(
    'Fetched ${seasons.items.length} of ${seasons.total} total seasons '
    '(hasMore: ${seasons.hasMore})',
  );
}