@pond-ts/fit API Reference
    Preparing search index...

    Interface Lap

    A recorded lap — a segment the device marked (auto-lap by distance/time, or a button press), as opposed to the evenly-spaced splits this library computes. Recorded laps are the rider's own structure (intervals, climbs, rest stops), so they're carried through as first-class evidence. SI throughout; optional fields are present only when the source recorded them.

    interface Lap {
        avgHeartrate?: number;
        avgSpeedMps?: number;
        avgWatts?: number;
        calories?: number;
        distanceMeters: number;
        elapsedSeconds: number;
        elevationGainMeters?: number;
        index: number;
        maxHeartrate?: number;
        maxSpeedMps?: number;
        maxWatts?: number;
        movingSeconds: number;
        startDistanceMeters: number;
        startTimeUtc?: string;
        totalWorkKj?: number;
    }
    Index

    Properties

    avgHeartrate?: number
    avgSpeedMps?: number
    avgWatts?: number
    calories?: number

    Energy, kcal.

    distanceMeters: number
    elapsedSeconds: number

    Wall-clock for the lap (total_elapsed_time).

    elevationGainMeters?: number
    index: number

    1-based lap number in recorded order.

    maxHeartrate?: number
    maxSpeedMps?: number
    maxWatts?: number
    movingSeconds: number

    Timer time, i.e. moving time (total_timer_time).

    startDistanceMeters: number

    Cumulative distance at the lap's start (sum of prior laps' distance), metres — the lap's [start, start+distance] range into the activity, for chart bands and map-section highlighting.

    startTimeUtc?: string

    ISO 8601, UTC — when the lap began. Optional: absent (not '') when the source recorded no valid start time, so consumers must null-check rather than Date.parse('') → NaN.

    totalWorkKj?: number

    Mechanical work over the lap, kJ (FIT total_work is joules).