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.

page*/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.

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.

FieldDescription [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

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.

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.

Previous*/starters, athlete dataNextImport participant data

Last updated