RACE RESULT import

Synchronize participants data through Simple API.

Go to participants settings in your Racemap event and open the import/export tab. Past the RACE RESULT event id or the URL of the access file. Racemap checks the access and provides feedback. Select the contests for synchronization with Racemap.

Multi-stage events with one participant file in RACE RESULT: To prevent overwriting start- and finish reads in finished stages with data from the running stage, deactivate the synchronization in finished stages.

Simple API

In order to let Racemap query participant data go to Main Window, Simple API, and select Racemap access.

Simple API must provide the parameters:

  • ID in Id field

  • Contest

If Id or Contest parameter are missing the participant won't be pulled to Racemap.

  • ID must be unique within each contest

  • Timestamps in Start- and Finish field in UTC format: ISO 8601 https://en.wikipedia.org/wiki/ISO_8601

  • The fields Age, Sex, Club, Nationality, and Status are imported as tags into Racemap participant list.

Parameters of the simple API displayed in tracking map: RaceNr, Firstname, Lastname, Status, Age, Sex, Club and Nationality.

Transponder1 field

Adapt the Transponder1 field for the transponder id of passive- (Bib) or active timing (Transponder1) or use the TransponderInChipFile argument.

When conducting predictive tracking, you can hide participants from visualization depending on their status. The if function in the Transponder1 field removes the transponder id of participants with DNS, DSQ, or DNF status.

if([StatusText]="DNS" OR [StatusText]="DSQ" OR [StatusText]="DNF";"";[Bib])

Prediction: Passings from timekeeping for live extrapolation of participants' location and speed.

pagePredictive tracking with reads from race timing

Custom field and User defined fields

Use the custom field in the simple API to flexibly import

  • [Color] to specify markers in the visualization with different colors,

  • [Key] to enable live tracking with Racemap App,

  • [IMEI] ids of GPS trackers and

  • [TAGS] additional tags to filter participants in the visualization and in the leaderboard.

[Color]&";"&[Key]&";"&[IMEI]&";"&[TAGS]

Go to Main Window, Participants Data, User Defined Fields to define the arguments in the custom field.

[Color]

The color parameter sets various colors of the markers in the tracking map and needs to be defined as color hex code.

Color depending on contests: Switch function in user defined fields. If Contest.Name of a participant is "Gravel" then color is "#F2F2F2". If Contest.Name is "MTB"color is "#04B404".

switch([Contest.Name]="Gravel";"#F2F2F2";[Contest.Name]="MTB";"#04B404")

Color depending on gender: Translate function in user defined fields: Set the first color ("#F2F2F2") for female and the second color ("#000000") for male.

translate([gender];"#F2F2F2";"#000000")

[Key]

Online registration with live tracking through Racemap App for every participant. Keys enable Racemap App for live tracking of a specific event.

pageKeys and passcode

Assign keys to participants.

The switch function in the Key field assigns one key to every participant.

switch([Bib]>0 AND [Bib]<=500;[Key_1];[Bib]>500 AND [Bib]<=1000;[Key_2];[Bib]>1000 AND [Bib]<=1500;[Key_3])

Choose function in Key_1 field:

  • Paste keys from Racemap of the corresponding Racemap event. choose([Bib];"xxxxxx";"yyyyyy";"zzzzzz";...)

  • Up to 500 keys fit in one user defined field.

  • For more than 500 participants in the contest set up a second field Key_2 and so on. choose([Bib]-500;"XXXXXX";"YYYYYY";"ZZZZZZ";...)

Online registration with optional live tracking through Racemap App e.g. when the event wants to sell live tracking. Go to Main Window, Participants Data, Additional Fields, and add a checkbox "App".

If function in Key field: If the participant checks "Agree to live tracking with Racemap App" one key is assigned to this participant.

if([App]=1;switch([Bib]>0 AND [Bib]<=500;[Key_1];[Bib]>500 AND [Bib]<=1000;[Key_2];[Bib]>1000 AND [Bib]<=1500;[Key_3]))

[IMEI]

You own GPS trackers or you have rented GPS devices for an event. Assign trackers to participants, the IMEI numbers refer to specific GPS devices.

Online registration with optional live tracking through Racemap App and with GPS tracker. Go to Main Window, Participants Data, Additional Fields, and add the checkbox "App" and add a second checkbox "Tracker".

Key field and Key_1 field are similar to the sample above.

If function in IMEI field: If the participant checks "Live Tracking GPS Tracker" one IMEI is assigned to this participant.

if([Tracker]=1;switch([Bib]>0 AND [Bib]<=100;"IMEI"&[IMEI_1]))

Choose function in IMEI_1 field, past the IMEI numbers from the GPS devices.

choose([Bib];"xxxxxx";"yyyyyy";"zzzzzz";...)

[TAGS]

Synchronize additional information about categories such as sponsor, mixed team, ... in order to filter participants in the visualization and in the leaderboard. Go to Main Window, Participants Data, Additional Fields, and add the test fields "Team" and "Sponsor".

Argument in TAGS field of the user defined fields in order to insert the two tags team and sponsor of the participant.

"TAGS"&"Team:"&[Team]&",Sponsor:"&[Sponsor]

Best-practice samples

Cut-off time detected at a checkpoint

Participants reach the checkpoint before the cut-off time and continue on the white course.

  • RACE RESULT settings with three contests - grey, white and black:

  • User defined field for sorting participants during the event from grey contest to white or to black depending on detections at the checkpoint.

cut-offgreywhiteblack

until cut-off time

all participants

no participant

no participant

from cut-off time

no participant

participants with detection at checkpoint

participants without detection at checkpoint

Racemap settings:

  • create a tracking map with the white course (shadowtrack) and synchronize participants from grey and white contests

  • create another map with the black course and synchronize participants from grey and black contests

  • create a group and add the white map

Description of the process:

  • From the start, all participants are calculated on the white- and on the black shadowtrack. That means each participant is shown twice - in the white and the black map.

  • At the cut-off time the participants in the white (black) contest are synchronized with the white (black) map. That means each participant is visible in either the white or the black map.

  • Now, add the black map to the group map. That way spectators continue streaming the same group with the new sorting of participants.

To select a contest in the RACE RESULT import at least one participant needs to be assigned to this contest. That means at the beginning you need to add one participant in the white and the black contest. This one participant does not need to have a transponder Id.

Last updated