stravalib.client.Client.explore_segments#

Client.explore_segments(bounds: tuple[float, float, float, float] | tuple[tuple[float, float], tuple[float, float]], activity_type: str | None = None, min_cat: int | None = None, max_cat: int | None = None) → list[SegmentExplorerResult][source]#

Returns an array of up to 10 segments.

https://developers.strava.com/docs/reference/#api-Segments-exploreSegments

Parameters:

  • bounds (tuple of 4 floats or tuple of 2 (lat,lon) tuples) – list of bounding box corners lat/lon [sw.lat, sw.lng, ne.lat, ne.lng] (south,west,north,east)

  • activity_type (str) – optional, default is riding) ‘running’ or ‘riding’

  • min_cat (int, optional, default=None) – Minimum climb category filter

  • max_cat (int, optional, default=None) – Maximum climb category filter

Returns:

An list of stravalib.model.Segment.

Return type:

list

Warns:

FutureWarning – Strava limited the Explore Segments endpoint to the Extended Access Tier on the date that the warning gives. Standard Tier is the default for every application, so calls from an application in the Standard Tier fail. See https://developers.strava.com/docs/changelog/.