» RACEMAPContactLoginUpdates
Search…
Documentation
Provide live tracking
Data APIs for live geodata
Import participant data
Import with API, automatically
Generic API
RACE|RESULT API
Import with CSV file
Hardware for live tracking
Predictive tracking with reads from timing system
Map settings
Export data from Racemap
Powered By GitBook
Generic API
Import and synchronize participants from online files.
Past the URL of one online source to import participants and devices to the Racemap event. Import data from multiple online files, also. The generic API checks the format and provides feedback on which parameters are imported.
past URLs of online sources to import the participants into Racemap event

Format of online participant file

Test the API with your Racemap event. Use the sample files.
parameter
description
type
default
required
starters
parameters of participants
array
➖
✔️
devices
if GPS tracker respectively transponder is assigned to specific participant
array
➖
➖
times
if reads or detections from timekeeping system are assigned to participants, UTC corresponding to ISO 8601 https://en.wikipedia.org/wiki/ISO_8601​
object
➖
➖
starter object
device object
times object
parameter
description
sample
type
default
required
importID
user-defined ID, unique within Racemap event, assigned to specific participant, a new importID creates a new participant
import_DWBK, 03487, 1sl71kaut2
string
➖
✔️
key
no import if value of key does not belong to Racemap event
3Z2GPX
string
➖
➖
name
name of participant
Max, 🔥, 40012
string
➖
➖
startNumber
bib number of participant
40012, 🔥, Max
string
➖
➖
markerColor
color of marker in tracking map, hex code
#023d10
string
#ffffff
➖
tags
additional attributes to filter participants eg. age group or nation, format tag: value
Age: 35, Sex: male, Country: Island
object
➖
➖
parameter
description
sample
type
default
required
class
specific device class
Mobile, Tracker, Upload, Transponder, TrackPingTransponder
string
➖
➖
type
specific device type
GL300, LK106, active, passive
string
➖
➖
id
IMEI or transponder ID of device
4106050246, RRPing_ZDKAR32, RRPing_70761
string
➖
➖
parameter
description
sample
type
default
required
start
timestamp of when did the participant start
2021-10-23T00:35:00.000Z
string
➖
➖
end
timestamp of when did the participant finish
2021-10-23T01:15:59.710Z
string
➖
➖
loop or 5km
timestamp of read from split
2021-10-23T01:05:47.000Z
string
➖
➖
json
xml
{
"starters": [
{
"importId": "UniqueImportID_0",
"name": "Petra Pan Minimal",
"startNumber": "A1206",
"tags": {
"age": "25",
"sex": "w"
}
},
{
"importId": "UniqueImportID_1",
"name": "Peter Pan With Color",
"startNumber": "A1207",
"markerColor": "#4d79ff",
"tags": {
"age": "35",
"sex": "m"
}
},
{
"importId": "UniqueImportID_2",
"name": "Peter Pan With Tracker",
"startNumber": "A1208",
"devices": [
{
"class": "Tracker",
"type": "Gl300",
"id": "001111112222223"
}
]
},
{
"importId": "UniqueImportID_3",
"name": "Peter Pan With Times",
"startNumber": "A1209",
"times": {
"start": "2020-04-24T14:30:06.708Z",
"end": "2020-04-24T15:30:06.708Z",
"loop": "2020-04-24T15:15:06.708Z"
}
},
{
"importId": "UniqueImportID_4",
"name": "Peter Pan With Start and End Times",
"startNumber": "A1210",
"startTime": "2020-04-25T14:30:06.708Z",
"endTime": "2020-04-25T15:30:06.708Z"
}
]
}
<root>
<starters>
<importId>UniqueImportID_0</importId>
<name>Petra Pan Minimal</name>
<startNumber>A1206</startNumber>
<tags>
<age>25</age>
<sex>w</sex>
</tags>
</starters>
<starters>
<importId>UniqueImportID_1</importId>
<name>Peter Pan With Color</name>
<startNumber>A1207</startNumber>
<markerColor>#4d79ff</markerColor>
<tags>
<age>35</age>
<sex>m</sex>
</tags>
</starters>
<starters>
<importId>UniqueImportID_2</importId>
<name>Peter Pan With Tracker</name>
<startNumber>A1208</startNumber>
<devices>
<class>Tracker</class>
<type>Gl300</type>
<id>001111112222223</id>
</devices>
</starters>
<starters>
<importId>UniqueImportID_3</importId>
<name>Peter Pan With Times</name>
<startNumber>A1209</startNumber>
<times>
<start>2020-04-24T14:30:06.708Z</start>
<end>2020-04-24T15:30:06.708Z</end>
<loop>2020-04-24T15:15:06.708Z</loop>
</times>
</starters>
<starters>
<importId>UniqueImportID_4</importId>
<name>Peter Pan With Start and End Times</name>
<startNumber>A1210</startNumber>
<startTime>2020-04-25T14:30:06.708Z</startTime>
<endTime>2020-04-25T15:30:06.708Z</endTime>
</starters>
</root>
Previous
Import with API, automatically
Next
RACE|RESULT API
Last modified 8mo ago
Copy link