Ask or search…
K
Links

Generic import

Import and synchronize participant- and device data to automate your processes.
Past the URL of your hosted data to synchronize participants and devices with your Racemap event. Import data from multiple online files, also. The solution checks the format of your hosted data and replies to which parameters are imported.
Past URLs of online sources to import the participants into Racemap event
Detailed description of errors when import fails for specific entries
Test the API with your Racemap event. Use the sample files.

Format of import data

Field
Description
Sample
importId
Required user-defined ID, unique within Racemap event, a new importID creates a new participant
"import_DWBK" or "03487" or "1sl71kaut2"
name
Name
"Max" or "🔥" or "40012"
startNumber
Bib number
"40012" or "🔥" or "Max"
startTime
Time in UTC of first possible geolocation, earlier location data is ignored for visualization and leaderboard
"2022-01-24T15:00:00.000Z"
endTime
Time in UTC of last possible geolocation, later location data is ignored for visualization and leaderboard
"2022-01-24T23:00:00.000Z"
key
No import, if value of key does not belong to Racemap event
"3Z2GPX"
markerColor
Marker color in visualization, hex code
"#023d10"
tags.age or tags.sex
Attributes to filter participants eg. age group or nation, format
"35" or "male" or "Island"
times.start
Timestamp in UTC of start detection, considered in the leaderboard
"2022-01-24T15:25:10.000Z"
times.end
Timestamp in UTC of finish detection, considered in the leaderboard
"2022-01-24T22:53:45.000Z"
times.5km or times.loop
Timestamp in UTC of read from split
"2022-01-24T20:17:24.000Z"
device.id
IMEI of GPS unit or transponder ID
"4106050246" or "RRPing_ZDKAR32" or "RRPing_70761"
device.class *
Device class
"Mobile" or "Tracker" or "Upload" or "Transponder" or "null"
device.type *
Device type
"GL300" or "LK106" or "active" or "passive" or "null"
(*) device.class and device.type are not required to import the device.id
json
xml
1
[
2
{
3
"importId": "UniqueImportID_0",
4
"name": "Petra Pan Minimal",
5
"startNumber": "A1206",
6
"tags.age": "25",
7
"tags.sex": "w"
8
},
9
{
10
"importId": "UniqueImportID_1",
11
"name": "Peter Pan With Color",
12
"startNumber": "A1207",
13
"markerColor": "#4d79ff",
14
"tags.age": "35",
15
"tags.sex": "m"
16
},
17
{
18
"importId": "UniqueImportID_2",
19
"name": "Peter Pan With Tracker",
20
"startNumber": "A1208",
21
"device.id": "410252637263"
22
},
23
{
24
"importId": "UniqueImportID_3",
25
"name": "Peter Pan With Tracker and specific type/class",
26
"startNumber": "A1209",
27
"device.class": "Tracker",
28
"device.type": "Gl300",
29
"device.id": "001111112222223"
30
},
31
{
32
"importId": "UniqueImportID_4",
33
"name": "Peter Pan With Times",
34
"startNumber": "A1210",
35
"times.start": "2020-04-24T14:30:06.708Z",
36
"times.end": "2020-04-24T15:30:06.708Z"
37
},
38
{
39
"importId": "UniqueImportID_4",
40
"name": "Peter Pan With Start and End Times",
41
"startNumber": "A1210",
42
"startTime": "2020-04-25T14:30:06.708Z",
43
"endTime": "2020-04-25T15:30:06.708Z"
44
}
45
]
1
<root>
2
<starters>
3
<importId>UniqueImportID_0</importId>
4
<name>Petra Pan Minimal</name>
5
<startNumber>A1206</startNumber>
6
<tags>
7
<age>25</age>
8
<sex>w</sex>
9
</tags>
10
</starters>
11
<starters>
12
<importId>UniqueImportID_1</importId>
13
<name>Peter Pan With Color</name>
14
<startNumber>A1207</startNumber>
15
<markerColor>#4d79ff</markerColor>
16
<tags>
17
<age>35</age>
18
<sex>m</sex>
19
</tags>
20
</starters>
21
<starters>
22
<importId>UniqueImportID_2</importId>
23
<name>Peter Pan With Tracker</name>
24
<startNumber>A1208</startNumber>
25
<devices>
26
<class>Tracker</class>
27
<type>Gl300</type>
28
<id>001111112222223</id>
29
</devices>
30
</starters>
31
<starters>
32
<importId>UniqueImportID_3</importId>
33
<name>Peter Pan With Times</name>
34
<startNumber>A1209</startNumber>
35
<times>
36
<start>2020-04-24T14:30:06.708Z</start>
37
<end>2020-04-24T15:30:06.708Z</end>
38
<loop>2020-04-24T15:15:06.708Z</loop>
39
</times>
40
</starters>
41
<starters>
42
<importId>UniqueImportID_4</importId>
43
<name>Peter Pan With Start and End Times</name>
44
<startNumber>A1210</startNumber>
45
<startTime>2020-04-25T14:30:06.708Z</startTime>
46
<endTime>2020-04-25T15:30:06.708Z</endTime>
47
</starters>
48
</root>

RACE RESULT lists

Use predefined lists to import and synchronize participants and devices into Racemap within seconds.
Download list template Download minimal sample with importId, name, startNumber, markerColor, tags.age, device.id, times.start, times.finish : Download full sample with importId, name, startNumber, markerColor, tags.age, device.id, device.class, device.type, times.start, times.loop, times.finish :
Upload template file
Upload the list template in RACE RESULT, Output, Import List
The new list Racemap Sync is shown under participants.
Activate access
Enable to access the list in Main Window, Access rights, Simple API.
  • Check the "active" field
  • Select "List" in Type
  • Select the "Racemap Sync" list in details
  • Select JSON
  • Copy the link
Past the link
Past the link in Racemap, Generic Import field