Tools to extract live data

Poll specific parameters from */current API to show race data in real time. Handy tools to feed overlays for video production and web broadcasting.

The grabber is an HTML file and runs in a browser tab. 
Adjust the grabber in an editor with the settings in the tables. 
The grabber pulls one specific parameter from the */current API. 
The */current API must be activated and switched on.
Monochrome background.
*/current, location data
Basic grabber
​Download the basic grabber for your usage.
The file (grabCurrentAPI.html) is set to call a sample event with infinite real-time data.
deviceIds
refDeviceId
Options 1 to 3: With set deviceIds or with set startNumbers or with set showLeaders the grabber shows the parameter for one or for more specific devices instead of the list with all devices. 
Options 4 and 5: Set refDeviceId or refStartNumber for calculation with reference device instead of the leader device.
gapAverage, gap, gapChase and gapDistance are calculated for the leader (device with smallest toFinish) by default. 
deviceIds = "6336f41309be310001a58976" to show one participant only
refDeviceId = "6336f41309be310001a58971" to show gapDistance to team PLAN:LOS
Without deviceIds: list of all participants 
Field
Description [unit]
Sample
eventId
Id of the tracking map 
Add optional query parameters, also
"6336f41309be310001a5894b" or
"6336f41309be310001a5894b?interpolation=false&currentSpeedDuration=60"
outputData
Parameter to be shown in browser tab
"gapAverage" or "speed"
textBehind
Add text behind the unit
"Distance to go" or "🏁"
withStarterName
Show or hide the name of the participant
true or false
withStartNumber
Show or hide the race number of the participant
true or false
pollingRate
Time beween polling in [s]
2 or 15
deviceIds
Option 1: ids of one or more devices, values of these devices only are pulled, [] shows all devices
[] or ["6336f41309be310001a58976"] or ["6336f41309be310001a58975", "6336f41309be310001a58973"]
startNumbers
Option 2: Race numbers of one or more devices, values of these devices only are pulled, [] shows all devices
[] or ["051"] or ["051", "050"]
showLeaders
Option 3: Number of shown leading devices determined of fromStart; 0 shows all devices
0 or 1 or 5 or 10
refDeviceId
Option 4: id of a reference for calculation of gapAverage, gap, gapChase and gapDistance
"6336f41309be310001a58977"
refStartNumber
Option 5: Bib of a reference for calculation of gapAverage, gap, gapChase and gapDistance
"053"
Set imperial units
Open grabber tool in an editor
In order to show speed values as miles per hour replace line 50 with:
speed: { value: 2.2369356, unit: "mph", sorting: "DESC" },
 In order to show speedRaw values as miles per hour replace line 51 with:
speedRaw: { value: 2.2369356, unit: "mph", sorting: "DESC" },
In order to show fromStart values as miles replace line 52 with:
fromStart: { value: 0.000621371, unit: "mile", sorting: "DESC" }
In order to show toFinish values as miles replace line 53 with:
toFinish: { value: 0.000621371, unit: "mile", sorting: "DESC" }
Drafting tool
​Download the drafting tool for your usage.
The file (grabCurrentAPIDrafting.html) is set to call a sample event with infinite real-time data.
The table sorts all devices in ascending order according to the toFinish parameter. 
"To previous"-column shows the distance to the device that moves ahead. 
"Draft time"-column starts counting the time when the device is moving within the draft zone (alertValue in [m] set distance to the device ahead). 
"Drafts"-column detects a draft when drafting takes longer than the set alertTime in [s].  
Hover over the number of drafts for additional information.
Christoph overtakes Konrad monitored by the drafting tool. At 14:27:31 Christoph was moving for 44s in the draft zone behind Konrad.
Spotter tool
​Download the spotter tool for your usage.
The file (spotter.html) is set to call a sample event with infinite real-time data.
Define up to three different spots (distance from start in m). 
The table sorts participants in the sensitive range (rangeBeforeSpot and rangeAfterSpot) coming closer to the spot. 
Real-time information from anywhere on the race-course e.g. for the speaker.

Field	Description [unit]	Sample
`eventId`	Id of the tracking map Add optional query parameters, also	`"6336f41309be310001a5894b"` or `"6336f41309be310001a5894b?interpolation=false&currentSpeedDuration=60"`
`outputData`	Parameter to be shown in browser tab	`"gapAverage"` or `"speed"`
`textBehind`	Add text behind the unit	`"Distance to go"` or `"🏁"`
`withStarterName`	Show or hide the name of the participant	`true` or `false`
`withStartNumber`	Show or hide the race number of the participant	`true` or `false`
`pollingRate`	Time beween polling in [s]	`2` or `15`
`deviceIds`	Option 1: ids of one or more devices, values of these devices only are pulled, `[]` shows all devices	`[]` or `["6336f41309be310001a58976"]` or `["6336f41309be310001a58975", "6336f41309be310001a58973"]`
`startNumbers`	Option 2: Race numbers of one or more devices, values of these devices only are pulled, `[]` shows all devices	`[]` or `["051"]` or `["051", "050"]`
`showLeaders`	Option 3: Number of shown leading devices determined of `fromStart`; `0` shows all devices	`0` or `1` or `5` or `10`
`refDeviceId`	Option 4: id of a reference for calculation of `gapAverage`, `gap`, `gapChase` and `gapDistance`	`"6336f41309be310001a58977"`
`refStartNumber`	Option 5: Bib of a reference for calculation of `gapAverage`, `gap`, `gapChase` and `gapDistance`	`"053"`

*/starters, athlete data

Import participant data

Last modified 4d ago