Keys and passcode
Keys link participants' data with RACEMAP app. Using keys, participants seamlessly connect RACEMAP App for live tracking or upload their recorded activities.

Test with RACEMAP App for the event "Easy QR Code Run" (passcode 6G615L):
Leaderboard: racemap.com/timing/qrcode-test
Tracking map: racemap.com/player/qrcode-test
There are two options for automatically connecting RACEMAP App for live tracking in this event:
Click the link https://racemap.app/redeem_key?key=6G615L
Scan the QR code (which is equal to the key link)
After sign-up, you can contribute your activities to the activity challenge.
Through keys, you can sell live tracking in the online registration for your event. Merge the participant data with a specific key. Distribute the key with the registration email or as a printed QR code. Keys enable an automated and convenient process for live tracking with app.
APIs related to keys
You can automatically process keys through APIs, e.g., when selling live tracking in an online registration platform. You need to authenticate the requests to the APIs.
AuthenticationGenerating keys via API
API route to automatically generate keys on demand:
https://racemap.com/api/events/:eventId/actions/generate_starter_keys?count=10
Replace :eventId
with the id of your addressed event. Set the number according to your demand, eg. 11
to generate 11 keys. More keys can be generated at any time.
Querying keys via API
API route to automatically retrieve keys:
https://racemap.com/api/events/:evenId/starter_keys?format=json
Generating QR code images
Endpoint to generate a QR code image for a specific key:
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
The API request 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:
https://racemap.app/redeem_key?key=[key]
.
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 an event in RACEMAP:
Import participant dataLearn more about keys to upload recorded activities from fitness trackers such as Garmin and Polar:
Activity uploadConnect RACEMAP App for live tracking
Participants require a key respectively the passcode to connect RACEMAP App for live tracking a specific event. There are three options for participants to redeem their key in the app:
Scan QR code.
Click the key link.
Manually paste 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):
Deep linksThe 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.

Add specific
startNumber
andname
. 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 .
Redeem key or passcode, manually
Redeem a key respectively the passcode in the search field of RACEMAP App.
Last updated