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
Test the API with your Racemap event. Use the sample files.

Format of hosted data

Participant object

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:10.000Z"
endTime
Time in UTC of last possible geolocation, later location data is ignored for visualization and leaderboard
"2022-01-24T22:59:45.000Z"
key
No import, if value of key does not belong to Racemap event
"3Z2GPX"
markerColor
Marker color in visualization, hex code
"#023d10"
tags
Attributes to filter participants eg. age group or nation, format tag: value
"Age": "35", "Sex": "male", "Country": "Island"

Device object

Field
Description
Sample
class
Device class
"Mobile" or "Tracker" or "Upload" or "Transponder"
type
Device type
"GL300" or "LK106" or "active" or "passive"
id
IMEI of GPS unit or transponder ID
"4106050246" or "RRPing_ZDKAR32" or "RRPing_70761"

Times object

Field
Description
Dample
start
Time in UTC of start detection
"2021-10-23T00:35:00.000Z"
end
Time in UTC of finish detection
"2021-10-23T01:15:59.710Z"
loop or 5km
Time in UTC of read from split
"2021-10-23T01:05:47.000Z"
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>