LogoLogo
UpdatesGPS trackersLoginFree trial
  • Welcome
  • Quick start guide
  • Provide live tracking
    • Features of visualization
    • Leaderboard
    • Monitor
    • Group and stages
    • Embed interactive content
    • Keys and passcode
    • Activity upload
    • Deep links on tracking app
    • Shadowtrack and mapping
  • Data APIs for live geodata
    • */current, location data
    • */distance and locations
    • */times, reads and raw data
    • */ranks, ranking and results
    • */starters, athlete data
    • */geo, geo elements
    • Tools to extract live data
  • Import participant data
    • Import with API, automatically
      • Generic import
      • RACE RESULT import
    • Import with CSV file
  • Tracker management
    • Add GPS trackers
    • Add RACE RESULT readers
    • Add devices to event
    • Send messages
    • Compose messages
    • User access to devices
    • Manage SIM cards
  • Hardware for live tracking
    • Configure GPS tracker
      • Remote configuration
      • Physical configuration
    • Update firmware of GPS tracker
    • Configuring trackers for increased autonomy
    • Track Box forwarding
    • Insiders GPS trackers
    • Prepare smartphone
    • Using GPS trackers On-Site
    • Debug tracking devices
  • Predictive tracking with reads from race timing
    • RACE RESULT
    • Other timing system
      • ChronoTrack forwarder
      • MyLaps forwarder
  • Integrations
    • Wiclax
  • Map settings
    • External map layer
  • Export data from RACEMAP
    • Hosted elevation service
    • Hosted loads information
    • Download leaderboard CSV
    • Download recorded GPX
Powered by GitBook
LogoLogo

Legacy

  • Contact
  • Terms of use
  • Privacy Policy
  • Imprint

About Racemap

  • Pricing
  • About Us
  • Apps
  • Events

Follow us

  • facebook
  • youtube
  • linkedin
  • github

Maps: ©Mapbox ©OpenStreetMap ©RACEMAP

On this page
  • Format of import data
  • RACE RESULT lists
  1. Import participant data
  2. Import with API, automatically

Generic import

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

PreviousImport with API, automaticallyNextRACE RESULT import

Last updated 5 months ago

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.

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.

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

json sample file:

xml sample file:

Download list template with importId, name, startNumber, markerColor, tags.age, device.id, times.start, times.finish : with importId, name, startNumber, markerColor, tags.age, device.id, device.class, device.type, times.start, times.loop, times.finish :

https://static-cdn.racemap.com/importSamples/GenericImportSampleArray.json
https://static-cdn.racemap.com/importSamples/GenericImportSample.xml
Download minimal sample
Download full sample
Past URLs of online sources to import the participants into Racemap event
Detailed description of errors when import fails for specific entries