Class: Strava::Models::DetailedSegmentEffort

Inherits:

Response

• Object
• Hashie::Trash
• Strava::Model
• Response
• Strava::Models::DetailedSegmentEffort

Includes:

Mixins::Distance, Mixins::ElapsedTime, Mixins::MovingTime, Mixins::StartDateLocal

Defined in:

lib/strava/models/detailed_segment_effort.rb

Overview

Represents detailed information about a segment effort within an activity.

A segment effort is an attempt at a defined segment (a portion of road or trail). The detailed version includes comprehensive statistics, rankings, achievements, and sensor data for the effort.

Examples:

Accessing detailed segment effort

effort = client.segment_effort(1234567890)

puts "Segment: #{effort.name}"
puts "Time: #{effort.elapsed_time_in_hours_s}"
puts "Moving time: #{effort.moving_time_in_hours_s}"
puts "Distance: #{effort.distance_s}"

if effort.average_watts
  puts "Avg Power: #{effort.average_watts}W"
end

if effort.average_heartrate
  puts "Avg HR: #{effort.average_heartrate} bpm (max: #{effort.max_heartrate})"
end

# Check rankings
puts "KOM Rank: #{effort.kom_rank}" if effort.kom_rank
puts "PR Rank: #{effort.pr_rank}" if effort.pr_rank

# View achievements
effort.achievements.each do |achievement|
  puts "Achievement: #{achievement.type} - Rank #{achievement.rank}"
end

See Also:

• Strava API DetailedSegmentEffort reference
• SummarySegmentEffort
• SummarySegment
• Achievement

Instance Method Summary

• #achievements ⇒ Array<Achievement>

  Achievements earned during this effort (PR, yearly records, etc.).

• #activity ⇒ MetaActivity

  Reference to the parent activity.

• #activity_id ⇒ Integer

  ID of the activity containing this segment effort.

• #athlete ⇒ MetaAthlete

  Reference to the athlete who performed this effort.

• #athlete_segment_stats ⇒ SummaryPRSegmentEffort^?

  Athlete's personal statistics for this segment.

• #average_cadence ⇒ Float^?

  Average cadence during the effort (RPM for cycling, steps/min for running).

• #average_heartrate ⇒ Float^?

  Average heart rate during the effort in beats per minute.

• #average_watts ⇒ Float^?

  Average power output during the effort in watts.

• #device_watts ⇒ Boolean^?

  Whether power data comes from a power meter device.

• #end_index ⇒ Integer

  Index in the activity stream where this effort ends.

• #hidden ⇒ Boolean

  Whether this effort is hidden from public segment leaderboards.

• #id ⇒ Integer

  Unique identifier for this segment effort.

• #is_kom ⇒ Boolean

  Whether this effort achieved KOM (King/Queen of the Mountain).

• #kom_rank ⇒ Integer^?

  Overall rank on this segment (null if not in top 10).

• #max_heartrate ⇒ Integer^?

  Maximum heart rate during the effort in beats per minute.

• #name ⇒ String

  Name of the segment.

• #pr_rank ⇒ Integer^?

  Personal record rank for this segment (1 for PR, 2 for 2nd best, etc.).

• #resource_state ⇒ Integer

  Resource state indicator.

• #segment ⇒ SummarySegment

  The segment that was attempted.

• #start_date ⇒ Time

  Start time of the segment effort in UTC.

• #start_index ⇒ Integer

  Index in the activity stream where this effort starts.

• #visibility ⇒ String^?

  Visibility setting for this effort.

Methods included from Mixins::MovingTime

#moving_time_in_hours_s

Methods included from Mixins::Distance

#distance_in_feet, #distance_in_kilometers, #distance_in_kilometers_s, #distance_in_meters, #distance_in_meters_s, #distance_in_miles, #distance_in_miles_s, #distance_in_yards, #distance_in_yards_s, #distance_s

Methods included from Mixins::ElapsedTime

#elapsed_time_in_hours_s

Instance Method Details

#achievements ⇒ Array<Achievement>

Note:

Not documented by Strava API

Returns Achievements earned during this effort (PR, yearly records, etc.).

Returns:

• (Array<Achievement>) —

  Achievements earned during this effort (PR, yearly records, etc.)

# File 'lib/strava/models/detailed_segment_effort.rb', line 115

property 'achievements', transform_with: ->(v) { v.map { |r| Strava::Models::Achievement.new(r) } }

#activity ⇒ MetaActivity

Returns Reference to the parent activity.

Returns:

• (MetaActivity) —

  Reference to the parent activity

# File 'lib/strava/models/detailed_segment_effort.rb', line 68

property 'activity', transform_with: ->(v) { Strava::Models::MetaActivity.new(v) }

#activity_id ⇒ Integer

Returns ID of the activity containing this segment effort.

Returns:

• (Integer) —

  ID of the activity containing this segment effort

# File 'lib/strava/models/detailed_segment_effort.rb', line 47

property 'activity_id'

#athlete ⇒ MetaAthlete

Returns Reference to the athlete who performed this effort.

Returns:

• (MetaAthlete) —

  Reference to the athlete who performed this effort

# File 'lib/strava/models/detailed_segment_effort.rb', line 71

