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.

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

[
  {
    "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"
  }
]

<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

PreviousImport with API, automatically NextRACE RESULT import

Last updated 7 months ago