SAP Sailing Analytics Webservices API Version 1.0

URL: /api/v1/regattas/{regattaname}/races/{racename}/wind_at_position

Description:

Gets interpolated, averaged and dampened wind data for a race for one or more positions specified in the query parameters.
All slashes contained within the {regattaname} and {racename} parameters must be replaced by "__" (double underscore).

The request must be authenticated with a user who has the TRACKED_RACE:EXPORT permission for the race for which the data is requested.
Webservice Type: REST
Output format: Json
Mandatory parameters:
fromtime (ISO format, such as 2014-02-14T10:12:03Z) or fromtimeasmillis (time in milliseconds)
intervalasmillis (milliseconds to add for each next set of wind fixes to return, starting at fromtime/fromtimeasmillis); must be a positive value
latDeg[] can occur one or more times and specifies the latitudes in degrees (WGS84/GPS) for which to request wind data; typically, these positions will be on or near the race course area, so clients should first figure out, e.g., where the course marks of that race are. The number of occurrences of this parameter must equal the number of occurrences of the lngDeg[] parameter.
lngDeg[] can occur one or more times and specifies the longitude in degrees (WGS84/GPS) for which to request wind data; typically, these positions will be on or near the race course area, so clients should first figure out, e.g., where the course marks of that race are. The number of occurrences of this parameter must equal the number of occurrences of the latDeg[] parameter.
Optional parameters:
totime (ISO format, such as 2014-02-14T10:12:03Z) or totimeasmillis (time in milliseconds); if not provided, an open-ended interval is assumed, limited by the maximum number of wind fixes of currently 10,000 per request.
windsource [COMBINED = Default, WEB, EXPEDITION, TRACK_BASED_ESTIMATION, COURSE_BASED, RACECOMMITTEE]
windsourceid (Id of a wind source. For example Igtimi wind sources will have the type=EXPEDITION but each of them has unique ids. If you want to filter by these then you can use this parameter)
Optional HTTP request header fields:
secondaryuserbearertoken: if provided, used to authenticate a subject for which then the TRACKED_RACE:EXPORT permission is checked for the race requested. This will skip the same test for the "primary" user that authenticated the request.
Request method: GET
Example: https://www.sapsailing.com/sailingserver/api/v1/regattas/TW2026 - Hobie 16/races/R2 Hobie 16/wind_at_position?fromtime=2026-07-18T11:12:00Z&totime=2026-07-18T11:30:00Z&intervalasmillis=1000&latDeg[]=53.98174911502983&lngDeg[]=10.888688817322443&latDeg[]=54.1&lngDeg[]=9.2
Back to Web Service Overview