Generic import

Import and synchronize participant- and device data from your side.

Paste the URL of your hosted data to synchronize participants and devices with the event in your RACEMAP account. Import data from multiple online files, also. The generic import 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.

• json sample file: https://static-cdn.racemap.com/importSamples/GenericImportSampleArray.json

• xml sample file: https://static-cdn.racemap.com/importSamples/GenericImportSample.xml

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, leading and trailing spaces are removed on import	"Max" or "🔥" or "40012"
startNumber	Bib number, leading and trailing spaces are removed on import	"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; startTime used instead, if import doesn't contain times.start	"2022-01-24T15:25:10.000Z"
times.end	Timestamp in UTC of finish detection, considered in the leaderboard; endTime used instead, if import doesn't contain times.end	"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	"GL320-MG" or "GL300" or "LK106" or "active" or "passive" or "null"

json

[
  {
    "importId": "UniqueImportID_0",
    "name": "Petra Pan Minimal",
    "startNumber": "A1206",
    "tags.age": "25",
    "tags.sex": "w"
  },
  {
    "importId": "UniqueImportID_1",
    "name": "Peter Pan With Color",
    "startNumber": "A1207",
    "markerColor": "#4d79ff",
    "tags.age": "35",
    "tags.sex": "m"
  },
  {
    "importId": "UniqueImportID_3",
    "name": "Peter Pan With Tracker and specific type/class",
    "startNumber": "A1209",
    "device.class": "Tracker",
    "device.type": "Gl300",
    "device.id": "001111112222223"
  },
  {
    "importId": "UniqueImportID_4",
    "name": "Peter Pan With Times",
    "startNumber": "A1210",
    "times.start": "2020-04-24T14:30:06.708Z",
    "times.end": "2020-04-24T15:30: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"
  }
]

xml

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

Participant order

By default RACEMAP orders the imported participants by startNumber, numbers before letters and participants without a startNumber last. That order is used in the participant table and as the initial order in the player.

Switch on Keep participant order from source in the event editor, Participants, Import, to let your data define the order instead. The participants then appear in the order of the records in your file. With several sources the sources are concatenated in the configured order, and participants you added manually in RACEMAP are listed after the synchronized ones.

RACEMAP re-applies the order of your source on every synchronization. Reordering participants by hand in the participant table will be overwritten with the next sync while the option is switched on.

Filter input by tag

You can filter the incoming participants by a single tag category. To achieve this, activate the filtering option using the filter symbol. Subsequently, select the category and the specific tag values to be imported.

By default, we import every participant who does not have the selected filter category. To prevent this, you must assign a tag to the participant and set the value to none, for example.

RACE RESULT lists

Use predefined lists to import and synchronize participants and devices into Racemap within seconds.

Download templates Download full sample with importId, name, startNumber, markerColor, tags.age, device.id, device.class, device.type, times.start, times.loop, times.finish : Download minimal sample with importId, name, startNumber, markerColor, tags.age, device.id, times.start, times.finish :

Upload template file

Upload the list template in RACE RESULT, Lists, Import icon

The new "List Template full" is shown under Lists, Participants.

Activate access

Enable the access to the list in Basic Settings, Access Rights.

• Check the "Active" field

• Select "List" in Type field

• Select the "List Template full" list in Details field

• Select JSON

• Copy the link

Past the link

Past the link in RACEMAP, Generic Import field