public interface StreamService extends StravaService
Streams is the Strava term for the raw data associated with an activity. All streams for a given activity or segment effort will be the same length and the values at a given index correspond to the same time.
List<StravaStream> getActivityStreams(Integer id, StravaStreamResolutionType resolution, StravaStreamSeriesDownsamplingType seriesType, StravaStreamType... types)
Streams represent the raw data of the uploaded file. External applications may only access this information for activities owned by the authenticated athlete.
While there are a large number of stream types, they may not exist for all activities. If a stream type does not exist for the
activity, it will be ignored.
All streams for a given activity will be the same length and the values at a given index correspond to the same time. For example, the time from the time stream can be correlated to the lat/lng or watts streams.
Privacy Zones
StravaStream requests made using a public access_token will be cropped with the user's privacy zones, regardless if the requesting athlete owns the requested activity. To fetch the complete stream data use an access_token with view_private permissions.
URL GET https://www.strava.com/api/v3/activities/:id/streams/:types
id - The id of the activity for which streams are to be retrievedtypes - List of types, if the activity does not have that stream it will not be included in the responseresolution - (Optional) low (100), medium (1000) or high (10000), default is all, indicates desired number of data points, streams will only be down
sampledseriesType - (Optional) relevant only if using resolution. Either "time" or "distance", default is "distance", used to index the streams if the stream is
being reducednull if the activity doesn't existUnauthorizedException - If there is a security exceptionList<StravaStream> getActivityStreams(Integer id)
Streams represent the raw data of the uploaded file. External applications may only access this information for activities owned by the authenticated athlete.
While there are a large number of stream types, they may not exist for all activities. If a stream type does not exist for the
activity, it will be ignored.
All streams for a given activity will be the same length and the values at a given index correspond to the same time. For example, the time from the time stream can be correlated to the lat/lng or watts streams.
Privacy Zones
StravaStream requests made using a public access_token will be cropped with the user's privacy zones, regardless if the requesting athlete owns the requested activity. To fetch the complete stream data use an access_token with view_private permissions.
URL GET https://www.strava.com/api/v3/activities/:id/streams/:types
id - The id of the activity for which streams are to be retrievednull if the activity doesn't existUnauthorizedException - If there is a security exceptionList<StravaStream> getEffortStreams(Long id, StravaStreamResolutionType resolution, StravaStreamSeriesDownsamplingType seriesType, StravaStreamType... types)
A segment effort represents an attempt on a segment. This resource returns a subset of the
activity streams that correspond to that effort.
All streams for a given segment effort will be the same length and the values at a given index correspond to the same time.
This resource is available for all public efforts.
URL GET https://www.strava.com/api/v3/segment_efforts/:id/streams/:types
id - The id of the segment effort for which streams are to be retrievedtypes - List of types, if the effort does not have that stream it will not be included in the responseresolution - (Optional) low (100), medium (1000) or high (10000), default is all, indicates desired number of data points, streams will only be down
sampledseriesType - (Optional) relevant only if using resolution. Either "time" or "distance", default is "distance", used to index the streams if the stream is
being reducedList<StravaStream> getEffortStreams(Long id)
A segment effort represents an attempt on a segment. This resource returns a subset of the
activity streams that correspond to that effort.
All streams for a given segment effort will be the same length and the values at a given index correspond to the same time.
This resource is available for all public efforts.
URL GET https://www.strava.com/api/v3/segment_efforts/:id/streams/:types
id - The id of the segment effort for which streams are to be retrievedList<StravaStream> getSegmentStreams(Integer id, StravaStreamResolutionType resolution, StravaStreamSeriesDownsamplingType seriesType, StravaStreamType... types)
Retrieve detailed geographical information streams about a specific StravaSegment.
Only distance, altitude and latlng stream types are available.
URL GET https://www.strava.com/api/v3/segments/:id/streams/:types
id - The id of the segment for which streams are to be retrievedtypes - List of types, if the segment does not have that stream it will not be included in the responseresolution - (Optional) low (100), medium (1000) or high (10000), default is all, indicates desired number of data points, streams will only be down
sampledseriesType - (Optional) relevant only if using resolution. Either "time" or "distance", default is "distance", used to index the streams if the stream is
being reducedList<StravaStream> getSegmentStreams(Integer id)
Retrieve detailed geographical information streams about a specific StravaSegment.
Only distance, altitude and latlng stream types are available.
URL GET https://www.strava.com/api/v3/segments/:id/streams/:types
id - The id of the segment for which streams are to be retrievedCopyright © 2015 Dan Shannon. All rights reserved.