SelfSync

Lap message

A lap message summarizes a portion of a session: a lap triggered manually with the lap button, an automatic lap (every kilometer or mile for instance), or an interval of a structured workout. It holds the same kind of statistics as the session (time, distance, speed, heart rate, power, cadence, elevation…) for that portion only.

FIT name
lap
Global message number
19
JavaScript SDK key
lapMesgs
Fields
146

Fields

  • Index of the message among the messages of the same kind in the file, starting at 0. Other messages use it to reference this one.

  • timestampDateTimes

    Moment the lap ended, in UTC.

  • eventEnum

    Kind of event: timer, lap, session, activity, workout step, course point, battery, gear change, rider position change…

    46 possible values
    • length
    • session
    • activity
    • workout
    • lap
    • workoutStep
    • coursePoint
    • battery
    • fitnessEquipment
    • timer
    • powerDown
    • powerUp
    • offCourse
    • virtualPartnerPace
    • hrHighAlert
    • hrLowAlert
    • speedHighAlert
    • speedLowAlert
    • cadHighAlert
    • cadLowAlert
    • powerHighAlert
    • powerLowAlert
    • recoveryHr
    • batteryLow
    • timeDurationAlert
    • distanceDurationAlert
    • calorieDurationAlert
    • userMarker
    • sportPoint
    • calibration
    • frontGearChange
    • rearGearChange
    • riderPositionChange
    • elevHighAlert
    • elevLowAlert
    • commTimeout
    • autoActivityDetect
    • diveAlert
    • diveGasSwitched
    • tankPressureReserve
    • tankPressureCritical
    • tankLost
    • radarThreatAlert
    • tankBatteryLow
    • tankPodConnected
    • tankPodDisconnected
  • What happened for the event: start, stop, stopAll, marker, begin or end of a depreciated range…

    10 possible values
    • stop
    • start
    • marker
    • consecutiveDepreciated
    • stopAll
    • beginDepreciated
    • endDepreciated
    • endAllDepreciated
    • stopDisable
    • stopDisableAll
  • startTimeDateTime

    Moment the period described by the message started.

  • startPositionLatSint32semicircles

    Latitude where the period started, in semicircles (multiply by 180 / 2^31 to get degrees).

  • startPositionLongSint32semicircles

    Longitude where the period started, in semicircles (multiply by 180 / 2^31 to get degrees).

  • endPositionLatSint32semicircles

    Latitude where the period ended, in semicircles (multiply by 180 / 2^31 to get degrees).

  • endPositionLongSint32semicircles

    Longitude where the period ended, in semicircles (multiply by 180 / 2^31 to get degrees).

  • Total duration from start to end, pauses included (wall-clock time).

  • Duration during which the timer was running, pauses excluded. This is the time usually displayed as the duration.

  • Total distance covered.

  • totalCyclesUint32cycles

    Total number of cycles: pedal revolutions, strides or strokes depending on the sport.

  • totalStridesUint32strides

    Total number of strides.

  • totalStrokesUint32strokes

    Total number of strokes (swimming, paddling, rowing).

  • totalPushesUint32pushes

    Total number of wheelchair pushes.

  • totalCaloriesUint16kcal

    Total energy expenditure.

  • Share of the total calories coming from fat.

  • avgSpeedFloat64

    Average speed: total distance divided by timer time.

  • maxSpeedFloat64

    Maximum speed reached.

  • avgHeartRateUint8bpm

    Average heart rate, pauses excluded.

  • maxHeartRateUint8bpm

    Maximum heart rate reached.

  • avgCadenceUint8rpm

    Average cadence: revolutions per minute for cycling, steps per minute for running (depending on the sport).

  • avgRunningCadenceUint8strides/min

    Average running cadence, in strides per minute.

  • avgSwimmingCadenceUint8strokes/min

    Average swimming cadence, in strokes per minute.

  • avgPaddlesportCadenceUint8strokes/min

    Average cadence for paddle sports (kayak, SUP, rowing), in strokes per minute.

  • avgPushCadenceUint8pushes/min

    Average number of wheelchair pushes per minute.

  • maxCadenceUint8rpm

    Maximum cadence reached.

  • maxRunningCadenceUint8strides/min

    Maximum running cadence, in strides per minute.

  • maxSwimmingCadenceUint8strokes/min

    Maximum swimming cadence, in strokes per minute.

  • maxPaddlesportCadenceUint8strokes/min

    Maximum cadence for paddle sports, in strokes per minute.

  • maxPushCadenceUint8pushes/min

    Maximum number of wheelchair pushes per minute.

  • avgPowerUint16watts

    Average power output.

  • maxPowerUint16watts

    Maximum power output.

  • Cumulated elevation gain.

  • Cumulated elevation loss.

  • Intensity of the period: active, rest, warmup, cooldown, recovery, interval or other.

    7 possible values
    • interval
    • other
    • active
    • rest
    • warmup
    • cooldown
    • recovery
  • What ended the lap: manual press, time, distance, position, session end, fitness equipment…

    9 possible values
    • time
    • manual
    • fitnessEquipment
    • distance
    • positionStart
    • positionLap
    • positionWaypoint
    • positionMarked
    • sessionEnd
  • sportEnum

    Main sport, such as running, cycling, swimming, hiking or training.

    82 possible values
    • all
    • running
    • transition
    • generic
    • cycling
    • fitnessEquipment
    • swimming
    • basketball
    • soccer
    • tennis
    • americanFootball
    • training
    • walking
    • crossCountrySkiing
    • alpineSkiing
    • snowboarding
    • rowing
    • mountaineering
    • hiking
    • multisport
    • paddling
    • flying
    • eBiking
    • motorcycling
    • boating
    • driving
    • golf
    • hangGliding
    • horsebackRiding
    • hunting
    • fishing
    • inlineSkating
    • rockClimbing
    • sailing
    • iceSkating
    • skyDiving
    • snowshoeing
    • snowmobiling
    • standUpPaddleboarding
    • surfing
    • wakeboarding
    • waterSkiing
    • kayaking
    • rafting
    • windsurfing
    • kitesurfing
    • tactical
    • jumpmaster
    • boxing
    • floorClimbing
    • baseball
    • diving
    • shooting
    • winterSport
    • grinding
    • hiit
    • videoGaming
    • racket
    • wheelchairPushWalk
    • wheelchairPushRun
    • meditation
    • paraSport
    • discGolf
    • teamSport
    • cricket
    • rugby
    • hockey
    • lacrosse
    • volleyball
    • waterTubing
    • wakesurfing
    • waterSport
    • archery
    • mixedMartialArts
    • motorSports
    • snorkeling
    • dance
    • jumpRope
    • poolApnea
    • mobility
    • geocaching
    • canoeing
  • Groups related events together, so that start and stop events of the same group can be paired.

  • necLatSint32semicircles

    Latitude of the north-east corner of the bounding box containing the track, in semicircles.

  • necLongSint32semicircles

    Longitude of the north-east corner of the bounding box containing the track, in semicircles.

  • swcLatSint32semicircles

    Latitude of the south-west corner of the bounding box containing the track, in semicircles.

  • swcLongSint32semicircles

    Longitude of the south-west corner of the bounding box containing the track, in semicircles.

  • numLengthsUint16lengths

    Number of pool lengths, rest lengths included.

  • normalizedPowerUint16watts

    Normalized power (NP): an estimate of the power that could have been sustained for the same physiological cost if the effort had been perfectly steady.

  • Power contribution of the right leg, when the right bit is set, as a percentage of the total. The left leg makes up the rest.

    2 possible values
    • right
    • mask
  • messageIndex of the first pool length belonging to the lap.

  • Average distance covered at each stroke.

  • Swimming stroke: freestyle, backstroke, breaststroke, butterfly, drill, mixed or IM.

    9 possible values
    • freestyle
    • backstroke
    • breaststroke
    • butterfly
    • drill
    • mixed
    • im
    • imByRound
    • rimo
  • Refinement of the sport, such as trail, treadmill or track for running, road, mountain or indoor for cycling, lapSwimming or openWater for swimming.

    112 possible values
    • match
    • map
    • platform
    • all
    • track
    • navigate
    • field
    • generic
    • hiit
    • treadmill
    • street
    • trail
    • spin
    • indoorCycling
    • road
    • mountain
    • downhill
    • recumbent
    • cyclocross
    • handCycling
    • trackCycling
    • indoorRowing
    • elliptical
    • stairClimbing
    • lapSwimming
    • openWater
    • flexibilityTraining
    • strengthTraining
    • warmUp
    • exercise
    • challenge
    • indoorSkiing
    • cardioTraining
    • indoorWalking
    • eBikeFitness
    • bmx
    • casualWalking
    • speedWalking
    • bikeToRunTransition
    • runToBikeTransition
    • swimToBikeTransition
    • atv
    • motocross
    • backcountry
    • resort
    • rcDrone
    • wingsuit
    • whitewater
    • skateSkiing
    • yoga
    • pilates
    • indoorRunning
    • gravelCycling
    • eBikeMountain
    • commuting
    • mixedSurface
    • trackMe
    • singleGasDiving
    • multiGasDiving
    • gaugeDiving
    • apneaDiving
    • apneaHunting
    • virtualActivity
    • obstacle
    • breathing
    • ccrDiving
    • sailRace
    • expedition
    • ultra
    • indoorClimbing
    • bouldering
    • indoorGrinding
    • huntingWithDogs
    • amrap
    • emom
    • tabata
    • esport
    • triathlon
    • duathlon
    • brick
    • swimRun
    • adventureRace
    • truckerWorkout
    • pickleball
    • padel
    • indoorWheelchairWalk
    • indoorWheelchairRun
    • indoorHandCycling
    • ice
    • ultimate
    • squash
    • badminton
    • racquetball
    • tableTennis
    • overland
    • trollingMotor
    • flyCanopy
    • flyParaglide
    • flyParamotor
    • flyPressurized
    • flyNavigate
    • flyTimer
    • flyAltimeter
    • flyWx
    • flyVfr
    • flyIfr
    • dynamicApnea
    • enduro
    • rucking
    • rally
    • poolTriathlon
    • eBikeEnduro
  • numActiveLengthsUint16lengths

    Number of pool lengths actually swum.

  • totalWorkUint32J

    Total mechanical work produced.

  • Average altitude.

  • Highest altitude reached.

  • Estimated accuracy of the GPS position.

  • avgGradeFloat64%

    Average slope.

  • avgPosGradeFloat64%

    Average slope while climbing.

  • avgNegGradeFloat64%

    Average slope while descending.

  • maxPosGradeFloat64%

    Steepest uphill slope.

  • maxNegGradeFloat64%

    Steepest downhill slope.

  • Average ambient temperature measured by the device.

  • Highest ambient temperature measured by the device.

  • Time spent actually moving, excluding the time stopped even when the timer was running.

  • Average vertical speed while climbing.

  • Average vertical speed while descending.

  • Maximum vertical speed while climbing.

  • Maximum vertical speed while descending.

  • timeInHrZoneFloat64[]s

    Time spent in each heart rate zone. The first element is the time below zone 1, then zone 1, zone 2 and so on.

  • timeInSpeedZoneFloat64[]s

    Time spent in each speed zone.

  • Time spent in each cadence zone.

  • timeInPowerZoneFloat64[]s

    Time spent in each power zone. The first element is the time below zone 1, then zone 1, zone 2 and so on.

  • Repetition number, when the lap is part of a repeated workout step.

  • Lowest altitude reached.

  • minHeartRateUint8bpm

    Minimum heart rate recorded.

  • activeTimeFloat64s

    Time spent actually moving or working, excluding rest periods and pauses.

  • messageIndex of the workout step the data belongs to, in the workout file.

  • avgSwolfUint16

    Average SWOLF (swim golf) score: strokes plus seconds needed to swim a length. The lower, the more efficient.

  • Score of the opponent, for racket and team sports.

  • strokeCountUint16[]counts

    Number of strokes for each stroke type (serve, forehand, backhand, smash…), indexed by stroke type.

  • zoneCountUint16[]counts

    Number of hits for each zone, indexed by zone number.

  • Average vertical oscillation: how much the torso moves up and down at each step.

  • avgStanceTimePercentFloat64percent

    Average ground contact time, as a percentage of the step duration.

  • avgStanceTimeFloat64ms

    Average ground contact time: how long each foot stays on the ground at each step.

  • Fractional part of avgCadence, to add to it for a more precise value.

  • Fractional part of maxCadence, to add to it for a more precise value.

  • Fractional part of totalCycles, to add to it for a more precise value.

  • Score of the user, for racket and team sports.

  • Average total hemoglobin concentration, from a muscle oxygen sensor (one element per sensor).

  • Minimum total hemoglobin concentration, from a muscle oxygen sensor.

  • Maximum total hemoglobin concentration, from a muscle oxygen sensor.

  • Average muscle oxygen saturation (SmO2): share of hemoglobin carrying oxygen.

  • Minimum muscle oxygen saturation (SmO2).

  • Maximum muscle oxygen saturation (SmO2).

  • avgStrokesPerLengthFloat64strokes / length

    Average number of strokes per pool length.

  • Average torque effectiveness of the left leg: share of the pedal stroke producing positive power.

  • Average torque effectiveness of the right leg: share of the pedal stroke producing positive power.

  • Average pedal smoothness of the left leg: how evenly power is applied across the stroke.

  • Average pedal smoothness of the right leg: how evenly power is applied across the stroke.

  • Average pedal smoothness of both legs combined, for single-sided power meters.

  • Number of front derailleur shifts (electronic groupsets).

  • Number of rear derailleur shifts (electronic groupsets).

  • timeStandingFloat64s

    Total time spent standing on the pedals.

  • Number of times the rider moved from seated to standing.

  • avgLeftPcoSint8mm

    Average platform center offset of the left foot: how far from the center of the pedal the force is applied.

  • Average platform center offset of the right foot: how far from the center of the pedal the force is applied.

  • avgLeftPowerPhaseFloat64[]degrees

    Average start and end angles of the left pedal stroke portion producing positive power.

  • avgLeftPowerPhasePeakFloat64[]degrees

    Average start and end angles of the left pedal stroke portion producing peak power.

  • avgRightPowerPhaseFloat64[]degrees

    Average start and end angles of the right pedal stroke portion producing positive power.

  • avgRightPowerPhasePeakFloat64[]degrees

    Average start and end angles of the right pedal stroke portion producing peak power.

  • avgPowerPositionUint16[]watts

    Average power for each rider position (seated, standing).

  • maxPowerPositionUint16[]watts

    Maximum power for each rider position (seated, standing).

  • Average cadence for each rider position (seated, standing).

  • Maximum cadence for each rider position (seated, standing).

  • Average speed, with a larger range than avgSpeed. Prefer it when present.

  • Maximum speed, with a larger range than maxSpeed. Prefer it when present.

  • Average altitude, with a larger range than avgAltitude. Prefer it when present.

  • Lowest altitude, with a larger range than minAltitude. Prefer it when present.

  • Highest altitude, with a larger range than maxAltitude. Prefer it when present.

  • avgLevMotorPowerUint16watts

    Average motor power of the light electric vehicle (e-bike).

  • maxLevMotorPowerUint16watts

    Maximum motor power of the light electric vehicle (e-bike).

  • levBatteryConsumptionFloat64percent

    Battery consumed by the light electric vehicle (e-bike).

  • avgVerticalRatioFloat64percent

    Average vertical ratio: vertical oscillation divided by step length. The lower, the more efficient.

  • avgStanceTimeBalanceFloat64percent

    Average ground contact time balance between left and right foot.

  • avgStepLengthFloat64mm

    Average step length.

  • avgVamFloat64m/s

    Average VAM (velocità ascensionale media): the vertical ascent speed while climbing.

  • avgDepthFloat64m

    Average depth. 0 when above water.

  • maxDepthFloat64m

    Maximum depth reached. 0 when above water.

  • Lowest ambient temperature measured by the device.

  • enhancedAvgRespirationRateFloat64Breaths/min

    Average respiration rate, with more precision than avgRespirationRate. Prefer it when present.

  • enhancedMaxRespirationRateFloat64Breaths/min

    Maximum respiration rate, with more precision than maxRespirationRate. Prefer it when present.

  • Average respiration rate, in breaths per minute.

  • Maximum respiration rate, in breaths per minute.

  • totalGritFloat32kGrit

    Grit score: how difficult the trail was, based on its slopes and sharp turns. The higher, the harder.

  • totalFlowFloat32Flow

    Flow score: how smoothly the rider kept their momentum through the trail. The lower, the smoother.

  • jumpCountUint16

    Number of jumps detected.

  • avgGritFloat32kGrit

    Average grit score: difficulty of the trail per unit of distance.

  • avgFlowFloat32Flow

    Average flow score: how smoothly the rider kept their momentum.

  • Calories burned by the metabolism at rest during the period (basal metabolic rate), included in the total.

  • Fractional part of totalAscent, to add to it for a more precise value.

  • Fractional part of totalDescent, to add to it for a more precise value.

  • Average core body temperature, from a core temperature sensor.

  • Lowest core body temperature, from a core temperature sensor.

  • Highest core body temperature, from a core temperature sensor.

  • Average speed adjusted for the slope: the equivalent speed on flat ground for the same effort.

  • mesgNumString

    Global message number identifying the kind of message. Decoders use it to know which profile to apply to the data.

Other activity messages

See all the FIT messages