The Metrics API gives you access to cycling specific weather metrics. The processing of your request may take a few seconds. This is due to the processing and retrieval of route and forecast data. We recommend to you prefetch and store the output, or display the output asynchronously, so as to avoid page loading issues.
POST | GET
Every request must include your access credentials. These can be passed by either in the request string. If you do not have an API Client ID you must apply here.
Passing Source Data
Required. Defines the type of source data
Allowed inputs: gpx | tcx | course | strava_segment | strava_route | strava_activity
Required for GPX or TCX sources.
Required for, Strava, Course or CTT sources.
timestamp (unix time)
Not required for TCX files unless the TCX route is to be used as a forecast. UTC timestamp for the forecast start. Timestamps that are in the past, will source observed conditions. Timestamps in the future will source forecast conditions.
Passing Athlete Parameters
For a customised forecast a Virtual Athlete must be defined. For forecasts this allows our models to calculate anticipated progress. For past rides this allows us to calculate metrics personalised to the athlete.
va=JSON Virtual Athlete Object
Virtual Athlete JSON Object
Required. In Kg the total weight of rider, bike and equipment combined.
Power in Watts, when ascending hills.
Required. Power in Watts, when riding on the flat.
Power in Watts, when descending.
Expected losses from the drivetrain. Only required where power has been determined above the bicycle transmission.
Expected Value: 0-100
The average CdA, Aerodynamic efficiency.
Expected Value: >0.000
Rolling Resistnace Coefficient.
Expected Value: >0.0000
output (comma separated list)
As default the following objects will be returned, averages, minvalues, maxvalues and totals. You can customise the output by including the ‘output’ parameter in your request. Note: the ‘totals object’ is always returned.
“&output=averages,totals” will include only the averages and totals objects.
Available objects are:
Any speed values will be provided in the chosen unit. Default is kmh.
Expected Values: kmh | mph
Any wind speed values will be provided in the chosen unit. Default is ms.
Expected Values: ms | kmh | mph
Allows you to group your access requests in our reports.