Track Service

Track Service

The Track service provides access to circuit information and track assets.

const trackService = iracing.track;

Methods

get()

Get all tracks in the iRacing database.

Details

Returns: Promise<TrackGetResponse>

Parameters: None

Description: Returns complete information about all tracks available in iRacing, including configurations, locations, and categories.

Example

const tracks = await iracing.track.get();

tracks.forEach(track => {
  console.log(`${track.trackName} (ID: ${track.trackId})`);
  console.log(`  Category: ${track.categoryName}`);
  console.log(`  Config: ${track.configName}`);
});

---

assets()

Get track asset information including images and maps.

Details

Returns: Promise<TrackAssetsResponse>

Parameters: None

Description: Returns URLs for track images, maps, and other visual assets.

Example

const assets = await iracing.track.assets();

Object.entries(assets).forEach(([trackId, asset]) => {
  console.log(`Track ${trackId}:`);
  console.log(`  Logo: ${asset.logo}`);
  console.log(`  Map: ${asset.trackMap}`);
});

Tip

Track data is relatively static. Consider implementing your own caching strategy for optimal performance. Response caching is coming in a future release.

Common Use Cases

Build a Track Directory

async function getTrackDirectory() {
  const [tracks, assets] = await Promise.all([
    iracing.track.get(),
    iracing.track.assets(),
  ]);

  return tracks.map(track => ({
    ...track,
    assets: assets[track.trackId],
  }));
}

See Also

• Car Service - Vehicle data and assets
• Series Service - Series and schedule information
• Services Overview - All available services