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.
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" |
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" |
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>
sample file with wrong format:
Last modified 2mo ago