API to Import Data from RACE|RESULT

Import participant data into Racemap using Simple API

Basic Sample

Sync participant data with RACE|RESULT using event ID
Sync participant data with RACE|RESULT using Racemap access file

Interface for the import API:

  • fill in RACE|RESULT event ID or fill in the URL of the Racemap access file

  • select corresponding contests to pull specific participants into your event

  • link to r|r participant file is displayed

  • Multi-stage events with one participant file in RACE|RESULT: Prevent overwriting start and finish times in finished stages with data from the running stage, remove synchronization for finished stages e.g. delete the contest in the import API.

  • Add Track Boxes in the Tracking Map to display the location of your hardware. That way you can coordinate your staff working at the race ground.

RACE|RESULT Data for Video

Simple API
Participants Data » User Defined Fields, to forward Tracking Keys and colors

Simple API

Import of participants with transponder ID, only: To import a participant to Racemap, Simple API must provide the parameters: ID, RaceNr, Transponder1, Firstname, Contest and Visibility. If one parameter is missing the specific participant won't be pulled to Racemap.

RACE|RESULT Knowledge Base - Simple API to pull data from RACE|RESULT: https://www.raceresult.com/en/support/kb.php?id=8165-Racemap

RACE|RESULT: Main Window » Access Rights/Simple API » Select "Racemap Access"

UTC format of “Start:” and “Finish:” ISO 8601 https://en.wikipedia.org/wiki/ISO_8601

transponder fields with transponder number to enable data import into Racemap

  • 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"

The following parameters are displayed in the participant list of the Tracking Map:

  • RaceNr

  • Firstname

  • Lastname

  • (Club) - optional in brackets

  • color of markers

Custom Field for Tracking Keys and Color Settings

Use Simple API » Racemap Access » Custom field to import Tracking Keys or colors into your event.

[Color]&";"&[TrackingKey]

Integrate Tracking Keys in RACE|RESULT Online Registration

Visibility of participants in Tracking Map, in case of "not Predictive Tracking": You event is set for GPS Live Tracking. To make a participant visible in the Tracking Map, Simple API must provide: ID, RaceNr, Transponder1, Firstname, Contest, Visibility and Tracking Key. Participants without a Tracking Key are not displayed in the participant list of the map.

Assign Tracking Keys to participants: Main Window » Participants Data » User Defined Fields

User Defined Fields: insert Tracking Keys, join one key with every participant

field "TrackingKey":

switch([Bib]>0 AND [Bib]<=500;[TrackingKey_1];
[Bib]>500 AND [Bib]<=1000;[TrackingKey_2]; ... ;
[Bib]>xxxx AND [Bib]<=xxxx;[TrackingKey_n]);"")

field "TrackingKey_1":

  • up to 500 Tracking Keys fit into one user defined field

  • for more participants set up a 2nd field "TrackingKey_2"

  • insert Tracking Keys in the following format

choose([Bib];"xxxxxx";"xxxxxx";"xxxxxx")

  • Main Window » Participants Data » Additional Fields

  • add checkbox field such as "Agree to Live-Tracking"

checkbox to let participants agree to optional Live Tracking
User Defined Fields: insert Tracking Keys and link to checkbox

field "TrackingKey":

iif[AYN1]=1;switch([Bib]>0 AND [Bib]<=500;[TrackingKey_1];
[Bib]>500 AND [Bib]<=1000;[TrackingKey_2]; ... ;
[Bib]>xxxx AND [Bib]<=xxxx;[TrackingKey_n]);"")

"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

Set Color of Markers

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

different 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

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

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".

switch([ContestName]="Contest1";"#F2F2F2";[ContestName]="Contest2";"#04B404")