Generic import

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

Past 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	"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; 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	"GL300" or "LK106" or "active" or "passive" or "null"

(*) device.class and device.type are not required to import the device.id

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_2",
    "name": "Peter Pan With Tracker",
    "startNumber": "A1208",
    "device.id": "410252637263"
  },
  {
    "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>

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