property 'athlete', transform_with: ->(v) { Strava::Models::MetaAthlete.new(v) }

#athlete_segment_stats ⇒ SummaryPRSegmentEffort^?

Note:

Not documented by Strava API

Returns Athlete's personal statistics for this segment.

Returns:

• (SummaryPRSegmentEffort, nil) —

  Athlete's personal statistics for this segment

# File 'lib/strava/models/detailed_segment_effort.rb', line 123

property 'athlete_segment_stats', transform_with: ->(v) { Strava::Models::SummaryPRSegmentEffort.new(v) }

#average_cadence ⇒ Float^?

Returns Average cadence during the effort (RPM for cycling, steps/min for running).

Returns:

• (Float, nil) —

  Average cadence during the effort (RPM for cycling, steps/min for running)

# File 'lib/strava/models/detailed_segment_effort.rb', line 83

property 'average_cadence'

#average_heartrate ⇒ Float^?

Returns Average heart rate during the effort in beats per minute.

Returns:

• (Float, nil) —

  Average heart rate during the effort in beats per minute

# File 'lib/strava/models/detailed_segment_effort.rb', line 92

property 'average_heartrate'

#average_watts ⇒ Float^?

Returns Average power output during the effort in watts.

Returns:

• (Float, nil) —

  Average power output during the effort in watts

# File 'lib/strava/models/detailed_segment_effort.rb', line 86

property 'average_watts'

#device_watts ⇒ Boolean^?

Returns Whether power data comes from a power meter device.

Returns:

• (Boolean, nil) —

  Whether power data comes from a power meter device

# File 'lib/strava/models/detailed_segment_effort.rb', line 89

property 'device_watts'

#end_index ⇒ Integer

Returns Index in the activity stream where this effort ends.

Returns:

• (Integer) —

  Index in the activity stream where this effort ends

# File 'lib/strava/models/detailed_segment_effort.rb', line 80

property 'end_index'

#hidden ⇒ Boolean

Returns Whether this effort is hidden from public segment leaderboards.

Returns:

• (Boolean) —

  Whether this effort is hidden from public segment leaderboards

# File 'lib/strava/models/detailed_segment_effort.rb', line 107

property 'hidden'

#id ⇒ Integer

Returns Unique identifier for this segment effort.

Returns:

• (Integer) —

  Unique identifier for this segment effort

# File 'lib/strava/models/detailed_segment_effort.rb', line 44

property 'id'

#is_kom ⇒ Boolean

Returns Whether this effort achieved KOM (King/Queen of the Mountain).

Returns:

• (Boolean) —

  Whether this effort achieved KOM (King/Queen of the Mountain)

# File 'lib/strava/models/detailed_segment_effort.rb', line 62

property 'is_kom'

#kom_rank ⇒ Integer^?

Returns Overall rank on this segment (null if not in top 10).

Returns:

• (Integer, nil) —

  Overall rank on this segment (null if not in top 10)

# File 'lib/strava/models/detailed_segment_effort.rb', line 101

property 'kom_rank'

#max_heartrate ⇒ Integer^?

Returns Maximum heart rate during the effort in beats per minute.

Returns:

• (Integer, nil) —

  Maximum heart rate during the effort in beats per minute

# File 'lib/strava/models/detailed_segment_effort.rb', line 95

property 'max_heartrate'

#name ⇒ String

Returns Name of the segment.

Returns:

• (String) —

  Name of the segment

# File 'lib/strava/models/detailed_segment_effort.rb', line 65

property 'name'

#pr_rank ⇒ Integer^?

Returns Personal record rank for this segment (1 for PR, 2 for 2nd best, etc.).

Returns:

• (Integer, nil) —

  Personal record rank for this segment (1 for PR, 2 for 2nd best, etc.)

# File 'lib/strava/models/detailed_segment_effort.rb', line 104

property 'pr_rank'

#resource_state ⇒ Integer

Note:

Not documented by Strava API

Returns Resource state indicator.

Returns:

• (Integer) —

  Resource state indicator

# File 'lib/strava/models/detailed_segment_effort.rb', line 111

property 'resource_state'

#segment ⇒ SummarySegment

Returns The segment that was attempted.

Returns:

• (SummarySegment) —

  The segment that was attempted

# File 'lib/strava/models/detailed_segment_effort.rb', line 98

property 'segment', transform_with: ->(v) { Strava::Models::SummarySegment.new(v) }

#start_date ⇒ Time

Returns Start time of the segment effort in UTC.

Returns:

• (Time) —

  Start time of the segment effort in UTC

# File 'lib/strava/models/detailed_segment_effort.rb', line 53

property 'start_date', transform_with: ->(v) { Time.parse(v) }

#start_index ⇒ Integer

Returns Index in the activity stream where this effort starts.

Returns:

• (Integer) —

  Index in the activity stream where this effort starts

# File 'lib/strava/models/detailed_segment_effort.rb', line 77

property 'start_index'

#visibility ⇒ String^?

Note:

Not documented by Strava API

Returns Visibility setting for this effort.

Returns:

• (String, nil) —

  Visibility setting for this effort

# File 'lib/strava/models/detailed_segment_effort.rb', line 119

property 'visibility'