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

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.

refDeviceId

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.