Length message

A length message describes one length of a pool swimming session, either active (swum) or idle (rest). It holds the stroke type, number of strokes, time and speed of the length.

FIT name: length
Global message number: 101
JavaScript SDK key: lengthMesgs
Fields: 24

Fields

messageIndexString
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.
timestampDateTime
Moment the length 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
eventTypeEnum
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.
totalElapsedTimeFloat64s
Total duration from start to end, pauses included (wall-clock time).
totalTimerTimeFloat64s
Duration during which the timer was running, pauses excluded. This is the time usually displayed as the duration.
totalStrokesUint16strokes
Number of strokes swum during the length.
avgSpeedFloat64m/s
Average speed: total distance divided by timer time.
swimStrokeEnumswim_stroke
Swimming stroke: freestyle, backstroke, breaststroke, butterfly, drill, mixed or IM.
9 possible values
- freestyle
- backstroke
- breaststroke
- butterfly
- drill
- mixed
- im
- imByRound
- rimo
avgSwimmingCadenceUint8strokes/min
Average swimming cadence, in strokes per minute.
eventGroupUint8
Groups related events together, so that start and stop events of the same group can be paired.
totalCaloriesUint16kcal
Total energy expenditure.
lengthTypeEnum
Whether the length was swum (active) or was a rest (idle).
2 possible values
- active
- idle
playerScoreUint16
Score of the user, for racket and team sports.
opponentScoreUint16
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.
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.
avgRespirationRateUint8
Average respiration rate, in breaths per minute.
maxRespirationRateUint8
Maximum respiration rate, in breaths per minute.
metabolicCaloriesUint16kcal
Calories burned by the metabolism at rest during the period (basal metabolic rate), included in the total.
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