RACE|RESULT API
Import and synchronize participants using RACE|RESULT Simple API.
Past the RACE|RESULT event ID or the URL of the Racemap access file. The API checks the access and provides feedback. Select the contests to sync specific participants.
past event ID and select the contest
event Id
access file
Sync participant data with RACE|RESULT using event Id
Sync participant data with RACE|RESULT using Racemap access file

Settings in RACE|RESULT Simple API and User defined fields

Main Window, Simple API, select Racemap access. Use the custom field to flexibly import colors, keys, and the IMEI of your GPS trackers.
1
[Color]&";"&[Key]&";"&[IMEI]&"
Copied!
Main Window, Simple API, Racemap access
Participants Data, User Defined Fields - for keys, color and IMEI of your GPS units

Import and visibility

Import of participants with transponder ID, only
Simple API must provide the parameters:
    Id
    RaceNr
    Transponder1
    Firstname
    Contest
    Visibility
If one parameter is missing the participant won't be pulled to Racemap. Knowledge Base - Simple API to pull data from RACE|RESULT: https://www.raceresult.com/en/support/kb.php?id=8165-Racemap
    Id must be unique within each contest
    UTC format of Start and Finish: ISO 8601 https://en.wikipedia.org/wiki/ISO_8601
    Transponder1 and Transponder2 with transponder Id
      Option 1: insert Chip-Codes to every participant: fill in “Transponder1” in field "Transponder1" (default)
      Option 2: match participants with chipfile: fill in "TransponderInChipFile" in field "Transponder1"
Visibility - parameters of Simple API displayed in tracking map
    RaceNr
    Firstname
    Lastname
    (Club) - optional in brackets
    Color of flags respectively of dots
Activate the feature Predictive Tracking in your Racemap event to show participants with transponderId, only (and no IMEI or no AppId).

Best-practice samples

Multi-stage events

Multi-stage events with only one participant file in RACE|RESULT: To prevent overwriting start- and finish reads in finished stages with data from the running stage, remove the synchronization in finished stages eg. delete the contest in the API.

Cut-off time detected at checkpoint

before cut-off time
after cut-off time
Participants reach the checkpoint before the cut-off time and continue on the white course.
Participants reach the checkpoint after the cut-off time and continue on the black course (or finish at this checkpoint or ...).
RACE|RESULT settings with three contests - grey, white and black:
if([TopLakeCTS]<>"";[TopLakeCTS];if(T401>=17:44:50;"Lake";"Top"))
    User defined field for sorting participants during the event from grey contest to white or to black depending on detections at the checkpoint.
    Insert this field in the "contest"-field of the Racemap Acces.
grey
white
black
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.

Integrate keys in RACE|RESULT online registration

Assign keys to participants: Main Window » Participants Data » User Defined Fields
User Defined Fields: insert keys and join one key with every participant
field "TrackingKey":
1
switch([Bib]>0 AND [Bib]<=500;[TrackingKey_1];
2
[Bib]>500 AND [Bib]<=1000;[TrackingKey_2]; ... ;
3
[Bib]>xxxx AND [Bib]<=xxxx;[TrackingKey_n]);"")
Copied!
1
Copied!
field "TrackingKey_1":
    up to 500keys fit into one user defined field
    for more participants set up a 2nd field "TrackingKey_2"
    insert keys in this format choose([Bib];"xxxxxx";"xxxxxx";"xxxxxx")
Checkbox:
    Main Window » Participants Data » Additional Fields
    add checkbox field such as "Agree to live tracking"
Checkbox to let participants agree live tracking
User Defined Fields: insert keys and link to checkbox
field "TrackingKey":
1
iif[AYN1]=1;switch([Bib]>0 AND [Bib]<=500;[TrackingKey_1];
2
[Bib]>500 AND [Bib]<=1000;[TrackingKey_2]; ... ;
3
[Bib]>xxxx AND [Bib]<=xxxx;[TrackingKey_n]);"")
Copied!
"iff[AYN1]=1"-function: whether participant checked Live Tracking ("AYN1" - "Additional Yes/No Field" 1 - "Agree to Live-Tracking") if yes: one Tracking Key is joint with participant

Color dependencies

With the color parameter, you define specific colors for the markers in your tracking map.
    color to be defined as color hex code
    Main Window » Participant Data » User Defined Fields
Colors in one Tracking Map for different contests or gender, ...
Color depending on gender
set the color of the marker in the tracking map depending in the gender
"translate"-function: set the first color ("#F2F2F2") for female and the second color ("#000000") for male
1
translate([gender];"#F2F2F2";"#000000")
Copied!
Color depending on contest
"switch"-function. In this example there are two contests ("Contest1" and "Contest2"). With "ContestName" in [brackets] you get the contest name. If ContestName of a participant is equal to "Contest1" the color is "#F2F2F2". If ContestName is equal to "Contest2" the color will be "#04B404".
1
switch([ContestName]="Contest1";"#F2F2F2";[ContestName]="Contest2";"#04B404")
Copied!
Last modified 1mo ago