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
  • Querying keys via the API
  • Generating QR code images
  • Properties of keys and the passcode
  • Connect RACEMAP App for live tracking
  1. Provide live tracking

Keys and passcode

Keys link participants' data with tracking hardware. Using keys, participants seamlessly connect Racemap App for live tracking and upload their recorded activities.

PreviousEmbed interactive contentNextActivity upload

Last updated 1 month ago

Test the sign-up process with Racemap App for the event "Easy QR Code Run" (passcode 6G615L):

  • Leaderboard:

  • Tracking map:

Two options for automatically connecting Racemap App for live tracking in this event:

  • Press the key link

  • Scan the QR code (the QR code is equal to the key link)

After sign-up, you can contribute your activities to the activity challenge. Have Fun!

Through keys, you can sell live tracking in the online registration for your event. Merge the participant data (name and race number) with a specific key. Distribute the key with the registration email or as a printed QR code. Keys enable an automated and highly convenient sign-up process for live tracking.

Querying keys via the API

To automatically retrieve keys, use the following API route:

https://racemap.com/api/events/[evenId]/starter_keys?format=json

Example:

https://racemap.com/api/events/5dfce57c9240c60001f71a88/starter_keys?format=json

Note:

  • Generate the keys beforehand.

  • Additional keys can be generated at any time.

  • Keys are charged only when a participant uses a key in the app or uploads an activity.

Generating QR code images

To generate a QR code image for a specific key, use this API endpoint:

https://racemap.com/api/starters/actions/generate_key_qrcode?key=[KEY]

Replace [KEY] with the desired key. For instance, to generate a QR code for the passcode 6G615L (from the "Easy QR Code Run" sample), use:

https://racemap.com/api/starters/actions/generate_key_qrcode?key=6G615L

This API call returns the QR code image, which you can embed or display directly in your application (e.g., within an email, newsletter, or dashboard).

Properties of keys and the passcode

  • Assigned to ONE specific event,

  • Can't be used for a different event,

  • Six characters, upper or lower case is irrelevant.

  • Each with a specific landing page URL: https://racemap.app/redeem_key?key=YYYYYY.

Application
Keys
Passcode

Usage for the event

Multiple keys for one event

One passcode for one event

Usage by participants

Personalized: each participant uses a different key

Each participant uses the same passcode for one event

Merge with participant data

Match participant's name & race number with a specific key eg. in registration platform

No match with individual participant data possible

Assign location data during the event - Total activity

Accumulate multiple activities with Racemap App

Accumulate multiple activities with Racemap App

Assign location data - Sum-up activities

With Racemap App and upload recorded activities

With Racemap App, only

Read more about the synchronization of participant data with a Racemap event:

Learn more about keys to upload recorded activities from fitness trackers such as Garmin and Polar:

Connect RACEMAP App for live tracking

Participants require a key respectively the passcode to connect Racemap App (or a custom app) for live tracking in a specific event. There are three options for participants redeem their key in the app:

  • Scan QR code.

  • Press the key link

  • Manually redeem the key in the search field of Racemap App.

Link to redeem a key in RACEMAP App

Information about deep links to directly call functions in Racemap App (or a custom app):

The key link provides a seamless user flow to connect the participants' phones for live tracking. The convenient user experience scales with a huge number of participants and saves support time. The process dynamically guides participants independent from

  • The user's phone is iOS or Android.

  • Racemap App is installed or not installed.

  • The participant opens the key link on the smartphone or on the desktop.

The key link forwards to the App Store or to Google Play to install the tracking app.

The key link

  • Opens Racemap App.

  • Addresses the corresponding event. Participants don't search for their race.

  • Automatically redeems the key. Participants don't type the six characters of the key.

Redeem key or passcode, manually

Redeem a key respectively the passcode in the search field of Racemap App.

Import participant data
Activity upload
Deep links on tracking app
racemap.com/timing/qrcode-test
racemap.com/player/qrcode-test
https://racemap.app/redeem_key?key=6G615L
Participants use the passcode or keys to easily connect Racemap App for live tracking.
Key link landing page on desktop guides participants using their phones
QR code on race kit to connect RACEMAP App for live tracking at ooredo marathon
  • Add specificstartNumber and name. Participants don't need to type their name and bib number. */redeem_key?key=KEY&startNumber=STARTNUMBER&name=NAME. Test this sample on your phone .

https://racemap.app/redeem_key?key=6G615L&startNumber=1&name=Peter